JWT 解码器：令牌内包含什么，不包含什么

三个部分

• 标头 — 签名算法 (`alg`) 和令牌类型 (`typ`)，例如 HS256。
• 有效负载 - 声明：令牌是关于谁的、何时发行以及何时过期。
• 签名 - 使用发行者的密钥对前两个段进行计算，这就是解码器显示它但无法检查它的原因。

                eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 . eyJzdWIiOiIxMjMiLCJleHAiOjE3NjAwMDAwMDB9 . signature
           header                            payload                       signature
              

解释大多数失败的主张

• `exp`（过期）— 401 的最常见原因。在检查其他任何内容之前，两分钟前过期的令牌会被拒绝。
• `nbf` (not before) — 镜像：在其有效性窗口被拒绝之前使用的令牌。
• `iat`（发布于）— 对于计算会话的持续时间以及发现不一致的时钟很有用。
• `aud`（受众）和`iss`（发行者）——此处的不匹配意味着令牌有效，但是为不同的服务颁发的，这会以令人困惑的方式失败。

时间声明是自 Unix 纪元以来的 UTC 秒数。如果令牌看起来有效，但过期太早或太晚，请检查时钟问题或在预期为秒的情况下携带毫秒的有效负载。

为什么你永远不应该盲目相信`alg`

两种攻击已经足够古老而著名，并且仍然在野外出现。 `none`算法告诉验证者根本没有签名；读取标头而不是强制执行其自己的预期算法的服务器会接受它。在 RSA/HS 混淆中，攻击者使用公钥作为 HMAC 秘密进行签名，从而欺骗接受这两个系列的服务器。这两种情况的防御都在于验证者，而不是解码器：将预期的算法固定在服务器端，并且永远不会从令牌本身派生它。

始终在本地解码

JWT 是一种凭证：无论谁持有它，都可以充当用户，直到它过期。将真实的内容粘贴到网站中，然后将其发布到服务器，就会将实时会话移交到零，因为解码是任何浏览器都可以在微秒内完成的 base64url 算法。 YamlBox JWT 解码器解析页面中的令牌，将时间戳声明显示为可读的 UTC 日期，并在网络禁用的情况下继续工作 - 这是唯一值得在生产令牌上使用的解码器。

有效的调试例程

1. 首先解码并读取`exp`——一半的“无效令牌”报告到此结束。
2. 根据 API 的预期检查 `aud` 和 `iss`，然后检查 `nbf` 是否存在时钟偏差。
3. 将解码后的声明与代码假设的角色或范围进行比较。
4. 如果声明看起来正确但仍然失败，则问题出在验证上——密钥错误、秘密轮换或算法不匹配。