主题
平台配置 / Oauth 应用
「Oauth 应用」登记接入平台单点登录的第三方应用。页面说明写明：接入平台单点登录的第三方应用，管理回调地址、授权类型与密钥。需要让自有系统用平台账号登录，或轮换已接入应用的密钥时使用这一页。
前提条件
- 已登录 Boss 管理侧。
- 当前账号具备「平台配置」下「Oauth 应用」的查看权限；创建应用还需要对应的写权限。
- 已确认第三方应用的回调地址，以及需要的授权类型和 Scope。
界面说明
截图采集于 2026-11-03，环境：开发环境。
页面顶部是面包屑「平台配置 / Oauth 应用」，下方为页面说明。筛选区左侧是「状态」筛选，右侧是「创建」按钮和「列显隐」「刷新」图标按钮。
| 列 | 说明 |
|---|---|
| 应用名称 | 应用显示名，第二行显示系统生成的 Client ID，如「oa_737cba…」；名称过长时截断。 |
| 状态 | 应用状态，截图中均为「已启用」。 |
| Client Secret | 掩码显示，仅保留末四位，如「••••••••4e48」。 |
| 回调地址 | 回调 URL，截断显示，旁边的图标可「复制」。 |
| 授权类型 | 以标签显示，截图中出现「authorization_code」「refresh_token」「client_credentials」。 |
| 操作 | 「编辑」按钮和「更多操作」图标。 |
列表底部分页显示「共 5 条」「10 条/页」。列宽较窄时内容会截断，需查看完整值时使用复制图标或进入编辑。
「更多操作」展开后有三个菜单项：「轮换密钥」「禁用」「删除 OAuth 应用」。
截图采集于 2026-11-03，环境：开发环境。
「轮换密钥」生成新的 Client Secret 并展示一次；「禁用」把应用状态改为停用；「删除 OAuth 应用」移除该应用及其登记的回调地址。
单击「创建」后，右侧滑出「新增 OAuth 应用」面板，标题下提示「Client ID 和 Client Secret 由系统生成；Secret 只在创建或轮换后展示一次。」。面板字段如下。
| 字段 | 说明 |
|---|---|
| 应用名称 | 必填。 |
| 回调地址 | 第三方应用接收授权结果的地址。 |
| 授权类型 | 必填，截图中默认填入「authorization_code, refresh_token」。 |
| 允许的 Scope | 截图中默认填入「openid, profile」。 |
面板底部为「取消」和「保存」。
截图采集于 2026-11-02，环境：开发环境。
面板右上角的关闭图标可放弃本次创建。
单击列表中的「编辑」滑出「编辑 OAuth 应用」面板，字段与创建时一致：应用名称（必填）、回调地址、授权类型（必填）、允许的 Scope，标题下同样提示「Client ID 和 Client Secret 由系统生成；Secret 只在创建或轮换后展示一次。」。编辑面板底部为「取消」「保存」，不包含 Client ID 与 Secret 的输入项。
截图采集于 2026-11-03，环境：开发环境。
「授权类型」与「允许的 Scope」按逗号分隔填写，截图中编辑面板为「authorization_code, refresh_token, client_credentials」与「openid, profile, email, groups」，以实际应用需要为准。
操作步骤
接入新应用
- 单击列表右上角的「创建」。
- 在「新增 OAuth 应用」面板中填写「应用名称」和「回调地址」。
- 确认「授权类型」和「允许的 Scope」符合应用需要。
- 单击「保存」，并在面板关闭前记录系统展示的 Client ID 和 Client Secret。
查看已有应用
- 单击「状态」按启用状态筛选。
- 在「回调地址」列单击复制图标，取回完整地址。
- 需要更新密钥时，在行内「更多操作」中选择「轮换密钥」。
调整应用
- 在目标行单击「编辑」。
- 修改回调地址、授权类型或 Scope。
- 保存后，第三方应用需按新的配置重新发起授权。
停用或删除应用
- 在目标行单击「更多操作」。
- 选择「禁用」，应用状态变为停用。
- 需要彻底移除时选择「删除 OAuth 应用」，按确认弹窗的提示操作。
停用或删除后，已接入该应用的系统无法继续通过它登录，操作前通知使用方。
结果验证
保存后，列表中出现该应用，状态为「已启用」，应用名称下方显示 Client ID，Client Secret 以掩码显示。第三方应用使用 Client ID 和 Secret 发起授权，能跳转到回调地址并完成登录。
注意事项
- Client Secret 只在创建或轮换后展示一次，未及时保存只能重新轮换。
- 回调地址必须与第三方应用登记的地址一致。
- 「授权类型」和「允许的 Scope」决定应用能获取的能力，按最小需要勾选。
- 停用应用后，已接入该应用的系统无法继续通过它登录，操作前通知使用方。
- 「删除 OAuth 应用」会移除应用登记，属于不可逆操作，删除前确认没有系统仍在引用该 Client ID。