身份认证与应用安全 / 技术文章

JWT 登录如何处理签名、过期与刷新

JWT 登录最容易被误解的地方,不是 Token 怎么传,而是服务端为什么能相信它、什么时候不再相信它,以及过期后如何安全续期。适合正在实现前后端分离登录的开发者,读完可以独立判断签名、过期、刷新和注销应该分别由谁负责。

Token 登录的本质是携带可验证的凭证

传统 Session 登录通常由服务端保存会话状态,客户端只持有一个会话标识。Token 登录则把“我是谁”和部分认证信息放进客户端每次请求携带的凭证中,服务端收到请求后验证凭证,再恢复当前用户身份。

JWT 是 Token 的一种常见实现。一个典型 JWT 由三段组成:

text
Header.Payload.Signature

前两段使用 Base64URL 编码,第三段是签名。Base64URL 只是编码,不是加密,因此任何拿到 JWT 的人通常都能解码 Header 和 Payload。不要把密码、身份证号、银行卡号或其他敏感数据放进 Payload。

常见 Payload 会包含:

json
{
  "sub": "10001",
  "role": "user",
  "iat": 1700000000,
  "exp": 1700003600
}

sub 通常表示主体标识,iat 表示签发时间,exp 表示过期时间。字段可以扩展,但 JWT 越大,每个请求携带的网络开销也越大,因此只放认证和授权真正需要的数据。

签名解决的是篡改,不是保密

服务端签发 JWT 时,会对 Header 和 Payload 组成的数据计算签名。以 HS256 为例,可以简化理解为:

signature = HMAC-SHA256(secret, base64Url(header) + "." + base64Url(payload))

客户端即使把 Payload 中的 role 从 user 改成 admin,也无法在不知道密钥的情况下生成匹配的新签名。服务端重新计算签名后发现不一致,就应该拒绝这个 Token。

下面用 Node.js 内置 crypto 演示一个可运行的最小 HS256 签名和校验过程。示例固定时间戳只是为了让输出稳定,生产环境必须使用真实签发时间和过期时间。

js
const crypto = require('node:crypto');

function base64Url(input) {
  return Buffer.from(input)
    .toString('base64')
    .replace(/=/g, '')
    .replace(/\+/g, '-')
    .replace(/\//g, '_');
}

const header = { alg: 'HS256', typ: 'JWT' };
const payload = {
  sub: '10001',
  role: 'user',
  iat: 1700000000,
  exp: 1700003600
};

const secret = 'anystack-demo-secret';
const encodedHeader = base64Url(JSON.stringify(header));
const encodedPayload = base64Url(JSON.stringify(payload));
const signingInput = `${encodedHeader}.${encodedPayload}`;

// 服务端使用同一密钥计算签名
const signature = crypto
  .createHmac('sha256', secret)
  .update(signingInput)
  .digest('base64url');

const token = `${signingInput}.${signature}`;

// 收到 Token 后重新计算签名并比较
const expected = crypto
  .createHmac('sha256', secret)
  .update(signingInput)
  .digest('base64url');

console.log(token);
console.log('signature valid:', signature === expected);

预期输出:

text
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMDAwMSIsInJvbGUiOiJ1c2VyIiwiaWF0IjoxNzAwMDAwMDAwLCJleHAiOjE3MDAwMDM2MDB9.6o4WbMY2cZR039oU0OB_mi7rgKqhdpIRbT66jv38-9s
signature valid: true

服务端验证 JWT 不只是验签

签名正确只能证明 Token 没有被未授权篡改,并不能说明它当前仍然有效。一个完整的认证流程通常还要检查过期时间、签发方、受众以及业务侧状态。

JWT 从登录签发到刷新续期的完整认证链路

服务端处理一个 JWT 请求时,可以按下面的顺序理解:

  1. 从约定的请求头或 Cookie 中取得 Token。
  2. 检查 Token 格式,并根据允许的算法执行验签。
  3. 检查 exp、nbf、iss、aud 等声明是否符合当前系统规则。
  4. 取得 sub 等身份信息,恢复当前登录用户。
  5. 如果系统存在封禁、注销、权限变更等即时状态,再查询必要的服务端状态。
  6. 认证通过后才进入业务 Controller。

过期时间限制被盗 Token 的有效窗口

JWT 一旦签发,如果服务端完全不保存会话状态,那么在签名有效且 exp 尚未到期的期间,它通常都可以继续使用。这也是为什么 Access Token 不应该设计成永久有效。

过期时间是在“安全”和“体验”之间做权衡。时间越短,被盗后的可利用窗口越小,但客户端需要更频繁续期;时间越长,体验更简单,但泄露后的风险窗口也越长。

实际系统常把 Token 拆成两种:

凭证 主要用途 生命周期 请求频率
Access Token 访问业务接口 较短 高频
Refresh Token 换取新的 Access Token 较长 低频

例如可以把 Access Token 设计为分钟级,把 Refresh Token 设计为天级或更长,但具体时长应根据账号价值、终端可信度、风控能力和重新登录成本确定,而不是机械复制固定数字。

Refresh Token 不是把旧 JWT 延长一下

Access Token 过期后,客户端不应该修改旧 JWT 的 exp,因为任何字段变化都会导致原签名失效。正确做法是向认证服务提交 Refresh Token,由服务端重新完成一次受控签发。

一个更稳妥的刷新流程通常包含:

  1. 客户端发现 Access Token 已过期或即将过期。
  2. 使用 Refresh Token 请求刷新接口。
  3. 服务端验证 Refresh Token 是否有效、是否过期、是否被撤销。
  4. 签发新的 Access Token。
  5. 高安全要求场景同时轮换 Refresh Token,并让旧 Refresh Token 失效。

Refresh Token 可以是 JWT,也可以是服务端生成的随机不可读字符串。对于需要主动注销、设备管理和异常撤销的系统,服务端保存 Refresh Token 的哈希值、版本或会话记录,通常更容易控制生命周期。

注销和权限变更暴露了无状态 JWT 的边界

完全无状态的 JWT 有一个明显特点:服务端签发后,不保存这次登录对应的会话记录。因此用户点击“退出登录”时,客户端删除 Token 很容易,但服务端很难让一个尚未过期、已经泄露出去的 JWT 立即失效。

常见处理方式有三种。第一种是让 Access Token 保持较短生命周期,退出后只删除客户端凭证,接受剩余的短暂有效窗口。第二种是维护 Token 黑名单或撤销记录,在每次请求时额外检查。第三种是引入会话版本、设备会话或集中式认证状态,Token 中只携带引用信息。

权限变化也有类似问题。如果 JWT 内直接保存 role=admin,管理员撤销该角色后,旧 Token 在到期前仍可能保留旧权限。对即时性要求高的权限,不应只依赖长生命周期 JWT 中的静态声明。

因此,“使用 JWT”不等于“服务端绝对无状态”。很多生产系统实际上采用混合方案:Access Token 使用 JWT 减少高频会话查询,Refresh Token、撤销状态和关键权限仍由服务端控制。

设计登录体系时把职责拆开

JWT 最适合解决的是“让服务端验证一份客户端携带的身份声明是否可信”,而不是包办整个登录系统。签名负责防篡改,exp 负责限制时效,Refresh Token 负责续期,服务端状态负责处理注销、封禁、设备管理和需要即时生效的权限变化。

落地时可以坚持几个边界:Payload 不放敏感信息;服务端固定允许的签名算法;Access Token 保持有限生命周期;Refresh Token 单独保护并支持撤销;高风险权限不要只相信长期静态声明。

做到这些之后,Controller 就不需要自己理解 JWT 的细节。认证层统一完成取 Token、验签、过期检查和当前用户恢复,业务代码只消费已经验证过的用户身份,这才是 Token 登录真正可维护的形态。

目录与阅读设置

记录一个想法

JWT 登录如何处理签名、过期与刷新

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

登录哪都通