钉钉集成模式（独享版）

1. 概述

1.1 应用场景

企业同时使用钉钉和简道云，并在钉钉中设置了通讯录体系。

管理员希望将钉钉端的通讯录同步到简道云中，并实现在钉钉端免登录访问简道云。

1.2 使用前提

2. 简道云端准备工作

2.1 准备租户企业

如需配置钉钉集成模式的企业，首先需要准备一个租户企业。如已创建好了企业，可跳过本节。

1）管理员登录独享版控制台，点击「企业管理」，点击「创建企业」。

2）填写企业相关信息，点击「提交」即可创建一个新企业。

2.2 准备简道云访问地址

管理员登录独享版控制台，点击「基础信息」，在「平台信息」处即可获取简道云访问地址。

请复制并保存，下文多处需要使用。

3. 钉钉端准备工作

3.1 获取钉钉 CorpId

钉钉企业管理员登录 钉钉开放平台，即可在「首页」获取钉钉 CorpId。

请复制并保存，下文多处需要使用。

3.2 新建钉钉应用

管理员需要在钉钉准备一个应用，用于与简道云对接。

1）钉钉企业管理员登录 钉钉开放平台，点击「应用开发>钉钉应用」。

2）点击「创建应用」，输入应用基本信息，点击「保存」，即可新建一个应用。

3.3 添加应用能力

在应用设置界面，点击「添加应用能力」，添加「网页应用」。

3.4 设置应用权限

开通应用权限，才能确保同步钉钉企业中的部门成员信息至绑定的简道云企业。

1）在应用设置界面，点击「权限管理」，为该应用开通全部权限。

2）权限开通后，选择通讯录接口权限范围为「全部员工」，以确保获取企业完整通讯录。

3.5 获取钉钉应用信息

钉钉企业管理员登录 钉钉开放平台，在「应用开发>钉钉应用」处找到上文新建的钉钉应用。

在应用设置界面，点击「凭证与基础信息」，即可获取自建的钉钉应用的AgentId、appKey和secret。

请复制并保存，下文对接简道云需要使用。

4. 简道云对接钉钉

4.1 设置钉钉集成模式

1）管理员登录独享版控制台，点击「企业管理」，在企业列表中找到上文新建的企业。

2）点击「修改企业信息」，修改企业账号模式为「钉钉集成」。

3）输入 3.1 节获取的钉钉 CorpId，输入 3.5 节获取的自建应用AgentId、自建应用appKey、自建应用secret。

4）点击「提交」，该企业即可切换为钉钉集成模式。

5）返回企业列表，可以看到该企业已切换为「钉钉集成」模式，说明切换成功。

4.2 生成消息编码信息

1）钉钉企业管理员登录 钉钉开放平台，在「应用开发>钉钉应用」处找到上文新建的应用。

2）点击「事件订阅」，设置推送方式为「HTTP推送」。

3）点击「重置」按钮，生成消息编码aes_key和消息编码token。请复制并保存，下文对接简道云需要使用。

4.3 回填消息编码信息

1）打开一个新浏览器标签页，管理员登录独享版控制台，点击「企业管理」，在企业列表中找到上文新建的企业。

2）点击「修改企业信息」，输入 4.2 节获取的消息编码aes_key和消息编码token。

3）点击「提交」生效。

4.4 完成事件订阅配置

1）回到 4.2 节钉钉管理后台的「事件订阅」配置页面。

2）输入请求网址。网址组成：2.2节简道云访问地址/dingtalk/corp/3.1节钉钉CorpId/service

3）点击「保存」。

4）在当前页面下拉，开启以下「通讯录事件」的订阅。

4.5 接入登录

这一步是为了将独享版的账号登录地址接入到需要绑定的钉钉账号中。

1）切换到「分享设置」页面。

2）在接入登录的「回调域名」中输入2.2节准备的简道云访问地址，点击「添加」生效。

4.6 配置网页应用

1）切换到「网页应用」界面，点击「编辑」按钮。

2）配置以下地址，点击「保存」生效。

4.7 版本发布

1）切换到「版本管理与发布」页面。

2）点击「创建新版本」，输入版本号与版本描述，点击「保存」即可。

5. 企业设置

5.1 同步通讯录

1）企业创建者在浏览器中访问并登录简道云。

2）点击右上角头像，点击「管理后台>内部组织」。

3）点击「立即同步」，即可将钉钉组织架构中的部门成员同步至该企业中。

5.2 设置成员钉钉登录

1）管理员在简道云管理后台切换到「企业信息」界面，设置企业账号URL。

2）成员在浏览器访问该企业账号URL时，即可通过钉钉扫码登录。

3）成员也可以在钉钉工作台访问上文创建的应用，免登录访问简道云。

6. 集成模式解绑

独享版钉钉集成模式解绑时，需按照如下所示步骤进行：

6.1 停用钉钉应用

1）钉钉企业管理员登录 钉钉开放平台，在「应用开发>钉钉应用」处找到上文新建的钉钉应用。

2）在「凭证与基础信息」界面，停用该应用。

6.2 解绑钉钉集成模式

1）简道云企业创建者登录简道云，点击右上角头像，点击「管理后台>企业信息」。

2）在账号模式处点击「解绑」，即可将企业从「钉钉集成模式」恢复到「公共模式」。