35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# 6.17 在线用户
|
||
|
||
:::tip 概述
|
||
在线用户页展示当前活跃的 JWT 会话（缓存登记，不落库），支持查看明细与强制下线。多端登录并存，每个会话独立管理。
|
||
:::
|
||
|
||
## 功能清单
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page | 分页查询在线会话（按租户隔离） |
|
||
| Detail | 会话明细 |
|
||
| ForceLogout | 按会话（jti）强制下线 |
|
||
| ForceLogoutUser | 按用户强制下线（其全部会话） |
|
||
|
||
## 数据来源
|
||
|
||
在线登记在缓存：`online:jti:set`（有序集合，score=访问令牌过期时间）+ `online:info:{jti}`（明细 JSON：用户、IP、UA、登录时间、令牌过期）。登录时 MarkOnline、登出/强退时 MarkOffline。
|
||
|
||
## 强制下线语义
|
||
|
||
拉黑该会话的**访问令牌与刷新令牌**（防登出后凭刷新令牌复活）+ 移除在线登记。只影响目标会话，用户其他端不受影响（ForceLogoutUser 则清全部）。
|
||
|
||
## 过期清理
|
||
|
||
集合按 score（过期时间）可范围清理——令牌过期后在线记录随查询自然过滤/清理，无需专门任务。
|
||
|
||
## 管理界面
|
||
|
||
`monitor/online`：会话列表 + 强制下线按钮（需相应权限码）。
|
||
|
||
## 相关
|
||
|
||
- [5.1 用户认证（JWT）](/zh/core/jwt.html)
|