跳到主要内容
在线体验
微信咨询
获取方案

钉钉身份源

TOPIAM 支持企业以多种身份源渠道导入用户和组织机构信息至 TOPIAM 平台,本文将为您介绍如何在 TOPIAM 平台中配置钉钉身份源,实现组织机构和用户数据的实时同步。

创建钉钉应用

在钉钉开放平台中创建小程序并配置参数,确保钉钉中的数据可同步至 TOPIAM。

  1. 登录钉钉开放平台
  2. 在钉钉开放平台,选择“应用开发 > 企业内部应用 > 小程序”,创建应用,填写应用信息。具体可参考钉钉开放平台的帮助文档。
  3. 配置应用参数。具体可参考钉钉开放平台的帮助文档。
    • 单击菜单“基础信息 > 开发管理”,配置服务器出口 IP。
    • 单击菜单“安全与监控 > 安全中心”,单击“添加”添加 HTTP 安全域名。
    • 单击页面上方“基础信息 > 权限管理”,选择权限范围后,单击“添加接口权限”添加权限。 搜索qyapi_get_department_list(通讯录部门信息读权限)qyapi_get_department_member(通讯录部门成员读权限),并添加

基本配置

参数说明
企业 ID钉钉开放平台首页右上角获取企业 ID(CorpId)
应用开发 Key钉钉开放平台应用详情的「基础信息」页面获取 AppKey
应用凭证密钥钉钉开放平台应用详情的「基础信息」页面获取 AppSecret
加密 AesKey钉钉开放平台应用详情的「事件与回调」页面获取加密 aes_key。如果你需要开启实时同步,此参数必填
签名 Token钉钉开放平台应用详情的「事件与回调」页面获取签名 token。如果你需要开启实时同步,此参数必填
回调地址钉钉开放平台应用详情的「事件与回调」页面中配置的请求网址,实时同步使用

高级配置

配置组织和用户的的同步策略

参数说明
目标根组织身份源组织同步至 TOPIAM 后的父级组织。 如果不填,将自动创建顶层组织。 配置后不可更改
默认密码同步账户时给账户设置的默认密码,若不设置,将使用设置中密码策略随机生成。
是否启用默认启用,首次同步用户时,用户是否在 TOPIAM 中启用。 注意:身份源用户未启用时,将已身份源为准。
邮件通知默认启用,首次同步用户成功后,将发送电子邮件,若没有获取到邮件地址,将无法进行发送。

任务配置

配置同步任务执行时间和周期

定时配置必须同时配置星期数及执行方式。例:勾选周二并选择每隔 2 小时执行一次时,表示在每个周二,每隔 2 小时执行一次同步。