第三方登录接入配置
本文供有相应管理权限的用户配置企业微信、钉钉登录。一次可用的接入需要同时完成 平台应用配置、租户登录开关、用户身份关联，最后用业务账号验证。普通成员直接阅读登录教程。
1. 准备平台应用与正式地址
请组织的企业微信或钉钉管理员准备对应企业应用，确认应用可用于目标登录场景，测试成员在应用的可见或授权范围内。具体开通入口、审核要求及域名规则以第三方平台当前说明为准。
准备以下信息，通过组织批准的渠道交给配置人员，不放入公共文档、截图或聊天记录。
| 信息 | 用途 |
|---|---|
| 平台类型 | 选择企业微信或钉钉，不能混用两套应用参数 |
| appId | 登录授权所需的应用标识；企微入口用作 appid，钉钉入口用作 client_id，按对应平台和服务端合同填写 |
| appSecret | 对应应用的服务端凭据，妥善保管 |
| 企业微信 AgentId | 企业微信应用标识，填写在本系统的拓展字段，供企微授权入口使用 |
| 正式访问地址与回调配置 | 保证授权结束后回到本系统，并符合第三方平台允许的域名与回调规则 |
本系统当前按实际访问站点生成回调地址。使用统一正式入口时，回跳示例为 https://admin.duoge.work/#/authredirect；独立部署应替换为自己的 HTTPS 站点。配置时同时核对系统中的回调字段与第三方平台要求的域名、回调登记方式，不能只修改其中一处。
2. 配置当前组织的登录应用
- 登录正确组织，在有权限的管理菜单中打开第三方登录应用配置列表。菜单名称和位置由组织授权决定，没有入口时联系平台管理员。
- 新增或编辑目标平台配置，选择对应 类型，填写 描述、appId、appSecret、回调地址。
- 企业微信按应用信息填写 拓展字段中的 AgentId；钉钉的拓展配置按当前部署要求处理，不套用企微参数。
- 保存后重新打开配置核对平台、描述、回调及组织归属。已有凭据显示为掩码时，不把掩码当作新凭据复制填写；需更换时使用真实的新凭据。
这里配置的是系统登录使用的第三方应用，不要与业务应用内的社交集成配置混淆。保存成功只代表配置被接收，还需要完成后续授权验证。
3. 开启租户登录入口
- 在租户管理中打开目标租户的 个性化设置，再次核对租户。
- 根据实际已接通的平台开启 启用企微登录 或 启用钉钉登录，保存。
- 在新的登录页面选择同一组织，确认出现相应按钮。已有页面未更新时刷新后再核对。
只开启按钮而没有对应应用配置，用户仍无法完成授权。停用某平台前，应确认受影响成员有其他可用登录方式。
4. 关联账号并验证
先由测试成员使用已有方式登录，在个人中心绑定本人第三方账号，再退出系统测试第三方登录。首次登录能否自动建立业务账号不能仅凭出现按钮推断，按部署策略确认。
| 检查项 | 通过标准 |
|---|---|
| 入口 | 正确租户显示已开通的平台按钮 |
| 授权 | 第三方页面接受应用、域名和成员身份，无回调错误 |
| 账号关联 | 个人中心刷新后显示正确平台已绑定 |
| 登录结果 | 授权返回后进入预期组织与业务账号 |
| 业务权限 | 成员能打开应有菜单，未获得额外权限 |
| 手机使用 | 在组织实际使用的手机浏览器单独验证跳转和返回 |
| 备用登录 | 成员仍保有组织认可的恢复或其他登录方式 |
验证不通过时，记录平台、时间、正式访问域名及脱敏错误提示。优先依次检查组织、应用参数、回调登记、成员范围、绑定关系和账号状态；不通过公开截图传播 Secret、授权码或令牌。
本教程依据当前版本的配置与登录流程编写，未替任何组织完成真实企业微信或钉钉授权联调。上线前需在目标部署逐项验证。