认证概览
Auth 提供项目终端用户的账号体系、登录提供方与会话管理。Project 级配置决定可用的登录方式;账号会话与 OAuth 登录测试产生的测试会话相互隔离。
入口与权限
- 侧栏入口 Auth(infrastructure 分组),路径
/console/project-{region}-{project}/auth;命令中心支持ge直达 Security 页。 - 写操作按 scope 控制:用户与目标需要
users.write/targets.write,团队需要teams.write;组织角色 owner / admin / developer / editor 具备写权限,billing / analyst 只读。 - Auth 页面另含 Usage(项目 Auth 用量)、Settings(登录方式开关)与 Test(OAuth 登录测试)页签。
登录提供方
| 提供方 | 说明 |
|---|---|
| 账号密码 / 邮箱 | 基础账号体系,支持邮箱验证状态;含 Magic URL、OTP 等基于邮箱的登录方式 |
| 企业 SSO | Console 企业登录:SAML 与企业单点登录,由部署配置启用 |
| 自定义 OAuth2(Custom OAuth2) | 接入兼容 OAuth 2.0 Authorization Code 的公开提供方(如 Gitee、企业统一身份),配置型接入,无需新增服务端 Provider 类;按端点域名内置识别 Gitee 并给出字段路径示例提示 |
| MFA | 多因素认证(验证器 App / 邮箱 / 短信 / 恢复码) |
Custom OAuth2 配置要点
- 在身份提供方创建 OAuth2 应用,取得 Client ID / Client Secret。
- 在项目 Auth → Settings → OAuth2 提供商 → Custom OAuth2 填写:Well-Known Endpoint(可选)、Authorization Endpoint、Token Endpoint、User Info Endpoint、邮箱端点(可选的独立 Email Endpoint)、Client 认证方式(
client_secret_post等),以及 Subject / Email / Name / Email verified 字段路径(端点域名为 gitee.com 时给出 Gitee 字段示例)。 - 复制 Console 生成的完整 callback URI,原样登记到身份提供方。
- 通过 Auth → Test 的「Test OAuth2 login」验收。
硬性边界:
- 仅支持 Authorization Code 流程;所有端点必须 HTTPS 且公网可达,生产环境要求独立 callback origin。
- 字段路径只支持点分隔属性与十进制数组下标(如
id、0.email),不支持表达式。 - Client Secret 仅存服务端、不回显;登录 state 一次性使用,并与项目、浏览器、callback、Client ID 与服务端 state revision 绑定,配置变化后旧 state 不再有效。
- 邮箱只有在验证状态字段明确返回布尔
true时才视为已验证。
OAuth 登录测试(Test)
截图未公开:上游原图包含真实账号或资源标识。
- Test 页签用于测试当前项目已启用的公共 OAuth Provider;未启用任何公共 Provider 时页面给出提示(如上图)。
- 登录测试支持自定义 Scope(按 Provider 支持的授权范围填写);不同 Scope 的测试相互隔离,状态串与邮箱错配会直接阻断登录。
- 测试前需将当前主机名登记为项目的 Web 平台(见项目总览)。
- 测试产生的项目用户会话与 Console 会话相互隔离:退出测试用户不会退出 Console;页面提示仅供开发与验收测试使用。