# 使用钉钉导入
Authing 支持从钉钉通讯录导入组织机构与用户,并将钉钉组织机构的变动同步到 Authing 的组织机构。
# 配置钉钉通讯录
# 创建钉钉应用
- 你需要先 钉钉开放平台 (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 组织机构中也被删除了:
# 修改部门
这里把研发部门改名为产研:
可以看到也成功更新了:
# 同步人员的变动
# 添加成员
在运营部门下面添加一名新成员:
# 删除成员
将刚刚添加的成员删除:
# 修改成员信息
修改小红的姓名为小红红:
# 查看同步历史记录
你可以点击导入组织机构 - 查看导入历史在同步历史记录页面查看进度:
如果同步失败,你可以在此看到详细的错误日志: