钉钉集成支持同步钉钉通讯录到企业的用户管理，同时支持钉钉的单点登录、消息通知。本文介绍通过钉钉登录修改Qoder CN的相关功能。
|
适用版本 |
专属版 |
前提条件
服务器出口 IP：需提供企业实例的对外IP地址（专属版用户请联系技术支持获取）。
流程概览
钉钉集成配置
步骤一 创建钉钉集成
企业管理员可以在创建钉钉集成。如果需要创建不在钉钉同步范围的用户，可以勾选支持内建用户，以创建同步范围外的用户。
在钉钉集成条目右侧，单击添加配置。
步骤二 创建钉钉应用
-
需要在钉钉开放平台上创建企业内部应用，可参考查看如何创建内部应用。也可按照下方提示填写创建企业内部应用表单信息，然后单击确定创建，需注意：
-
应用类型：选择小程序。
-
开发方式：选择企业自主开发。
-
应用图标：选择您需要得应用图标。
-
-
其次，在左侧导航栏选择开发管理，填写服务器出口 IP。
-
在左侧导航栏选择应用信息，记录关键凭证：
-
Corpid（企业ID）
-
AppKey/AppSecret
-
AgentId
-
-
将上一步的信息填写到以下表单中，填写完成后单击下一步。
表单包含以下必填字段：AgentId、AppKey、AppSecret、CorpId，分别对应上一步中记录的凭证信息。
步骤三 配置应用权限
-
Qoder CN需要获取钉钉的相应权限，才能够同步钉钉通讯录、通过钉钉登录或推送钉钉消息通知，所需权限如下所示。 进入钉钉开放平台，在步骤一中已创建的组织内部中配置权限，如果需要限制钉钉通讯录同步的用户范围，请配置权限范围。
所需权限包括：个人手机号信息、个人头像信息、通讯录管理（通讯录部门、通讯录企业相关权限）和机器人（组织内机器人发送消息）。在钉钉开放平台的权限管理页面中，选择对应的权限分类并开通所需权限。
-
在钉钉开放平台配置完成后，回到Qoder CN钉钉集成配置页面，单击下一步。
步骤四 账号绑定和属性映射
-
账号绑定方式：自动绑定邮箱相同的用户，Qoder CN将按照同步策略，自动将Qoder CN上、钉钉组织中邮箱账号相同的用户绑定在一起。
-
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上未开启其他第三方的用户和组织同步功能时，可以配置钉钉的用户和组织同步，支持配置同步时机、用户差异处理、组织差异处理的规则。
|
场景选项 |
影响结果 |
|
数据同步时机 |
说明
手动同步建议每次操作间隔 1 个小时以上。 |
|
用户差异处理：默认忽略Qoder CN中多余的账号，并为同步范围内的钉钉账号创建并绑定Qoder CN账号。 |
已有Qoder CN账号未匹配到钉钉账号：
|
|
已有钉钉账号未匹配到Qoder CN账号：
|
|
|
组织差异处理：默认忽略Qoder CN中多余的部门节点，并为同步范围内的钉钉部门节点创建并绑定Qoder CN部门。 |
已有Qoder CN部门未匹配到钉钉部门：
|
|
已有钉钉部门未匹配到Qoder CN部门：
|
查看用户和组织同步结果
在开启用户和组织同步的情况下，打开钉钉集成详情页面，可以查看最新同步结果：未执行同步、同步成功、同步失败、部分同步成功。
当同步过程中发生了同步失败情况，可参考钉钉开放平台API 调用错误码，排查同步失败的原因。
单点登录配置
开启单点登录
打开单点登录的开关后，需要将Qoder CN的回调地址配置在第一步创建的钉钉应用的的输入框，即可完成钉钉单点登录的配置。
开启后，页面系统配置信息区域会显示回调请求地址，将该地址复制后粘贴到钉钉应用的对应输入框中。
通过钉钉登录Qoder CN
开启单点登录后，Qoder CN登录页面将显示钉钉登录入口，点击后可进入钉钉登录页面，已绑定钉钉账号的用户可以通过钉钉登录Qoder CN。
开启消息通知
在开启用户和组织同步或单点登录的情况下，可开启钉钉的消息通知功能，同时需要完善钉钉应用中的机器人配置信息。
在钉钉应用的消息推送页面，开启机器人功能并单击配置。在弹出的对话框中填写机器人名称、图标和消息接收地址，然后单击保存。
钉钉工作台访问配置
如果需要通过钉钉 PC 客户端的工作台访问Qoder CN，可打开钉钉工作台访问Qoder CN的开关，同时将Qoder CN网页地址粘贴到第一步创建的钉钉应用的的输入框中。
开启后，页面会显示对应的网页地址，将该地址复制后粘贴到钉钉应用的对应输入框中。
功能的修改与移除
功能修改/关闭
在钉钉集成详情页中，如果开启了某个功能服务，可以看到修改服务配置的按钮，点击后即可进行相关功能服务配置的修改或者关闭该功能。
-
修改服务：可按需调整。
在钉钉集成详情页面中，已开启的功能服务右侧会显示修改服务配置按钮，单击即可进入修改。
-
关闭服务：功能使用会有影响，具体请参见下表。
功能
影响结果
用户和组织同步
-
不解除Qoder CN账号与钉钉账号的绑定关系。
-
不再执行钉钉通讯录的用户和组织同步。
单点登录
-
不会解除Qoder CN账号与钉钉账号的绑定关系。
-
不支持通过钉钉账号登录Qoder CN，用户若需要登录Qoder CN，可使用Qoder CN的登录账号和密码进行登录。
消息通知
-
如果同时关闭了用户和组织同步、单点登录功能，将关闭消息通知功能。
-
关闭后，不会再通过钉钉给用户发送消息通知。
钉钉工作台访问Qoder CN
不支持通过钉钉 PC 端工作台直接访问Qoder CN。
-
移除钉钉集成
在钉钉集成详情页中，可单击移除集成按钮，二次确认后即可移除钉钉集成，移除集成后：
-
解除Qoder CN账号和钉钉账号的绑定关系，不会影响已同步的用户和组织架构信息。
-
不支持接收钉钉消息通知。
-
不支持通过钉钉登录Qoder CN，用户若需要登录Qoder CN，可使用Qoder CN的登录账号和密码进行登录。