主题
登录日志
SYS-LOG-01 | 模块
system| 记录每次登录的账号、IP、终端与结果,用于安全审计与异常告警。
1. 使用角色与场景
角色:管理员、安全审计
- 排查某账号异地登录
- 统计登录失败 TOP 用户
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| GET | /system/login-log/get | system:login-log:query | 获得登录日志 | LoginLogController#L39 |
| GET | /system/login-log/page | system:login-log:query | 获得登录日志分页列表 | LoginLogController#L47 |
| GET | /system/login-log/export-excel | system:login-log:export | 导出登录日志 Excel | LoginLogController#L55 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/logger/LoginLogController.java#L39 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/logger/LoginLogDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_login_log | LoginLogDO |
5. 机制与配置
- 登录成功/失败均落库,记录 user-agent 与 IP 归属地
6. 常见问题与排查
- 代理场景下 IP 需从 X-Forwarded-For 取,注意只信任可信代理
7. 关联
- 需求原件:01-08-日志审计
- 相关卡片:SYS-LOG-02