钉钉集成

钉钉集成支持同步钉钉通讯录到企业的用户管理，同时支持钉钉的单点登录、消息通知。本文介绍通过钉钉登录修改 Qoder CN 的相关功能。

​

前提条件

服务器出口 IP：需提供企业实例的对外IP地址（专属版用户请联系技术支持获取）。

​

钉钉集成配置

​

步骤一 创建钉钉集成

企业管理员可以在企业管理第三方集成创建钉钉集成。如果需要创建不在钉钉同步范围的用户，可以勾选支持内建用户，以创建同步范围外的用户。 在钉钉集成条目右侧，单击添加配置。

​

步骤二 创建钉钉应用

1. 需要在钉钉开放平台上创建企业内部应用，可参考查看如何创建内部应用。也可按照下方提示填写创建企业内部应用表单信息，然后单击确定创建，需注意：

• 应用类型：选择小程序。
• 开发方式：选择企业自主开发。
• 应用图标：选择您需要得应用图标。

2. 其次，在左侧导航栏选择开发管理，填写服务器出口 IP。
3. 在左侧导航栏选择应用信息，记录关键凭证：

• Corpid（企业ID）
• AppKey/AppSecret
• AgentId

4. 将上一步的信息填写到以下表单中，填写完成后单击下一步。表单包含以下必填字段：AgentId、AppKey、AppSecret、CorpId，分别对应上一步中记录的凭证信息。

​

步骤三 配置应用权限

1. Qoder CN 需要获取钉钉的相应权限，才能够同步钉钉通讯录、通过钉钉登录或推送钉钉消息通知，所需权限如下所示。 进入钉钉开放平台，在步骤一中已创建的组织内部应用详情页面权限管理中配置权限，如果需要限制钉钉通讯录同步的用户范围，请配置权限范围。所需权限包括：个人手机号信息、个人头像信息、通讯录管理（通讯录部门、通讯录企业相关权限）和机器人（组织内机器人发送消息）。在钉钉开放平台的权限管理页面中，选择对应的权限分类并开通所需权限。
2. 在钉钉开放平台配置完成后，回到 Qoder CN 钉钉集成配置页面，单击下一步。

​

步骤四 账号绑定和属性映射

1. 账号绑定方式：自动绑定邮箱相同的用户，Qoder CN 将按照同步策略，自动将 Qoder CN 上、钉钉组织中邮箱账号相同的用户绑定在一起。
2. Qoder CN 将按照以下字段映射关系，自动将钉钉的用户信息与 Qoder CN 中的用户信息，按照同步策略进行映射同步，目前暂不支持修改字段映射关系，确认后单击下一步。字段映射关系为：用户名对应name、邮箱对应email、手机对应mobile、部门对应Dept_name、工号对应job_number、昵称对应nick。

​

步骤五 开启功能服务

目前提供四种功能服务：在配置过程中默认关闭。如果在未开启功能的情况下保存钉钉集成配置，后续可以在钉钉集成详情页面中开启相应的功能服务。

• 用户和组织同步：启用后，Qoder CN 用户管理与钉钉通讯录保持同步，请确认钉钉应用的可见权限范围。
• 单点登录：启用后，可在 Qoder CN 登录页面快速跳转至钉钉登录，通过钉钉访问 Qoder CN。
• 消息通知：启用后，支持钉钉消息通知，Qoder CN 内的消息订阅功能可通知用户。
• 钉钉工作台访问Qoder CN：启用后，可在钉钉工作台直接打开 Qoder CN 网页。

当完成所有配置后，单击保存配置按钮即可完成钉钉集成的配置，该服务配置后续可进行修改。

​

功能使用说明

​

用户组织同步策略

​

开启钉钉的用户和组织同步

当 Qoder CN 上未开启其他第三方的用户和组织同步功能时，可以配置钉钉的用户和组织同步，支持配置同步时机、用户差异处理、组织差异处理的规则。

场景选项	影响结果
数据同步时机	手动同步（默认）：企业管理员在数据变更后，需要在钉钉集成详情页面手动点击执行手动同步按钮以完成用户和组织同步。 定时同步：可设定为每天、每周、每月的特定时间，或每隔一定时间进行同步。若选择定时同步，建议保存配置后先手动同步一次，确保数据及时更新至 Qoder CN。 手动同步建议每次操作间隔 1 个小时以上。
用户差异处理：默认忽略 Qoder CN 中多余的账号，并为同步范围内的钉钉账号创建并绑定 Qoder CN 账号。	已有 Qoder CN 账号未匹配到钉钉账号： 忽略：当 Qoder CN 账号未匹配到钉钉账号时，保留 Qoder CN 上的多余账号。 删除账号：当 Qoder CN 账号未匹配到钉钉账号时，删除这些 Qoder CN 账号。
	已有钉钉账号未匹配到 Qoder CN 账号： 忽略：当钉钉账号未匹配到 Qoder CN 账号时，不在 Qoder CN 上创建新账号。 新建Qoder CN账号并绑定：当钉钉账号未匹配到 Qoder CN 账号时，将根据账号绑定和属性映射规则在 Qoder CN 上创建新账号，并与钉钉账号绑定。
组织差异处理：默认忽略 Qoder CN 中多余的部门节点，并为同步范围内的钉钉部门节点创建并绑定 Qoder CN 部门。	已有 Qoder CN 部门未匹配到钉钉部门： 忽略：当 Qoder CN 部门未匹配到钉钉部门时，保留 Qoder CN 上的部门节点。 删除部门：当已有 Qoder CN 部门未匹配到钉钉部门时，删除 Qoder CN 上的部门节点。
	已有钉钉部门未匹配到 Qoder CN 部门： 忽略：当已有钉钉部门未匹配到 Qoder CN 部门时，不在 Qoder CN 上创建部门节点。 创建部门并绑定：当钉钉部门未匹配到 Qoder CN 部门时，会在 Qoder CN 上创建对应的部门节点，并将两方的部门节点进行绑定。

​

查看用户和组织同步结果

在开启用户和组织同步的情况下，打开钉钉集成详情页面，可以查看最新同步结果：未执行同步、同步成功、同步失败、部分同步成功。

​

单点登录配置

​

开启单点登录

打开单点登录的开关后，需要将 Qoder CN 的回调地址配置在第一步创建的钉钉应用的应用详情安全设置重定向 URL的输入框，即可完成钉钉单点登录的配置。 开启后，页面系统配置信息区域会显示回调请求地址，将该地址复制后粘贴到钉钉应用的对应输入框中。

​

通过钉钉登录 Qoder CN

开启单点登录后，Qoder CN 登录页面将显示钉钉登录入口，点击后可进入钉钉登录页面，已绑定钉钉账号的用户可以通过钉钉登录 Qoder CN。

​

开启消息通知

在开启用户和组织同步或单点登录的情况下，可开启钉钉的消息通知功能，同时需要完善钉钉应用中的机器人配置信息。 在钉钉应用的消息推送页面，开启机器人功能并单击配置。在弹出的对话框中填写机器人名称、图标和消息接收地址，然后单击保存。

​

钉钉工作台访问配置

如果需要通过钉钉 PC 客户端的工作台访问 Qoder CN，可打开钉钉工作台访问 Qoder CN 的开关，同时将 Qoder CN 网页地址粘贴到第一步创建的钉钉应用的应用详情开发管理PC 端首页地址的输入框中。 开启后，页面会显示对应的网页地址，将该地址复制后粘贴到钉钉应用的对应输入框中。

​

功能的修改与移除

​

功能修改/关闭

在钉钉集成详情页中，如果开启了某个功能服务，可以看到修改服务配置的按钮，点击后即可进行相关功能服务配置的修改或者关闭该功能。

• 修改服务：可按需调整。在钉钉集成详情页面中，已开启的功能服务右侧会显示修改服务配置按钮，单击即可进入修改。
• 关闭服务：功能使用会有影响，具体请参见下表。

​

移除钉钉集成

在钉钉集成详情页中，可单击移除集成按钮，二次确认后即可移除钉钉集成，移除集成后：

• 解除 Qoder CN 账号和钉钉账号的绑定关系，不会影响已同步的用户和组织架构信息。
• 不支持接收钉钉消息通知。
• 不支持通过钉钉登录 Qoder CN，用户若需要登录 Qoder CN，可使用 Qoder CN 的登录账号和密码进行登录。