PageAdmin 统一身份认证平台 - 接入实施步骤

一、实施流程概览

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

2.1 环境要求确认

2.2 模块启用确认

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

1. 进入【系统设置】→【模块管理】
   
2. 确认“QuickSSO 认证模块”状态为“已启用”
   
3. 如未启用，点击“启用”并完成模块初始化
   

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

3.1 基础配置

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

3.2 令牌与端点配置

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

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

4.1 注册新应用

1. 进入【QuickSSO 管理】→【应用管理】
   
2. 点击【添加应用】，填写应用信息：
   

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

• 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 支持的协议特性

九、附录：术语表