主题
平台配置 / 三方登录
「三方登录」配置平台的外部身份源。页面说明写明：配置 OIDC / LDAP 等外部身份源，用户可用它们登录平台。需要接入企业目录服务、企业办公应用或统一身份平台时，从这一页逐项配置并启用。
前提条件
- 已登录 Boss 管理侧。
- 当前账号具备「平台配置」下「三方登录」的查看权限；配置身份源还需要对应的写权限。
- 已在身份源侧准备好接入参数，例如目录服务地址、应用凭证或单点登录信息。
界面说明
截图采集于 2026-11-03，环境：开发环境。
页面顶部是面包屑「平台配置 / 三方登录」，下方为页面说明。身份源按分组以卡片列表展示，每个分组标题显示启用情况，每个身份源占一行，包含图标、名称、登录方式说明，右侧是「配置」按钮和启用开关。
| 分组 | 启用情况 | 身份源 |
|---|---|---|
| 目录服务 | 已启用 1 / 1 | 「LDAP」，说明为「通过 LDAP 目录服务登录」，开关为开。 |
| 企业协同 | 已启用 0 / 2 | 「钉钉」，说明为「通过钉钉扫码登录」；「飞书」，说明为「通过飞书扫码登录」。两者开关均为关。 |
| OAuth 身份源 | 已启用 0 / 5 | 「PLUTO」「AUC」「SAGESUITE」「飞连」「OIDC」，说明分别为「通过 PLUTO 单点登录」「通过 AUC 单点登录」「通过 SAGESUITE 单点登录」「通过飞连单点登录」「通过通用 OIDC（如 Microsoft Entra ID）登录」，开关均为关。 |
同一分组内各行共用一张卡片，分组标题右侧的计数表示该分组已启用的身份源数量。
各身份源的配置字段
单击某个身份源的「配置」，右侧滑出以该身份源命名的面板。面板标题下按分组列出字段，LDAP 的面板分为「连接」与「属性映射」两组，其余身份源分为「应用凭据」与可选的同步设置。
LDAP
| 字段 | 必填 | 说明 |
|---|---|---|
| 服务器地址 | 是 | 目录服务地址与端口，截图中为「openldap.ldap-test.svc.cluster.local:389」。 |
| Bind DN | 是 | 绑定账号的 DN。 |
| Bind 密码 | 是 | 绑定账号密码，密码框不回显。 |
| Base DN | 是 | 用户检索的根路径，截图中为「dc=example,dc=org」。 |
| entryUUID 属性 | 否 | 唯一标识属性名，用于匹配平台账号。 |
| 用户名属性 | 否 | 登录用户名字段。 |
| 手机号属性 | 否 | 手机号字段。 |
| 邮箱属性 | 否 | 邮箱字段。 |
| 姓名属性 | 否 | 姓名字段。 |
截图采集于 2026-11-03，环境：开发环境。
LDAP 面板底部为「取消」「测试连接」「保存」；LDAP 没有同步部门开关，保存后回到列表再单独启用。
钉钉与飞书
两者的字段结构相同，仅应用凭证的名称不同。
| 字段 | 必填 | 说明 |
|---|---|---|
| AppKey / App ID | 是 | 企业应用的标识，钉钉为「AppKey」，飞书为「App ID」。 |
| Secret | 是 | 应用密钥，多行输入，不回显。 |
| 回调地址 | 是 | 身份源回调到平台的地址。 |
| 同步部门 | 否 | 开关，说明为「登录时把部门结构同步到平台」。 |
截图采集于 2026-11-03，环境：开发环境。
面板底部为「取消」「测试连接」「保存并启用」。
OAuth 身份源
PLUTO、AUC、SAGESUITE、OIDC 的字段一致，飞连在此基础上多出同步设置。
| 字段 | 必填 | 说明 |
|---|---|---|
| Client ID | 是 | 身份源分配的应用标识。 |
| Client Secret | 是 | 应用密钥，密码框不回显。 |
| Base URL | 是 | 身份源服务地址。 |
| 回调地址 | 是 | 身份源回调到平台的地址。 |
OIDC 的第一个字段为「Issuer」，替代「Base URL」，填写身份源的签发方地址。
截图采集于 2026-11-03，环境：开发环境。
飞连在此之上增加「同步部门」开关与「LDAP 同步」分组，后者包含「LDAP 地址」「LDAP Bind DN」「LDAP Bind 密码」「LDAP 部门 Base DN」四项，用于把飞连的部门结构同步到平台。
截图采集于 2026-11-03，环境：开发环境。
面板底部为「取消」「测试连接」「保存并启用」；「保存并启用」在保存配置的同时打开该身份源的开关。
操作步骤
配置身份源
- 在目标分组中找到身份源，例如「企业协同」下的「钉钉」。
- 单击行右侧的「配置」，在右侧面板中填写该身份源的接入参数。
- 需要先验证地址与凭证时单击「测试连接」。
- 仅保存配置时单击「保存」；保存的同时启用则单击「保存并启用」。
启用身份源
- 完成「配置」并确认参数正确。
- 打开该行右侧的开关；已用「保存并启用」保存的无需再切换。
- 核对分组标题的「已启用」计数，确认已计入该项。
停用身份源
- 确认没有用户仍依赖该方式登录。
- 关闭该行右侧的开关，分组计数相应减少。
结果验证
启用后，开关变为打开状态，分组标题的「已启用」计数加一。停用后计数减一。使用该身份源登录成功后，用户可在平台内正常访问已授权的页面。
注意事项
- 只配置不启用时，该项开关保持关闭，配置不会生效。
- 停用登录方式前，先确认仍有其他可用方式进入平台，避免无法登录。
- 身份源的密钥、证书等凭证按安全要求保管，不写入文档或工单。
- 分组计数是该分组内启用数量，与平台整体登录方式数量无关。
- 「保存并启用」会同时打开该身份源的开关，改动前确认已经具备可用的登录入口。