主题
OAuth2 客户端
SYS-AUTH-03 | 模块
system| 登记第三方应用(client_id/secret/回调/授权范围),为单点登录提供接入凭证。
1. 使用角色与场景
角色:平台管理员、集成开发者
- 把企业内部系统接入统一登录
- 为移动端登记独立的客户端与回调
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/oauth2-client/create | system:oauth2-client:create | 创建 OAuth2 客户端 | OAuth2ClientController#L33 |
| PUT | /system/oauth2-client/update | system:oauth2-client:update | 更新 OAuth2 客户端 | OAuth2ClientController#L40 |
| DELETE | /system/oauth2-client/delete | system:oauth2-client:delete | 删除 OAuth2 客户端 | OAuth2ClientController#L48 |
| DELETE | /system/oauth2-client/delete-list | system:oauth2-client:delete | 批量删除 OAuth2 客户端 | OAuth2ClientController#L57 |
| GET | /system/oauth2-client/get | system:oauth2-client:query | 获得 OAuth2 客户端 | OAuth2ClientController#L66 |
| GET | /system/oauth2-client/page | system:oauth2-client:query | 获得 OAuth2 客户端分页 | OAuth2ClientController#L75 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2ClientController.java#L33 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2ClientDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_oauth2_client | OAuth2ClientDO |
5. 机制与配置
- 客户端密钥加密存储
- 授权范围与令牌有效期按客户端配置
6. 常见问题与排查
- 回调地址必须与客户端登记完全一致,否则授权码模式会被拒绝
7. 关联
- 需求原件:01-01-认证授权
- 相关卡片:SYS-AUTH-04