piapia123
zh

JWT 解析与验签(HS256 / HS384 / HS512)

编码

所有处理都在浏览器本地完成,数据不上传服务器

输入
把文件拖到这里可直接载入
输出

把 JWT 拆成 header、payload、signature 三段分别格式化,并把 iat / nbf / exp 这几个时间声明换算成可读时间、标出是否已过期。本工具还能用你提供的密钥验证 HS256 / HS384 / HS512 签名 —— 密钥对了、签名对得上,才说明「用这个密钥签发的内容没被改过」。 ⚠️ 三件事必须说在前面:一是密钥绝不能是生产密钥。本站确实全在本地算、不上传任何东西,但「把生产密钥粘进一个网页」这个习惯本身就是错的,请用测试密钥。二是 `alg` 为 `none` 的令牌,在提供了密钥时必须判为无效 —— 这是 JWT 最经典的漏洞。三是验签通过不代表令牌仍然有效 —— 还要看 exp / nbf / aud / iss,工具会把 exp 是否过期、nbf 是否生效单独给出来。 不提供密钥时只解析,输出里的 signatureVerification 会如实写着 not-performed。payload 是明文(Base64URL 只是编码,不是加密),不要放密码等敏感信息。

功能

  • ⚠️ 密钥绝不能是生产密钥 —— 请用测试密钥(本站全在本地算、不上传,但粘生产密钥这个习惯本身就是错的)
  • 用密钥验证 HS256 / HS384 / HS512 签名,恒定时间比较(不在第一个不同字节就返回)
  • ⚠️ `alg` 为 `none` 的令牌,在提供了密钥时必须判为无效(JWT 最经典的漏洞)
  • ⚠️ 验签通过只说明内容没被改过,不代表令牌仍然有效 —— exp / nbf 单独给出,aud / iss 仍需你自己核对
  • 不提供密钥时只解析,输出里明确标注未验签
  • 密钥可选 UTF-8 文本或 Base64(许多密钥是一串导出的 Base64)
  • 拆出并格式化显示 header、payload、signature 三段
  • iat / nbf / exp 换算成 ISO 可读时间,并给出是否已过期 / 尚未生效
  • 容忍缺 padding 的 Base64URL,也认 Authorization 头里的 Bearer 前缀与折行
  • 段数不对时说明差在哪 —— 5 段会指出那是加密的 JWE 令牌而不是 JWT
  • 令牌体积,以及它会不会被常见的服务器拒掉:nginx 单行 8 KB、Apache 8190、IIS 16384、Node 16 KB、Go 1 MB

使用方法

  1. 把令牌粘贴进输入框(带不带 Bearer 前缀都可以)
  2. 想验签就把密钥填进「验签密钥」,并选清是 UTF-8 文本还是 Base64;不填则只解析
  3. 结果立刻出现,查看验签结论、三段内容与时间信息
  4. 点「复制」取走结果 —— 验签通过也不等于令牌仍然有效

常见问题

我把密钥粘进来安全吗?
⚠️ 不要用生产密钥。 本工具的所有计算都在你的浏览器里完成,密钥不会被上传到任何服务器(页面加载后断网也照常验)。但问题不在传输,在习惯:把生产密钥粘进一个网页、留在浏览器历史或剪贴板里,本身就是不该做的。请用专门的测试密钥来验证工具行为。
验签通过,是不是说明这个 token 有效?
不是。验签通过只说明「用这个密钥签发的内容没有被改过」。令牌是否仍然有效还要看 exp(是否过期)、nbf(是否已生效)、aud / iss(发给谁、谁签发的)—— exp 与 nbf 工具会单独给出来,aud / iss 需要你自己核对。另外本工具只能验 HS256 / HS384 / HS512 这类对称签名,RS256 / ES256 等非对称签名需要公钥,不在本工具范围内。
alg 写成 none 会怎样?
在提供了密钥时会被判为无效。这是 JWT 最经典的漏洞:攻击者把 header 的 alg 改成 none、删掉签名段,实现如果「看到 none 就跳过验证」就会放行任意伪造的令牌。本工具把「提供了密钥 + alg 为 none」当作验签失败,而不是跳过。
密钥该按文本还是 Base64 填?
HMAC 的密钥是一串字节,而字节可以有多种写法。jwt.io 那种 `your-256-bit-secret` 是直接当作 UTF-8 文本用的,选「UTF-8 文本」。如果你的密钥是别人给的一串 Base64(例如从配置文件或密钥库里导出的二进制密钥),选「Base64」,工具会先解码成原始字节再验 —— 两种选法算出的签名完全不同,选错了就会「不通过」。
payload 是加密的吗?
不是。Base64URL 只是编码,不是加密,任何人拿到令牌都能读出里面的内容(本工具做的就是这件事)。所以令牌里不要放密码、手机号、身份证号这类信息。需要保密请改用 JWE(加密令牌),那种令牌是 5 段,本工具解析不了。
过期时间是按谁的时钟算的?
按你本机的时钟。exp 与当前时间比较得出是否过期,所以本机时间不准,判断也会不准。真正的过期判断永远应该由服务端来做 —— 客户端时间可以随便改。

相关工具