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

设计 Claims 与过期时间

设计 Claims 与过期时间

JWT 载荷不是“用户资料缓存”。本节要把访问令牌需要的身份、时间和授权信息压缩成稳定契约,同时控制过期窗口,避免敏感字段泄露和权限变更长期不生效。

学习目标

  • 为 sub、iat、exp 选择稳定且可验证的含义
  • 判断哪些自定义 Claims 值得进入访问令牌
  • 设计兼顾安全性、用户体验和权限时效性的过期策略

先决定哪些信息真的需要进令牌

访问令牌的 Claims 应服务于两个问题:这是谁,以及当前请求需要哪些稳定的授权上下文。不要因为 JWT 能放 JSON,就把用户表整行复制进去。

Claim 建议含义 设计要点
sub 用户或账号的稳定唯一标识 优先使用不会因改名而变化的内部 ID
iat 令牌签发时间 用于判断令牌新旧、审计和轮换策略
exp 令牌绝对过期时间 访问令牌必须有明确上限
iss 签发者 多认证服务或多环境时尤其有用
aud 目标受众 防止令牌被拿到错误的服务使用
jti 令牌唯一 ID 只有需要审计或撤销追踪时再加入

sub 不宜直接使用邮箱、手机号或可修改用户名。它们既可能变化,也更容易暴露个人信息。更稳妥的做法是让 sub 只表达身份主键,再由服务端按需查询展示资料。

把签发时间和过期时间设计成一组约束

iat 与 exp 通常使用 NumericDate,也就是 Unix 时间秒数。核心关系很简单:exp = iat + TTL。例如把访问令牌 TTL 设为 15 分钟,并不意味着所有系统都应固定使用 15 分钟,而是要根据风险、接口敏感度和刷新机制决定。

下面是 Claims 的片段示例,用于说明载荷结构;它不是完整 JWT,也不能直接当作访问令牌发送。

json
{
  "sub": "user-1287",
  "iat": 1789574400,
  "exp": 1789575300,
  "iss": "auth-service",
  "aud": "api-service",
  "tenantId": "tenant-a"
}

这里 exp - iat = 900 秒,即 15 分钟。实际签发时应由服务器时钟计算这些时间值,不要从前端请求里接受 iat 或 exp。

分布式环境可以给校验器保留很小的时钟偏差容忍,例如几十秒,但这只是处理机器时钟轻微不同步。若经常依赖较大的容忍窗口,应先修复时间同步,而不是不断放宽令牌有效期。

自定义 Claims 只放稳定且必要的数据

自定义 Claims 适合承载请求链路中高频使用、且在令牌有效期内通常不会频繁改变的信息,例如租户 ID、账号类型或少量粗粒度角色。这样可以减少每个请求都回查数据库的成本。

反过来,昵称、头像、余额、详细权限列表、用户偏好等数据变化频繁,不适合塞入访问令牌。即使数据库已经更新,旧 JWT 里的值仍会持续存在到过期,容易造成展示错误或授权滞后。

如果权限变化必须立刻生效,可以采用短生命周期访问令牌,并配合服务端权限版本、撤销列表或关键操作实时查询。JWT 的价值是减少状态查询,不是让所有状态永久脱离服务器。

过期策略要和失效机制一起设计

仅设置 exp 解决的是“自然过期”,不能解决账号刚被禁用、角色刚被撤销等即时失效问题。访问令牌越长寿,这类变化在旧令牌中的滞后窗口就越大。

因此设计 Claims 时应同时明确三件事:访问令牌允许存活多久、哪些权限可以接受这段延迟、哪些高风险变化必须由服务端额外校验。最终得到的 JWT 应只携带完成请求所需的最小信息,并让过期时间成为安全边界,而不是装饰字段。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计 Claims 与过期时间

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

登录哪都通