钉钉作为身份源

本章节将为您介绍如何在 IDaaS 平台中配置钉钉作为身份源，将钉钉平台统一维护的组织机构和用户数据，同步至 IDaaS 平台，保障企业内各应用系统的数据一致性。

前提条件

• 拥有钉钉开放平台的管理员权限。
• 拥有 IDaaS 企业中心平台的管理员权限。

配置流程

操作步骤

钉钉开放平台创建应用

1. 登录钉钉开放平台，在钉钉开放平台首页获取 CorpId 参数值。

   

2. 在钉钉开放平台上方导航栏选择 “应用开发 > 企业内部开发” ，在企业内部开发下创建 H5 微应用或者小程序，下文以小程序为例，选择 “钉钉应用 > 小程序” ，然后单击 “创建应用” ，填写创建应用表单信息。

   

   

3. 创建完成后进入小程序，单击左侧 “开发管理” ，修改服务器出口 IP 为 IDaaS 服务出口 IP ： 47.92.171.137 。

   

4. 单击左侧 “基础信息” ，获取应用 Appkey 、 AppSecret 参数值。

   

5. 单击左侧 “安全中心” ，选择 “HTTP 安全域名” ，单击 “添加” ，配置安全域名（即 IDaaS 租户域名）。

6. 单击左侧 “权限管理” ，切换至 “接口权限” tab 页签，添加如下图所示接口权限。

   

   

   

   

IDaaS 配置钉钉身份源

1. 登录 IDaaS 企业中心平台，在上方导航栏选择 “用户 > 身份源管理“ ，单击 ”添加身份源“ 选择 “钉钉” 身份源。

2. 自定义设置身份源名称，参考界面提示填写企业 ID 、 AppKey 、 AppSecret 等参数，设置完成后单击 ”确定“ 保存。

3. 进入新增身份源的详情页，可查看、更新钉钉身份源的 ”基础配置“ ，包括连接参数、同步机制及实时回调。

   

4. 切换至 ”高级配置“页签，建议保持默认或者根据实际需求参考填写 。

   

   参数	说明
   选择根组织	将身份源中的数据导入到该组织，默认即可
   组织匹配策略	将钉钉身份源中组织导入到 IDaaS 的映射关系，默认即可
   创建组织	创建和更新组织默认勾选“是”即可
   删除组织	默认保留组织即可（即钉钉中删除组织， IDaaS 中保留组织），还支持禁用、删除组织
   用户匹配策略	将钉钉身份源中用户导入到 IDaaS 的映射关系，默认即可
   创建用户	创建和更新用户默认勾选“是”即可
   删除用户	默认禁用用户即可（即钉钉中删除用户， IDaaS 中禁用用户），还支持保留、删除用户
   安全阈值调节	设置当上游身份源出现删除用户/删除组织/组织层级变动等情况时，在身份源中以上变动的最大阈值比例 阈值 =（平台已回收数据和本次回收数据的差异值 / 已回收数据） * 100%，当上游身份源应用禁用/删除超过设定的阈值数据，平台接到指定后，将不进行禁用/删除操作。

5. 配置完成后切换至 ”对象模型“ 页签选择 “映射定义” ，根据项目实际需求为钉钉中组织、用户的属性和 IDaaS 中组织与用户的属性配置映射关系。

   对象模型支持把钉钉身份源中的用户、组织上的属性，与 IDaaS 中的用户、组织的属性进行映射匹配。设置之后，实现从钉钉回收用户、组织属性至 IDaaS 的用户、组织属性。

   

   • 执行方式：设置属性在哪种情形下需要映射。
     • 不映射：不会同步该属性至 IDaaS 。
     • 创建：只有在创建的时候会同步该属性。
     • 更新：只有在更新的时候会同步该属性。
     • 创建和更新：创建和更新时同步该属性。
   • 转换方式：设置属性映射的方式。
     • 自动转换：身份源中什么值，就同步什么值。
     • 脚本转换：身份源中的值不满足需要的格式可通过此方式来转换，可参考脚本映射方法。

6. 配置完成后，单击 ”执行同步“ 立即执行同步操作。

   TIP

   如果基础配置中的同步机制设置为定时同步，则此处无需通过手动执行同步任务。

   

7. 执行完成后切换至 ”同步事件" 页面，可查看该身份源的所有同步任务，单击 “操作” 列下的 “详情” 查看导入结果，或者在 “用户 > 用户与组织” 页面查看导入的数据。

   

8. （可选）导入同步执行完成后切换至 “回调事件” 页签，在 “基础配置” 中开启了回调注册后，可在本页面查看钉钉通讯录数据变动实时更新推送 IDaaS 的记录。