功能介绍

钉钉是阿里巴巴集团打造的企业级协同办公平台，集成组织架构管理、员工管理、角色权限管理等核心功能。

在AOne平台配置钉钉同步任务，可实现将钉钉中的核心数据无缝同步至AOne平台的用户与组织模块，其中钉钉与AOne的数据对应关系如下表所示：

前置准备

1、创建钉钉应用

请提前开通钉钉开放平台企业管理员权限，登录钉钉开发者平台：https://open-dev.dingtalk.com/按以下步骤创建及配置钉钉应用。

步骤1：创建应用

访问钉钉开发者平台，在应用开发-钉钉应用界面中创建应用。建议：

• 应用名称：AOne同步身份源
• 应用描述：用于AOne同步钉钉的用户与组织数据

步骤2：配置应用权限

进入步骤1创建的应用，点击开发配置-权限管理菜单，在通讯录管理分类下申请以下权限：

序号	权限	说明
1	通讯录部门信息读权限（权限点code=qyapi_get_department_list）
2	通讯录部门成员读权限（权限点code=qyapi_get_department_member)

步骤3：应用发布

进入版本管理与发布界面，创建新版本，填写版本详情资料，应用可见范围可以配置为【仅我可见】，配置后点击保存后确认发布。

特别注意：后续应用有权限和配置的改动，需新增版本并发布。

2、钉钉应用相关配置参数准备

在创建钉钉同步任务前，需获取以下参数：

序号	参数	参数获取说明
1	钉钉应用的APP ID，Client ID和Client Secret	进入上面创建的应用，点击凭证与基础信息菜单，获取钉钉应用的APP ID，Client ID和Client Secret
2	同步钉钉根部门ID	在钉钉管理后台-组织管理-通讯录-部门管理-编辑部门信息中获取部门ID。若您需要同步钉钉中企业所有的成员和部门，则同步钉钉根部门ID =1

创建同步任务

步骤1、进入同步任务配置页面

• 登录边缘安全加速，支持在AOne零信任工作台进行操作
• 在左侧导航栏身份-第三方组织，选择同步身份源菜单
• 点击添加同步任务，选择钉钉类型

步骤2、配置钉钉同步任务连接参数

输入钉钉连接参数相关配置，可点击连接测试初步检测配置数据是否正确。

说明： 钉钉同步至AOne平台的用户映射规则和机构映射规则是固定的，暂不支持自定义。

1）用户映射规则：

对应钉钉接口：获取部门用户详情

2）机构映射规则：获取部门列表

步骤3、设置钉钉同步任务基础配置

步骤4、配置钉钉同步任务同步策略

可选择手动或定时同步：

• 手动：仅在创建同步任务后点击执行任务按钮才更新数据
• 定时同步：目前支持按周和按天的同步策略，最短的时间间隔为1小时

注意 ： 建议先将同步方式设置成手动 ，待确定同步数据无误后再将同步方式按需改成定时。

完成以上配置后，您可以对同步效果进行验证，具体参考：同步任务统一验证及维护操作 。