主题
OAuth2 授权与令牌
SYS-AUTH-04 | 模块
system| 实现授权码、密码、刷新令牌等标准流程,让外部应用在不接触密码的前提下拿到用户身份。
1. 使用角色与场景
角色:终端用户、第三方应用
- 授权码模式:跳转授权页 → 用户同意 → 回调换码 → 换令牌
- 管理员在后台查看并强制下线某令牌
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/oauth2/token | — | 获得访问令牌 | OAuth2OpenController#L84 |
| DELETE | /system/oauth2/token | — | 删除访问令牌 | OAuth2OpenController#L144 |
| POST | /system/oauth2/check-token | — | 校验访问令牌 | OAuth2OpenController#L162 |
| GET | /system/oauth2/authorize | — | 获得授权信息 | OAuth2OpenController#L182 |
| POST | /system/oauth2/authorize | — | 申请授权 | OAuth2OpenController#L206 |
| GET | /system/oauth2-token/page | system:oauth2-token:page | 获得访问令牌分页 | OAuth2TokenController#L34 |
| DELETE | /system/oauth2-token/delete | system:oauth2-token:delete | 删除访问令牌 | OAuth2TokenController#L42 |
| DELETE | /system/oauth2-token/delete-list | system:oauth2-token:delete | 批量删除访问令牌 | OAuth2TokenController#L51 |
| GET | /system/oauth2/user/get | — | 获得用户基本信息 | OAuth2UserController#L51 |
| PUT | /system/oauth2/user/update | — | 更新用户基本信息 | OAuth2UserController#L71 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2OpenController.java#L84 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2TokenController.java#L34 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2UserController.java#L51 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2AccessTokenDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2RefreshTokenDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2ApproveDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2CodeDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_oauth2_access_token | OAuth2AccessTokenDO |
system_oauth2_refresh_token | OAuth2RefreshTokenDO |
system_oauth2_approve | OAuth2ApproveDO |
system_oauth2_code | OAuth2CodeDO |
5. 机制与配置
- 授权码一次性使用并带过期时间
- approve 记录用户的授权决定,避免重复弹窗
6. 常见问题与排查
- 令牌校验失败时先确认客户端 id 与授权类型是否匹配
7. 关联
- 需求原件:01-01-认证授权
- 相关卡片:SYS-AUTH-01
- 相关卡片:SYS-AUTH-03