1. 什么是JWT

JWT（JSON Web Token）是一种开放标准（RFC 7519），用于在各方之间安全地传输信息。它以简洁、自包含的方式将信息作为JSON对象进行传输，并通过数字签名确保信息的完整性和真实性。

JWT广泛应用于：

• 用户身份认证
• API授权
• 分布式系统间的安全通信

2. JWT的结构

JWT由三部分组成，用点（.）分隔：

1

Header.Payload.Signature

2.1 实际JWT示例

下面是一个真实的JWT示例：

1

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyLCJleHAiOjE1MTYyNDI2MjJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

2.2 Header（头部）

头部包含令牌类型和使用的加密算法信息：

1
2
3
4

{
  "alg": "HS256",
  "typ": "JWT"
}

• alg：指定签名算法，如HS256、RS256等
• typ：令牌类型，通常为”JWT”

头部经过Base64Url编码后形成JWT的第一部分：eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9

2.3 Payload（负载）

负载包含声明（Claims），即要传输的信息：

1
2
3
4
5
6

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

声明分为三种类型：

• 注册声明：预定义的声明，如iss（签发者）、exp（过期时间）、sub（主题）、iat（签发时间）等
• 公共声明：自定义声明，应避免与注册声明冲突
• 私有声明：各方约定的自定义声明

负载同样经过Base64Url编码后形成JWT的第二部分：eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyLCJleHAiOjE1MTYyNDI2MjJ9

2.4 Signature（签名）

签名用于验证令牌的完整性和真实性。生成方式取决于使用的算法：

对于HS256算法：

1
2
3
4

HMACSHA256(
  base64UrlEncode(header) + "." + base64UrlEncode(payload),
  "your-256-bit-secret"
)

签名结果经过Base64Url编码后形成JWT的第三部分：SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

注意：你可以使用JWT.io调试器来解码、验证和生成JWT令牌。

3. JWT的工作流程

1. 用户使用凭据（如用户名密码）登录
2. 服务器验证凭据有效性
3. 验证通过后，服务器生成JWT令牌并发送给客户端
4. 客户端将JWT存储在本地（如localStorage或Cookie）
5. 客户端在后续请求中通过HTTP头（通常是Authorization: Bearer <token>）发送JWT
6. 服务器验证JWT的签名和有效性
7. 验证通过后，服务器处理请求并返回响应

4. JWT加密算法详解

JWT支持多种加密算法，主要分为两大类：对称加密算法和非对称加密算法。

4.1 对称加密算法

HS256 (HMAC-SHA256)

HS256是最常用的JWT签名算法，属于对称加密算法：

• 工作原理：使用同一个密钥进行签名和验证
• 优点：
  • 实现简单，性能高效
  • 计算速度快，适合高并发场景
• 缺点：
  • 密钥必须在所有使用方之间共享
  • 密钥泄露风险高，任何一方泄露密钥都会导致整个系统不安全

HS384 和 HS512

与HS256类似，只是使用更长的哈希长度（384位和512位），提供更高的安全性，但性能略有下降。

4.2 非对称加密算法

RS256 (RSA-SHA256)

RS256是基于RSA算法的非对称加密算法：

• 工作原理：
  • 使用私钥进行签名
  • 使用公钥进行验证
• 优点：
  • 更高的安全性，私钥只需要在服务器端保存
  • 公钥可以安全地分发给客户端或其他服务
  • 支持密钥轮换，提高系统安全性
• 缺点：
  • 计算复杂度高，性能比HS256低
  • 密钥管理相对复杂

RS384 和 RS512

与RS256类似，使用更长的哈希长度，提供更高的安全性。

ES256 (ECDSA-SHA256)

ES256是基于椭圆曲线加密（ECC）的非对称算法：

• 工作原理：使用椭圆曲线密钥对进行签名和验证
• 优点：
  • 相同安全性下，密钥长度比RSA短（256位ECC密钥相当于3072位RSA密钥）
  • 计算效率比RSA高
• 缺点：
  • 椭圆曲线算法的实现较为复杂
  • 某些旧系统可能不支持

ED25519

ED25519是基于Curve25519椭圆曲线的现代签名算法：

• 优点：
  • 极高的安全性
  • 高性能
  • 密钥生成简单
• 缺点：
  • 支持度相对较低

5. 算法选择建议

根据不同场景选择合适的算法：

6. JWT安全最佳实践

1. 使用安全的签名算法：避免使用HS256以外的对称算法，优先考虑非对称算法
2. 保护密钥安全：
   • 对称算法密钥必须严格保密
   • 非对称算法私钥必须安全存储，公钥可以公开
3. 设置合理的过期时间：
   • 访问令牌（Access Token）过期时间不宜过长（如15-30分钟）
   • 使用刷新令牌（Refresh Token）获取新的访问令牌
4. 使用HTTPS传输：确保JWT在传输过程中不被窃取
5. 避免在Payload中存储敏感信息：Payload默认是Base64Url编码，不是加密，敏感信息应加密后存储
6. 实现令牌撤销机制：如使用黑名单或状态管理处理令牌撤销场景
7. 定期轮换密钥：提高系统安全性

7. JWT代码示例

7.1 Node.js示例（使用jsonwebtoken库）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

// 安装依赖：npm install jsonwebtoken
const jwt = require('jsonwebtoken');

// 生成JWT令牌
const secretKey = 'your-256-bit-secret';
const payload = {
  sub: '1234567890',
  name: 'John Doe',
  admin: true
};

const token = jwt.sign(payload, secretKey, { expiresIn: '1h' });
console.log('生成的JWT令牌:', token);

// 验证JWT令牌
try {
  const decoded = jwt.verify(token, secretKey);
  console.log('验证结果:', decoded);
  // 可以在这里进行权限检查等操作
  if (decoded.admin) {
    console.log('用户具有管理员权限');
  }
} catch (error) {
  console.error('令牌验证失败:', error.message);
}

7.2 Python示例（使用PyJWT库）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 安装依赖：pip install pyjwt
import jwt
import datetime

# 生成JWT令牌
secret_key = 'your-256-bit-secret'
payload = {
    'sub': '1234567890',
    'name': 'John Doe',
    'admin': True,
    'iat': datetime.datetime.utcnow(),
    'exp': datetime.datetime.utcnow() + datetime.timedelta(hours=1)
}

# 使用HS256算法
token = jwt.encode(payload, secret_key, algorithm='HS256')
print('生成的JWT令牌:', token)

# 使用RS256算法（需要密钥对）
# import rsa
# private_key = rsa.generate_private_key(public_exponent=65537, key_size=2048)
# token = jwt.encode(payload, private_key, algorithm='RS256')

# 验证JWT令牌
try:
    decoded = jwt.decode(token, secret_key, algorithms=['HS256'])
    print('验证结果:', decoded)
    if decoded['admin']:
        print('用户具有管理员权限')
except jwt.ExpiredSignatureError:
    print('令牌已过期')
except jwt.InvalidTokenError:
    print('无效的令牌')

7.3 前端使用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

// 登录后保存令牌到localStorage
function login() {
  // 假设从服务器获取到了令牌
  const token = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
  localStorage.setItem('token', token);
}

// 发送请求时携带令牌
async function fetchProtectedResource() {
  const token = localStorage.getItem('token');
  try {
    const response = await fetch('https://api.example.com/protected', {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    });
    const data = await response.json();
    console.log('受保护资源:', data);
  } catch (error) {
    console.error('请求失败:', error);
  }
}

8. JWT应用场景示例

8.1 单页应用（SPA）认证

1. 用户通过用户名密码登录
2. 服务器验证成功后返回JWT令牌
3. 前端将令牌存储在localStorage中
4. 每次请求API时，在Authorization头中携带令牌
5. 服务器验证令牌有效性，决定是否响应请求

8.2 微服务架构中的授权

1. API网关接收用户请求
2. 网关验证JWT令牌的有效性
3. 验证通过后，将请求转发到相应的微服务
4. 微服务可以直接使用JWT中的信息，无需再次查询数据库
5. 不同微服务可以共享相同的JWT验证逻辑

8.3 移动应用认证

1. 用户在移动应用中登录
2. 服务器返回JWT令牌和刷新令牌
3. 应用将令牌存储在安全的位置（如Keychain/iOS或Keystore/Android）
4. 每次API请求携带JWT令牌
5. 令牌过期时，使用刷新令牌获取新的访问令牌

9. JWT与传统Session的对比

10. 总结

JWT是一种灵活、高效的认证和授权机制，通过选择合适的加密算法和遵循安全最佳实践，可以构建安全可靠的身份验证系统。在实际应用中，应根据系统架构、安全需求和性能要求选择合适的JWT实现方案。

参考资料

• JWT官方规范
• 从安全到性能:HS256与RS256在tymon/jwt-auth中的终极抉择
• JWT 签名算法的选择:HS256、RS256、ES256 和 ED25519 的对比与应用
• JSON Web Token (JWT) 完整指南