如果企业已使用钉钉办公，可将钉钉配置为认证源，企业成员即可使用钉钉账号登录企业控制台。
本文档介绍钉钉认证源的完整配置流程：在钉钉开放平台创建应用、在企业管理后台创建钉钉认证源、配置关联规则、在钉钉侧完成参数配置，最后在企业登录方式中启用钉钉。开始配置前，请确保您拥有钉钉开放平台的开发者权限及钉钉管理后台的管理员权限。
步骤1：创建钉钉应用
创建钉钉自建应用
1. 登录 钉钉开放平台，选择顶部菜单应用开发，单击左侧边栏钉钉应用，再单击创建应用。
2. 在弹出的窗口中，填写应用名称、应用描述后，单击保存。
复制应用凭证
1. 单击已创建的应用，自动跳转至应用信息页面，选择凭证与基础信息。
2. 在凭证信息中复制 Client ID 和 Client Secret。
步骤2：在腾讯统一身份侧创建钉钉认证源
1. 在企业管理后台 > 组织与成员 > 认证源管理中，单击展开添加认证源。选择钉钉认证源，单击添加。
2. 进入钉钉配置页面，填写上一步获取的应用凭证 Client ID 和 Client Secret。
3. 一键获取凭证信息：当企业已完成钉钉数据源配置，且钉钉数据源与钉钉认证源使用同一钉钉服务时，可单击选择该数据源选项，自动拉取钉钉配置信息，节省配置时间。未提示一键获取时请忽略此步骤。
4. 填写完成后，复制生成的“回调链接”。此链接需在后续步骤中配置到钉钉侧，请先记录。
步骤3：配置关联关系
填写完配置信息，并记录“回调链接”时，单击下一步切换至“关联规则”配置。“关联规则”主要分两部分：“匹配逻辑”和“未匹配逻辑”。
匹配逻辑
用户使用钉钉认证源登录时，系统会根据钉钉侧登录人员信息与腾讯统一身份中的人员信息进行匹配。
例如，钉钉默认匹配逻辑的条件组为：当钉钉人员的手机号（mobile）与腾讯统一身份中人员的手机号（mobile）字段一致时，视为同一人并建立匹配关系，此时将登录至腾讯统一身份的该人员。
您也可以根据业务需求自行设定其他字段映射关系、添加条件或条件组。钉钉支持最多创建3个条件组，每个条件组最多包含3个条件。条件组与条件组之间为“或”的关系（登录时按条件组顺序由上至下执行），同一条件组内的条件之间为“且”的关系。例如，可配置如下匹配逻辑：当钉钉人员的手机号（mobile）与腾讯统一身份中人员的手机号（mobile）字段一致，或当钉钉人员的邮箱（email）与姓名（name）和腾讯统一身份中人员的邮箱（email）与用户名（name）字段一致时，视为同一人并建立匹配关系。
未匹配逻辑
若用户登录时通过“匹配逻辑”在腾讯统一身份侧未找到与之匹配的人员，则执行“未匹配逻辑”。这里我们支持两种选择：
1.1 拒绝登录
通过“匹配逻辑”在腾讯统一身份侧未找到匹配人员时，将直接拒绝登录。
1.2 新建用户
通过“匹配逻辑”在腾讯统一身份侧未找到匹配人员时，系统将按新建用户属性设置在腾讯统一身份侧新建用户，并继续完成登录。
钉钉的默认新建用户属性映射逻辑如下图，您也可以根据业务需要自行修改。
注意：
腾讯统一身份创建用户时，手机号、邮箱、登录用户名三项必填其一，请确保这些字段至少有一个且在钉钉侧有值。
配置完成后，单击保存。
步骤4：在钉钉侧进行参数配置
再次进入钉钉管理后台，添加回调链接并配置权限。
配置回调链接
在步骤1创建的钉钉应用页面中，单击左侧边栏开发配置 > 分享设置，在“接入登录”模块中填写步骤2复制的回调链接，并单击添加。
开通权限
1. 单击左侧边栏开发配置 > 权限管理，进入权限管理页面。
2. 通过逐一搜索以下权限名称，为应用开通以下权限。注意：以下权限必须全部开通。
个人权限（2个）
个人手机号信息
通讯录个人信息读权限
通讯录管理（5个）
企业员工手机号信息
通讯录部门信息读权限
成员信息读权限
根据手机号获取成员基本信息权限
通讯录部门成员读权限
3. 查询后单击立即开通，提示“开通成功”。
配置 IP 白名单
注意：
由于安全管控要求，IP 池中的 IP 地址可能不定期变化，一般缩减不会影响用户使用。
应用发布
在左侧边栏选择部署与发布 > 版本管理与发布，在“应用发布”下单击确认发布。
步骤5：在企业登录方式中启用钉钉
确认配置无误后，返回“认证源”列表页，单击开启当前钉钉认证源。
常见问题
Q1：配置完成后，提示“没有调用该接口的权限，接口权限申请请参考.......”
钉钉开放平台中未配置认证所需的接口权限。配置权限列表请参见步骤4“在钉钉侧进行参数配置”中的开通权限章节。
Q2：配置钉钉认证源信息后，单击下一步，提示“凭证不正确”
请检查“Client ID”和“Client Secret”信息是否正确。
Q3：配置完成后，提示“IP 不在白名单之中，请参考.......”。
钉钉开放平台中未配置“服务器出口 IP”。配置服务器出口 IP，请参见步骤4“在钉钉侧进行参数配置”中的配置 IP 白名单章节。
