Skip to content

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/pagesystem:oauth2-token:page获得访问令牌分页OAuth2TokenController#L34
DELETE/system/oauth2-token/deletesystem:oauth2-token:delete删除访问令牌OAuth2TokenController#L42
DELETE/system/oauth2-token/delete-listsystem:oauth2-token:delete批量删除访问令牌OAuth2TokenController#L51
GET/system/oauth2/user/get—获得用户基本信息OAuth2UserController#L51
PUT/system/oauth2/user/update—更新用户基本信息OAuth2UserController#L71

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2OpenController.java#L84
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2TokenController.java#L34
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/oauth2/OAuth2UserController.java#L51
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2AccessTokenDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2RefreshTokenDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2ApproveDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/oauth2/OAuth2CodeDO.java

4. 数据表 ​

表DO
system_oauth2_access_tokenOAuth2AccessTokenDO
system_oauth2_refresh_tokenOAuth2RefreshTokenDO
system_oauth2_approveOAuth2ApproveDO
system_oauth2_codeOAuth2CodeDO

5. 机制与配置 ​

  • 授权码一次性使用并带过期时间
  • approve 记录用户的授权决定,避免重复弹窗

6. 常见问题与排查 ​

  • 令牌校验失败时先确认客户端 id 与授权类型是否匹配

7. 关联 ​