身份认证与应用安全 / 系统课时
判断是否需要 Token 黑名单
判断是否需要 Token 黑名单
Access Token 黑名单能让已签发 JWT 立即失效,但代价是每个受保护请求都要增加一次撤销状态判断。本节不急着实现黑名单,而是从安全目标、请求成本和故障模式出发,判断什么时候值得牺牲 JWT 的无状态特性。
学习目标
- 区分“阻止继续刷新”和“立即使当前 Access Token 失效”两类需求。
- 评估黑名单带来的存储、查询、过期清理和高可用成本。
- 根据业务风险选择短 Access Token、刷新令牌撤销或 Access Token 黑名单。
黑名单改变了请求链路
没有黑名单时,资源服务器只需验证 JWT 的签名、exp、iss、aud 等声明;令牌一旦签发,在过期前通常不依赖中心状态。加入黑名单后,还要从令牌中取得可唯一识别该令牌的 jti,或计算令牌摘要,再查询“这个令牌是否被撤销”。
这一步让系统获得即时撤销能力,同时引入新的共享状态。黑名单存储一旦变慢,所有受保护接口都会受影响;存储不可用时,还必须预先决定是“放行以保可用”还是“拒绝以保安全”,两种选择都有明确代价。
先确认是否真的需要即时撤销
很多普通退出场景不需要黑名单。若 Access Token 本身较短,例如只存活几分钟,并且退出时已经撤销 Refresh Token,那么旧 Access Token 只会在剩余生命周期内继续有效,之后也无法续期。
更值得考虑黑名单的场景,是业务明确要求“已经签发的 Access Token 现在就不能再用”,例如账号被管理员紧急禁用、检测到令牌泄露、敏感权限刚被回收,或高风险操作要求退出后立即阻断。此时等待 exp 自然到期可能不满足安全目标。
| 场景 | 是否需要立即失效 | 常见做法 |
|---|---|---|
| 普通用户主动退出 | 通常不必 | 短 Access Token + 撤销 Refresh Token |
| 密码修改但允许短暂延迟 | 视风险而定 | 缩短 Access Token 生命周期,必要时撤销刷新令牌族 |
| 账号冻结、权限紧急回收 | 通常需要 | 黑名单、会话版本号或中心化会话 |
| 检测到 Access Token 泄露 | 需要 | 立即撤销对应令牌或该用户全部会话 |
黑名单的真实成本
黑名单条目没有必要永久保存,只需保存到原 Access Token 的 exp。典型实现会以 jti 为键,并把剩余有效期作为 TTL;如果令牌没有 jti,可以保存完整令牌的 SHA-256 摘要,避免把原始 Bearer Token 当作数据库键长期暴露。
真正的成本不只是几条记录,而是每个请求都多一次判断。如果请求量大,通常会使用 Redis 这类低延迟存储,并考虑本地短缓存降低远程查询次数;但缓存又会带来撤销传播延迟。使用关系数据库做逐请求查询虽然简单,却容易把认证压力转移到数据库连接池。
还要明确故障策略。对普通内容接口,黑名单服务短暂不可用时可能选择有限度降级;对转账、密钥管理等高风险接口,通常更倾向拒绝请求。这个选择应该在架构设计时确定,而不是等 Redis 故障后临时决定。
一个可执行的容量估算
可以先用简单数字估算黑名单的峰值规模。下面脚本假设每小时撤销 12000 个 Access Token,平均还剩 20 分钟过期,并粗略按每条 120 字节估算键、TTL 与存储开销。
revoked_per_hour = 12000
avg_remaining_minutes = 20
bytes_per_entry = 120
entries = revoked_per_hour * avg_remaining_minutes / 60
memory_mb = entries * bytes_per_entry / 1024 / 1024
print(f"estimated entries: {entries:.0f}")
print(f"estimated memory: {memory_mb:.2f} MB")预期输出
estimated entries: 4000
estimated memory: 0.46 MB这个结果只估算静态条目体积,不包含 Redis 对象、哈希表、复制、持久化和网络开销;生产容量应以真实 jti 长度、峰值撤销量和副本数重新测算。更重要的是,黑名单查询发生在请求热路径上,延迟预算往往比纯内存容量更关键。
做决定时看四件事
判断是否上黑名单时,可以依次问:现有 Access Token 的剩余有效期是否已经足够短;业务是否要求秒级撤销;撤销事件是少量异常还是高频常态;系统能否承担一个高可用、低延迟的中心状态服务。
如果答案只是“用户点退出后希望页面立刻回到登录页”,前端清理凭据并撤销 Refresh Token 通常已经完成目标。只有当安全要求明确指出“旧 Access Token 在 exp 之前也必须失效”时,黑名单增加的存储、查询和故障复杂度才有直接价值。