身份认证与应用安全 / 系统课时

判断是否需要 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 与存储开销。

python
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")

预期输出

text
estimated entries: 4000
estimated memory: 0.46 MB

这个结果只估算静态条目体积,不包含 Redis 对象、哈希表、复制、持久化和网络开销;生产容量应以真实 jti 长度、峰值撤销量和副本数重新测算。更重要的是,黑名单查询发生在请求热路径上,延迟预算往往比纯内存容量更关键。

做决定时看四件事

判断是否上黑名单时,可以依次问:现有 Access Token 的剩余有效期是否已经足够短;业务是否要求秒级撤销;撤销事件是少量异常还是高频常态;系统能否承担一个高可用、低延迟的中心状态服务。

如果答案只是“用户点退出后希望页面立刻回到登录页”,前端清理凭据并撤销 Refresh Token 通常已经完成目标。只有当安全要求明确指出“旧 Access Token 在 exp 之前也必须失效”时,黑名单增加的存储、查询和故障复杂度才有直接价值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

判断是否需要 Token 黑名单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通