4. JWT 生成与签发流程：服务端生成 Token 的完整步骤、密钥管理、过期时间设置

JWT 的生成与签发是分布式鉴权的核心环节。服务端在用户身份验证通过后，需要按照标准流程构造 JWT 载荷、选择签名算法、管理密钥并设置合理的过期时间。本章将拆解这一完整链路，并深入分析密钥管理与过期策略对系统性能和安全性的影响。

4.1 服务端生成 Token 的完整步骤

JWT 的生成过程可归纳为以下 6 个核心步骤，每一步都直接影响 Token 的安全性与解析效率：

1. 构造 Header（头部）：声明 Token 类型（typ: JWT）和签名算法（alg），如 HS256 或 RS256。
2. 构造 Payload（载荷）：包含注册声明（iss、sub、exp、iat 等）、公共声明和私有声明（如用户 ID、角色）。
3. 序列化 Header 与 Payload：分别对 JSON 对象进行 Base64URL 编码，得到 header 和 payload 字符串。
4. 生成签名（Signature）：使用指定算法和密钥对 header.payload 进行签名，输出签名值。
5. 拼接完整 Token：将 header.payload.signature 以点号（.）连接，形成最终 JWT 字符串。
6. 返回给客户端：通常放在 HTTP 响应头 Authorization: Bearer <token> 或响应体中返回。

4.2 密钥管理策略

密钥是 JWT 签名的安全基石。不同的签名算法对应不同的密钥管理模型，直接影响系统的安全边界和运维复杂度。

4.2.1 密钥轮换（Key Rotation）

定期更换密钥是降低泄露风险的关键手段。推荐使用 JWKS（JSON Web Key Set） 端点动态发布公钥，服务端在验证 Token 时根据 kid（Key ID）自动匹配当前有效的公钥。

// JWKS 端点返回示例（简化）
{
  "keys": [
    {
      "kty": "RSA",
      "kid": "key-2025-01",
      "n": "0vx7ago...",
      "e": "AQAB",
      "alg": "RS256"
    },
    {
      "kty": "RSA",
      "kid": "key-2024-12",
      "n": "1wz5fbc...",
      "e": "AQAB",
      "alg": "RS256"
    }
  ]
}

4.3 过期时间设置

exp（Expiration Time）是 JWT 中最重要的注册声明之一，它定义了 Token 的有效截止时间。过期时间的设置需要在安全性与用户体验之间取得平衡。

4.3.1 过期时间对性能的影响

较短的过期时间意味着客户端需要更频繁地刷新 Token，增加服务端签发请求的负载；较长的过期时间则增加了 Token 泄露后的风险窗口。下表展示了不同过期策略的性能与安全权衡：

4.3.2 配合 Refresh Token 的过期模型

为平衡安全与体验，业界普遍采用 Access Token + Refresh Token 双 Token 模型：

• Access Token：短期有效（如 15 分钟），用于访问受保护资源，不存储敏感信息。
• Refresh Token：长期有效（如 7 天），仅用于获取新的 Access Token，存储在服务端或安全存储中。

4.4 JWT 生成与签发流程总览

下图展示了从用户登录到 JWT 签发的完整流程，以及密钥管理与过期时间在其中的作用位置：

4.5 生成签名的代码示例

以下代码展示了使用 Node.js 的 jsonwebtoken 库生成 RS256 签名的完整过程，包含密钥加载、过期时间设置和 Token 签发：

const jwt = require('jsonwebtoken');
const fs = require('fs');

// 1. 加载私钥（非对称算法）
const privateKey = fs.readFileSync('./keys/private.pem', 'utf8');

// 2. 构造 Payload，设置过期时间
const payload = {
  sub: 'user_12345',
  name: '张三',
  role: 'admin',
  iat: Math.floor(Date.now() / 1000),          // 签发时间
  exp: Math.floor(Date.now() / 1000) + 900     // 过期时间：15 分钟后
};

// 3. 生成签名并签发 Token
const token = jwt.sign(payload, privateKey, {
  algorithm: 'RS256',
  keyid: 'key-2025-01'   // 用于 JWKS 公钥匹配
});

console.log('生成的 JWT:', token);