主题
登录认证
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. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/auth/AuthController.java#L66 |
| 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 |
4. 数据表
| 表 | DO |
|---|---|
system_oauth2_access_token | OAuth2AccessTokenDO |
system_oauth2_refresh_token | OAuth2RefreshTokenDO |
5. 机制与配置
- TokenAuthenticationFilter 解析 Authorization 头并写入 SecurityContext
- 令牌与刷新令牌存 Redis 与 MySQL 双份,登出时删除
- 登录失败次数与验证码由 CaptchaService 兜底
6. 常见问题与排查
- 401 先看令牌是否过期、租户上下文是否建立
- 允许的免鉴权路径由各模块 AuthorizeRequestsCustomizer 追加
7. 关联
- 需求原件:01-01-认证授权
- 相关卡片:SYS-AUTH-02
- 相关卡片:SYS-AUTH-04