按照 JWS 紧凑序列化规范(RFC 7515 第 3.1 节)生成符合标准的 JWT,本质上是将 JOSE 头部、JSON 声明集合与对称密钥转换为格式如 <header>.<payload>.<signature> 的三段式字符串。
1. 构造 JOSE 头部与 API 声明载荷
首先准备一个 HS256 受保护头部,以及一个结合了 RFC 7519 注册声明(iss、sub、aud、iat、exp)与自定义应用声明(role)的 JSON 载荷:
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
此处 1767225600 代表 2026-01-01T00:00:00Z,而 1767229200 代表 2026-01-01T01:00:00Z(即令牌有效期为 1 小时)。
2. 构建无填充的 Base64URL 签名输入
将每个 JSON 对象压缩为不含多余空白字符的 UTF-8 字节流,使用 Base64URL(采用 - 和 _ 字符集,并剥离尾部的 = 填充符)进行编码,然后用 ASCII 句号(.)拼接:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. 可复现的 HMAC-SHA256 签名测试向量
Web Crypto 通过 crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) 导入您的密钥字节,并对精确的 <base64url-header>.<base64url-payload> ASCII 字节流进行签名。您可以使用带有 UTF-8 密钥 your-256-bit-secret 的标准 HS256 测试向量,在 OpenSSL、Node.js crypto、Python PyJWT 以及本生成器之间验证确定性的一致结果:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
使用 your-256-bit-secret 对 {"alg":"HS256","typ":"JWT"} 头部及上述载荷进行签名,始终会生成以下完全一致的 147 字符令牌,可直接用于 HTTP Authorization: Bearer <token> 请求头,或在 JWT 解码与查看器 中进行往返验证:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c