钉钉集成模式(私有云版)

1. 简介

私有云版的用户如果创建钉钉集成模式版的账号,需要先创建企业,然后进行钉钉绑定。

2. 创建企业

创建企业时,需要填写以下信息:

  • 管理员用户名:创建后不可修改,管理员通过此用户名登录企业;
  • 企业名称:后期可修改;
  • 登录密码:不可更改,管理员通过此用户名登录企业,因此创建时,需要记住该密码;密码至少包含数字、大写字母、小写字母及特殊字符中的三种
  • 成员分配数量:默认 10 人,可直接输入人数,后期可修改。(成员分配数量不可超过剩余可分配人数)

3. 钉钉自建应用

登录 钉钉开放平台,在钉钉开放平台中新建一个自建应用,这一步是为了获取后文需要配置的自建应用ID、自建应用secret 等参数。

3.1 获取CorpId

登录后先获取需要绑定的企业的 CorpId 进行备份,如下图所示:

3.2 新建企业应用

接下来,在首页处新建一个企业应用,如下图所示:

在弹出的页面中选择「H5微应用」,然后填写自建应用基本资料,如下图所示:

3.3 获取AgentId、AppKey和AppSecret

然后将应用信息中 AgentId、AppKey 和 AppSecret 复制备份,用于后文【4.1步骤】的参数填写:

通过以上步骤可以获取 CorpId、AgentId、AppSecret、AppKey。

4. 钉钉绑定

4.1 修改企业信息

创建企业后,找到刚刚创建的企业,点击企业详情。在企业详情中,切换到「钉钉集成」,配置「企业ID」、「自建应用ID」、「自建应用secret」、「钉钉CP app_key」,其他参数暂时获取不到,先不填写。填写完毕后点击提交:

钉钉企业ID

对应【3.1节】中的钉钉 CorpId

自建应用AgentId

对应【3.3节】中的自建应用 AgentId

自建应用appKey

对应【3.3节】中的自建应用 AppKey

自建应用secret

对应【3.3节】中的自建应用 AppSecret

提交修改信息后,可以看到该企业已切换为钉钉集成模式。

4.2 授权回调

4.2.1 获取token和aes_key

进入【3.节】创建的钉钉企业自建应用中,在「事件与回调」模块中,点击重置按钮生成加密 aes_key 和 签名 token,如下图所示:

注:重置后请勿关闭此页面,后续还需返回此页面操作。

4.2.2 回填token和aes_key

新开一个浏览器标签,登录私有云控制台,将生成的 token 和 aes_key 复制后分别回填至企业信息处的「消息编码token」和「消息编码aes_key」处,回填后点击「提交」。如下图所示:

4.2.3 回调地址配置

再回到刚刚自建应用处配置回调地址。回调地址的组成为:

https://private.yourdoamin.com/dingtalk/corp/{CorpId}/service

上述 URL 中 dingtalk 前面的内容直接替换为「私有云控制台 >> 基础信息」处的访问地址:

URL 中 的 {CorpId} 直接替换为上文【3.节】绑定了自建应用的钉钉账号的 CorpId。

替换为属于自己企业的回调地址后,将该地址配置到刚刚重置 token 和 aes_key 页面中的回调地址处,如下图所示:

配置好以后点击保存。

4.3 接入登录

这一步是为了将私有云的账号登录地址接入到需要绑定的钉钉账号中。将企业信息中的访问地址配置到如下如所示的回调域名处:

4.4 配置开发管理

在开发管理处分别配置以下地址:

地址类型

URL路径

应用首页地址

https://private.yourdoamin.com/dingtalk/corp/{corpId}/dashboard

PC端首页地址

https://private.yourdoamin.com/dingtalk/corp/{corpId}/pc_auth

管理后台地址

https://private.yourdoamin.com/dingtalk/corp/{corpId}/admin/auth

注:URL替换方式同【4.2.3节】中回调地址的配置,此处不在赘述。

配置好的地址效果如下图所示:

4.5 权限设置

在权限管理处设置需要的权限,如通讯录权限,设置后可以同步钉钉企业中的部门成员信息至绑定的简道云企业。如下图所示:

5. 通讯录同步

5.1 登录企业

私有云企业控制台处输入管理员用户名和密码登录进绑定的企业,如下图所示:

5.2 同步成员

登录后,在通讯录中可以同步钉钉账户中的部门成员。

1)进入通讯录

2)同步成员

在内部组织中点击「立即同步」即可将钉钉组织架构中的部门成员同步至私有云企业中。如下图所示:

本文是否对您有帮助?
 有帮助
 没帮助
您是否遇到了以下问题?
如需获取即时帮助,请联系技术支持