Skip to content

登录认证 ​

SYS-AUTH-01 | 模块 system | 用账号密码、手机号或邮箱换取访问令牌,是所有后台功能的第一道门。

1. 使用角色与场景 ​

角色:终端用户、管理员

  • 员工在后台登录,拿到 access-token 后访问所有接口
  • 令牌过期时用 refresh-token 静默续期
  • 退出登录,令牌立即失效

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/auth/login—使用账号密码登录AuthController#L66
POST/system/auth/logout—登出系统AuthController#L73
POST/system/auth/refresh-token—刷新令牌AuthController#L85
GET/system/auth/get-permission-info—获取登录用户的权限信息AuthController#L93
POST/system/auth/register—注册用户AuthController#L120
POST/system/auth/sms-login—使用短信验证码登录AuthController#L129
POST/system/auth/send-sms-code—发送手机验证码AuthController#L138
POST/system/auth/reset-password—重置密码AuthController#L146
GET/system/auth/social-auth-redirect—社交授权的跳转AuthController#L156
POST/system/auth/social-login—社交快捷登录,使用 code 授权码AuthController#L169

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/auth/AuthController.java#L66
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

4. 数据表 ​

表DO
system_oauth2_access_tokenOAuth2AccessTokenDO
system_oauth2_refresh_tokenOAuth2RefreshTokenDO

5. 机制与配置 ​

  • TokenAuthenticationFilter 解析 Authorization 头并写入 SecurityContext
  • 令牌与刷新令牌存 Redis 与 MySQL 双份,登出时删除
  • 登录失败次数与验证码由 CaptchaService 兜底

6. 常见问题与排查 ​

  • 401 先看令牌是否过期、租户上下文是否建立
  • 允许的免鉴权路径由各模块 AuthorizeRequestsCustomizer 追加

7. 关联 ​