PageAdmin 统一身份认证平台技术概述

一、实施流程概览

二、阶段一：基础环境准备

2.1 环境要求确认

2.2 模块启用确认

登录 PageAdmin 后台，按以下路径操作：

1. 进入【系统设置】→【模块管理】

2. 确认“QuickSSO 认证模块”状态为“已启用”

3. 如未启用，点击“启用”并完成模块初始化

三、阶段二：认证中心配置

3.1 基础配置

进入【QuickSSO 管理】→【认证中心配置】，完成以下设置：

3.2 令牌与端点配置

SSO认证中心将自动生成以下OAuth 2.0标准端点，供第三方应用对接使用：

四、阶段三：应用注册与接入配置

4.1 注册新应用

1. 进入【QuickSSO 管理】→【应用管理】

2. 点击【添加应用】，填写应用信息：

1. 提交后系统自动生成：

   • Client ID（应用唯一标识）

   • Client Secret（应用密钥，需妥善保管）

4.2 接口调用流程

第三方应用接入后，SSO认证交互流程如下：

text

┌────────┐ 1.请求授权 ┌────────┐ 2.用户认证 ┌────────┐ │ 第三方 │ ─────────────────→ │ SSO平台 │ ────────────────→ │ 用户 │ │ 应用 │ ←───────────────── │ │ │ │ └────────┘ 3.返回授权码 └────────┘ └────────┘ │ │ │ 4.授权码换Token │ │ 5.返回Access Token │ │ 6.获取用户信息 │ ↓ ↓ ┌────────────────────────────────────────────┐ │ 7.登录成功，进入应用 │ └────────────────────────────────────────────┘

4.3 接口规格

授权请求（前端发起）

text

GET /oauth/authorize? response_type=code &client_id={client_id} &redirect_uri={callback_url} &scope={scope} &state={random_state}

Token换取（后端调用）

text

POST /oauth/token Content-Type: application/x-www-form-urlencoded grant_type=authorization_code &code={authorization_code} &client_id={client_id} &client_secret={client_secret} &redirect_uri={callback_url}

响应示例

json

{ "access_token": "eyJhbGc...", "token_type": "Bearer", "expires_in": 7200, "refresh_token": "def5020..." }

获取用户信息

text

GET /oauth/userinfo Authorization: Bearer {access_token}

响应示例：

json

{ "sub": "10001", "username": "zhang.san", "email": "zhang.san@company.com", "department": "技术部", "roles": ["sales"] }

五、阶段四：权限体系配置

5.1 角色创建

进入【用户与权限】→【角色管理】→【新建角色】

5.2 用户关联

进入【用户管理】→ 选择用户 → 关联角色

说明：用户可关联多个角色，权限取其并集

5.3 跨应用统一权限

SSO平台支持一次配置、多应用生效：

操作路径：角色管理 → 选择角色 → 关联应用权限 → 保存

六、阶段五：测试验证

6.1 单点登录测试

6.2 权限验证

6.3 常见问题处理

七、第三方系统接入清单

第三方系统对接时，需提前准备以下信息：

八、部署配置参考

8.1 应用端配置示例（通用）

json

{ "sso": { "authorization_endpoint": "https://sso.company.com/oauth/authorize", "token_endpoint": "https://sso.company.com/oauth/token", "userinfo_endpoint": "https://sso.company.com/oauth/userinfo", "client_id": "{分配的ClientID}", "client_secret": "{分配的Secret}", "redirect_uri": "https://app.company.com/callback", "scope": "openid profile", "response_type": "code" } }

8.2 支持的协议特性

九、附录：术语表