钉钉全套集成指南
本文介绍如何在专属集成平台完成钉钉的全套集成配置，实现通讯录同步、认证源配置、单点登录和消息推送。
概述
| 场景 | 说明 | 配置位置 |
|---|---|---|
| 通讯录集成 | 将钉钉用户同步到专属集成平台 | 用户中心 > 通讯录集成 |
| 认证源配置 | 使用钉钉账号登录专属集成平台 | 用户中心 > 认证源管理 |
| 单点登录 | 通过钉钉实现应用 SSO | 应用中心 > 应用管理 |
| 消息推送 | 向钉钉发送通知消息 | 参数配置 > 企业消息配置 |
前提条件
第一部分：钉钉开放平台配置
步骤 1.1：创建钉钉应用
1.
2.
3.
4.
5.
6.
步骤 1.2：获取应用凭证
1.
2.
AppKey：应用的唯一标识AppSecret：应用的身份密钥3.
步骤 1.3：配置权限
1.
2.
成员信息读权限 - 读取用户基本信息部门信息读权限 - 读取组织架构企业群通知 - 发送工作通知3.
步骤 1.4：配置回调地址
1.
2.
3.
用户进入应用用户信息变更第二部分：通讯录集成配置
步骤 2.1：创建通讯录集成任务
1.
2.
3.
4.
5.
步骤 2.2：配置字段映射
1.
2.
| 钉钉字段 | 平台字段 | 映射方式 |
|---|---|---|
| userid | username | 创建且更新 |
| name | display_name | 创建且更新 |
| mobile | phone_number | 创建且更新 |
| 创建且更新 | ||
| department | department | 创建且更新 |
3.
步骤 2.3：配置同步策略
1.
2.
3.
步骤 2.4：验证同步结果
1.
2.
3.
4.
第三部分：认证源配置
步骤 3.1：创建钉钉认证源
1.
2.
3.
4.
5.
步骤 3.2：配置账号关联
1.
2.
3.
4.
步骤 3.3：测试认证
1.
2.
3.
4.
5.
第四部分：单点登录配置
步骤 4.1：创建 SSO 应用
1.
2.
3.
4.
步骤 4.2：启用 SSO
1.
2.
3.
4.
步骤 4.3：配置应用权限
1.
2.
3.
步骤 4.4：测试 SSO
1.
2.
3.
4.
第五部分：消息推送配置
步骤 5.1：配置企业消息
1.
2.
3.
4.
5.
步骤 5.2：配置消息模板
1.
2.
3.
步骤 5.3：测试消息发送
1.
2.
3.
4.
验证清单
| 验证项 | 验证方法 | 预期结果 |
|---|---|---|
| 钉钉用户同步 | 查看用户列表 | 用户来自钉钉 |
| 钉钉账号登录 | 使用钉钉账号登录平台 | 登录成功 |
| 应用 SSO | 从应用发起钉钉登录 | 跳转并登录成功 |
| 消息推送 | 触发密码修改等事件 | 钉钉收到通知 |
常见问题
Q1：通讯录同步失败怎么排查？
1.
2.
3.
4.
Q2：SSO 跳转失败怎么解决？
1.
2.
3.
4.
Q3：消息推送收不到怎么检查？
1.
2.
3.
4.
相关文档
| 文档 | 说明 |
|---|---|
| 通讯录集成-钉钉 | 通讯录集成详细配置 |
| 认证源-钉钉 | 认证源详细配置 |
| 单点登录-钉钉SSO | SSO详细配置 |
| 企业消息配置 | 消息推送配置 |
修改于 2026-05-07 02:17:12