# 使用钉钉导入

Authing 支持从钉钉通讯录导入组织机构与用户,并将钉钉组织机构的变动同步到 Authing 的组织机构。

# 配置钉钉通讯录

# 创建钉钉应用

  1. 你需要先 钉钉开放平台 (opens new window) 注册一个 具备通讯录权限 的企业内部应用,如下图所示:

选择开发模式为企业自助开发:

在权限管理页面,添加通讯录相关的所有权限:

# 配置服务器出口 IP

在此填入你的服务器出口 IP 地址:

由于钉钉平台限制,同一个IP只能被一个企业使用,所以你需要在服务器出口 IP 对应的服务器上部署一个具备 https 转发能力的代理,Authing 会通过这个代理与钉钉服务器进行通信 。你可以使用 goproxy (opens new window) 等开源代理方案,或者购买匿名代理 IP。如果你不知道怎么部署,请见:

部署中转代理服务器

# 在 Authing 控制台配置

连接身份源 - 企业身份源页面找到钉钉通讯录

在此你需要填入以下信息:

  • 企业 ID(CorpId)
  • 钉钉应用的 AppKey
  • 钉钉应用的 AppSecret
  • 服务器出口代理

请确保应用 ID 和密钥无误,以及代理可用,否则可能会遇到下面这种提示:

# 首次全量同步

成功配置之后,你就可以将钉钉企业通讯录里面的组织结构和用户导入到 Authing 组织机构了。下面我们会以北京非凡科技有限公司(虚拟,下文简称非凡公司)为例:

这是非凡公司最开始的组织架构,一共有三个部门,4 名员工:

在 Authing 控制台用户管理 - 组织架构页面点击右上角的 导入组织机构 - 从钉钉导入:

一小段时间之后,钉钉的组织机构将会被导入 Authing 组织机构:

你可以在同步历史记录页面查看进度:

# 从钉钉增量同步到 Authing 组织机构

# 同步组织结构的变动

# 添加部门

在这里添加了一个法务部门:

可以看到其被马上同步到了 Authing 的组织机构:

在商业化部门下面添加一个大中华区部门:

一段时间之后他也被同步到了 Authing 组织机构:

# 删除部门

将法务部门删除:

其在 Authing 组织机构中也被删除了:

# 修改部门

这里把研发部门改名为产研

可以看到也成功更新了:

# 同步人员的变动

# 添加成员

在运营部门下面添加一名新成员:

# 删除成员

将刚刚添加的成员删除:

# 修改成员信息

修改小红的姓名为小红红:

# 查看同步历史记录

你可以点击导入组织机构 - 查看导入历史同步历史记录页面查看进度:

如果同步失败,你可以在此看到详细的错误日志: