身份认证与应用安全 / 系统课时
设计 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,也不能直接当作访问令牌发送。
{
"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 应只携带完成请求所需的最小信息,并让过期时间成为安全边界,而不是装饰字段。