概述

云原生构建平台通过 OAuth 2.0 集成企业现有认证系统，实现单点登录（SSO），用户可直接使用现有凭证访问平台。

授权码授权类型

云原生构建 支持 OAuth 授权码模式（Authorization Code Grant Type）， 适用于 Web 应用和原生应用，在用户授权后获取访问令牌。

工作流程

上图说明了 OAuth 授权码模式的完整交互流程。

1. 用户访问云原生构建平台。
2. 客户端应用调用授权服务器的 authorize 端点。
3. 授权服务器返回重定向 URI，将用户引导至授权页面。
4. 用户通过身份源（如用户名/密码）完成身份验证并授权。
5. 授权服务器颁发授权码（code）。
6. 客户端应用携带授权码，调用授权服务器的 token 端点认证。
7. 授权服务器验证授权码（code）、Client ID 和 Client Secret。
8. 授权服务器返回访问令牌（Access Token）。
9. 客户端应用携带令牌向资源服务器请求受保护资源。
10. 资源服务器验证令牌后返回所请求的资源。

配置

前往 admin 管理平台，为第三方服务创建登录配置。

登录配置需要以下参数：

必填参数

• Client ID String：客户端 ID，用于标识应用身份，与 Secret 配合完成认证。
• Client Secret String：客户端密钥，用于验证应用身份，与 ID 配合完成认证。
• Scope String：权限范围，定义授权令牌的读写权限范围。
• 授权方式 String：目前仅支持自动检测。
• 授权请求地址 String：应用请求 OAuth 授权的服务地址。
• Token 请求地址 String：应用获取 Token 的服务地址。
• 用户信息请求地址 String：应用获取 Token 后请求用户资源的地址。

可选参数

• 同步登出地址 String：用户退出登录后，应用请求同步退出 OAuth 用户的地址。
• 用户 id 映射属性 String：将用户资源的指定属性映射到云原生构建用户表 openid 字段。
• 用户账户映射属性 String：将用户资源的指定属性映射到云原生构建用户表 name 字段。
• 用户姓名映射属性 String：将用户资源的指定属性映射到云原生构建用户表 nick 字段。
• 用户邮箱映射属性 String：将用户资源的指定属性映射到云原生构建用户表 email 字段。
• 用户头像映射属性 String：将用户资源的指定属性映射到云原生构建用户表 avatar 字段。
• 提示消息映射属性 String：将用户资源的指定属性映射到云原生构建用户表 msg 字段。
• 同步权限设置 String：是否允许导入用户修改名称/账户/邮箱字段。