钉钉作为身份源
# 概述
本章节将为您介绍如何在IDaaS平台中配置钉钉作为身份源,将钉钉平台统一维护的组织机构和用户数据,同步至IDaaS平台,保障企业内各应用系统的数据一致性。
# 前提条件
- 拥有钉钉开放平台的管理员权限。
- 拥有IDaaS企业中心平台的管理员权限。
# 配置流程
# 操作步骤
# 钉钉开放平台创建应用
登录钉钉开放平台 (opens new window),在钉钉开放平台首页获取CorpId参数值。
在钉钉开放平台上方导航栏选择 “应用开发 > 企业内部开发” ,在企业内部开发下创建H5微应用或者小程序,下文以小程序为例,选择 “钉钉应用 > 小程序” ,然后单击 “创建应用” ,填写创建应用表单信息。
创建完成后进入小程序,单击左侧 “开发管理” ,修改服务器出口IP为IDaaS服务出口IP:47.92.171.137。
单击左侧 “基础信息” ,获取应用Appkey、AppSecret参数值。
单击左侧 “安全中心” ,选择 “HTTP安全域名” ,单击 “添加” ,配置安全域名(即IDaaS租户域名)。
单击左侧 “权限管理” ,切换至 “接口权限” tab页签,添加如下图所示接口权限。
# IDaaS配置钉钉身份源
登录IDaaS企业中心平台,在上方导航栏选择 “用户 > 身份源管理" ,单击 ”添加身份源“ 选择 “钉钉” 身份源。
自定义设置身份源名称,参考界面提示填写企业ID、AppKey、AppSecret等参数,设置完成后单击 ”确定“ 保存。
进入新增身份源的详情页,可查看、更新钉钉身份源的 ”基础配置“ ,包括连接参数、同步机制及实时回调。
切换至 "高级配置"页签,建议保持默认或者根据实际需求参考填写 。
参数 说明 选择根组织 将身份源中的数据导入到该组织,默认即可 组织匹配策略 将钉钉身份源中组织导入到IDaaS的映射关系,默认即可 创建组织 创建和更新组织默认勾选“是”即可 删除组织 默认保留组织即可(即钉钉中删除组织,IDaaS中保留组织),还支持禁用、删除组织 用户匹配策略 将钉钉身份源中用户导入到IDaaS的映射关系,默认即可 创建用户 创建和更新用户默认勾选“是”即可 删除用户 默认禁用用户即可(即钉钉中删除用户,IDaaS中禁用用户),还支持保留、删除用户 安全阈值调节 设置当上游身份源出现删除用户/删除组织/组织层级变动等情况时,在身份源中以上变动的最大阈值比例
阈值 =(平台已回收数据和本次回收数据的差异值 / 已回收数据) * 100%,当上游身份源应用禁用/删除超过设定的阈值数据,平台接到指定后,将不进行禁用/删除操作。配置完成后切换至 ”对象模型“ 页签选择 “映射定义” ,根据项目实际需求为钉钉中组织、用户的属性和IDaaS中组织与用户的属性配置映射关系。
对象模型支持把钉钉身份源中的用户、组织上的属性,与IDaaS中的用户、组织的属性进行映射匹配。设置之后,实现从钉钉回收用户、组织属性至IDaaS的用户、组织属性。
- 执行方式:设置属性在哪种情形下需要映射。
- 不映射:不会同步该属性至IDaaS。
- 创建:只有在创建的时候会同步该属性。
- 更新:只有在更新的时候会同步该属性。
- 创建和更新:创建和更新时同步该属性。
- 转换方式:设置属性映射的方式。
- 自动转换:身份源中什么值,就同步什么值。
- 脚本转换:身份源中的值不满足需要的格式可通过此方式来转换,可参考脚本映射方法。
- 执行方式:设置属性在哪种情形下需要映射。
配置完成后单击 ”执行同步“ 立即执行同步操作。
如果基础配置中的同步机制设置为定时同步,则此处无需通过手动执行同步任务。
执行完成后切换至 "同步事件" 页面,可查看该身份源的所有同步任务,单击 “操作” 列下的 “详情” 查看导入结果,或者在 “用户 > 用户与组织” 页面查看导入的数据。
(可选)导入同步执行完成后切换至 “回调事件” 页签,在 “基础配置” 中开启了回调注册后,可在本页面查看钉钉通讯录数据变动实时更新推送IDaaS的记录。