采用 JWS 紧凑序列化(Compact Serialization)传输的 RFC 7519 JSON Web Token 由三个通过句点连接的无填充 Base64URL 字符串组成:<header>.<payload>.<signature>。如果您直接复制了类似 Authorization: Bearer <token> 的 HTTP 请求头,解码器会在按 . 拆分之前自动剥离前导的 Bearer 方案前缀。
以下面这个标准的 HS256 签名紧凑型令牌为例:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
1. 解码后的 JOSE 受保护头部
对第一个分段(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9)进行 Base64URL 解码,可得到 27 个描述加密算法和媒体类型的 UTF-8 字节:
{
"alg": "HS256",
"typ": "JWT"
}
2. 解码后的声明载荷与 NumericDate 时间戳
对第二个分段(eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)进行 Base64URL 解码,即可展示 JSON 声明集(Claims Set):
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
此处的 iat(1516239022)对应 UTC 时间 2018-01-18T01:30:22Z。在检查包含完整生命周期边界的生产环境访问令牌时,查看器会将每个 NumericDate 声明与您当前的系统时钟进行比对:
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"iat": 1735689600,
"nbf": 1735689600,
"exp": 1735693200
}
iat(1735689600):签发时间2025-01-01T00:00:00Z。nbf(1735689600):生效时间(在此之前无效)2025-01-01T00:00:00Z。exp(1735693200):过期时间2025-01-01T01:00:00Z(精确的 3,600 秒 TTL)。
3. 本地 HMAC-SHA256 签名验证
解码仅能证明前两个分段是合法的 Base64URL 编码 JSON,但不能证明声明内容未被篡改。当您为上述第一个示例提供共享密钥 your-256-bit-secret 时,验证器会将完全一致的 ASCII 签名输入(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)和 43 个字符的 Base64URL 签名(SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c)传递给 crypto.subtle.verify("HMAC", key, signatureBytes, signingInputBytes)。对解码后的 JSON 载荷进行哪怕单个比特的修改,都会改变预期的 32 字节 MAC 标签,并立即触发签名不匹配警告。