代码

JWT 解析指南:读取声明、检查时间并理解未验证的结果

·

JWT 解析会在浏览器中打开三部分紧凑令牌的可读头部和载荷。粘贴公开示例或自行构造的测试令牌,选择“解码令牌”,查看格式化的 JSON、令牌声称的算法、签名是否存在及数值时间字段。只有主动选择“复制载荷”时,才会复制显示的载荷。

读取令牌只能说明其中的文本内容。本工具不验证签名、不解密五部分令牌,也不判断应用是否应信任这些声明。时间标签使用设备时钟;编辑输入后,旧结果会保留到下一次解码。排查身份认证时,应理解这些边界。

JWT 解析

从公开示例开始,主动执行解码

工作区初始为空。输入为空或只有空白时,“解码令牌”不可用。“试用示例”会填入并解码提供的公开样本,显示其 HS256 头部、John Doe 载荷和 iat 值。该样本用于演示,不应作为部署到账户中的凭证。

使用自己的受控测试数据时,粘贴完整紧凑令牌并选择“解码令牌”。先阅读结果上方的警告,再查看“头部”和“载荷”。两处输出均为只读,并从左到右显示,包括从右到左的页面。每次编辑输入不会自动解码。

  • 使用提供的公开样本,或构造不含私密声明的合成数据。
  • 粘贴令牌,选择“解码令牌”,确认显示的载荷对应预期输入。
  • 用结果调查结构和时间问题,在接收令牌的应用中执行身份认证检查。

三部分是此解码器支持的输入结构

此解码器要求 header.payload.signature,其中恰好有两个点。它会去掉首尾空白,并移除开头一个不区分大小写、后接空白的 Bearer 前缀。它不会解析完整的 Authorization: 请求头行,也不会移除任意标签、引号或内部空格。应保持编码后的令牌完整。

头部和载荷解码后都必须是 JSON 对象。第三部分可以为空。五部分紧凑输入会收到不支持该形式的提示;仅有五部分并不能证明字符串是有效的加密令牌。JWT 标准涵盖 JWS 和 JWE 表示,而此工作区只实现较窄的可读三部分检查流程。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式IETF RFC 7515:JWS 序列化、Base64URL 与验证IETF RFC 7516:五部分 JWE 紧凑序列化

Base64URL、UTF-8 和 JSON 分别检查

头部和载荷只接受无填充的 Base64URL 字符集:字母、数字、- 和 _。末尾的 = 或其他字符会被拒绝;编码长度除以 4 的余数为 1 时也会被拒绝。解码后的字节必须是有效的 UTF-8,文本必须是有效的 JSON。通过编码检查仍不代表令牌经过身份认证。

每个解码后的 JSON 值都必须是对象,不能是数组、null、字符串或数字。通用 JWS 可以包含其他类型的载荷,本页面不支持所有此类形式。严格的 UTF-8 解码检查的是字节,并不保证每个 JSON 字符串转义都是 Unicode 标量值:例如 ASCII JSON 转义 \ud800 仍可能被解析,并以转义形式显示。

IETF RFC 7515:JWS 序列化、Base64URL 与验证MDN:TextDecoder.decode 与严格解码错误MDN:JSON.parse 与数字精度

算法和签名存在状态都是不可信信息

“算法”显示头部 alg 的字符串值;值缺失、为空或不是字符串时显示“未声明”。显示的 HS256、RS256 或 none 都只是令牌自己的声明。此解码器没有密钥输入、算法允许列表、签发者与密钥关联、密码学验证或关键头部策略检查。

“存在,未验证”只表示第三部分非空且使用允许的字符集。该部分不会被解码、验证长度,也不会结合密钥与签名输入进行检查。即使只有一个字符,也可能显示为存在。“无”表示第三部分为空,不表示应用应该接受无安全保护的令牌。

IETF RFC 7515:JWS 序列化、Base64URL 与验证IETF RFC 8725:JWT 算法、签发者与受众检查

空签名和加密形式需要结合语境理解

RFC 7519 描述的无安全保护 JWT 使用值为 none 的 alg 和空签名。此解码器接受空第三部分,与声明的算法无关。它不会检查这种组合是否符合标准或适合某个应用。因此,可读结果不能证明令牌类型可以被接受。

JWE 紧凑序列化有五个部分。此工作区拒绝该输入结构,没有解密密钥或解密操作。它也不处理 JWS JSON 序列化、分离载荷流程或嵌套令牌验证。它始终以 Base64URL 解码载荷;b64:false JWS 扩展不在此流程内,JWT 配置规范也禁止该扩展。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式IETF RFC 7516:五部分 JWE 紧凑序列化IETF RFC 7797:JWS 未编码载荷选项与 JWT 限制

格式化 JSON 是便于阅读的视图

格式化器添加缩进,同时保留显示文本中的数字字面量和重复字段名。例如 1e3 仍显示为 1e3,不会被改写为 1000。这有助于检查原文写法,但格式化 JSON 不是原始的编码签名输入,不应在验证流程中替代原始输入。

提取的信息来自 JavaScript JSON 解析,它将数字转换为 Number 值,并采用重复名称的最后一次出现。若载荷先有 "exp": 0,后有 "exp": 1e100,视图会显示两个字段,但时间诊断使用后者的解析值。即使可见字面量保持精确,解析出的较大数字也可能损失精度。此工作区不显示格式化器警告。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式IETF RFC 7515:JWS 序列化、Base64URL 与验证MDN:JSON.parse 与数字精度

时间行使用有限的秒数值

JWT NumericDate 使用自 Unix 纪元起的秒数,定义允许小数。此工具按顺序提取有限的数值 iat、nbf 和 exp,乘以 1000 后显示日期。像 "1516239022" 这样的数字字符串不会生成时间行;解析为非有限数的值也不会生成时间行,但原文仍保留在载荷中。

不要把毫秒时间戳放入应用要求使用秒的声明。约 1516239022000 秒和 1516239022 秒代表差异很大的日期。解码器不会根据数字长度推断其他单位、改写声明或检查应用的特定要求。

时间行使用有限的秒数值
声明标准含义此工作区的显示
iat签发时间有限数值对应的本地日期;不提供令牌年龄策略标签。
nbf生效时间本地日期;值大于设备时钟时显示“尚未生效”。
exp过期时间本地日期;早于或等于设备时钟时显示“已过期”,否则显示“尚未过期”。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式MDN:JSON.parse 与数字精度

本地日期与时钟标签有实际边界

显示的日期采用页面语言和浏览器时区。同一数值声明在不同设备上可能显示不同。“已过期”和“尚未生效”与当前设备时钟比较,不考虑时钟偏差容限、签名验证或签发者及受众策略。没有持续更新的倒计时;再次渲染时可能重新评估标签。

有限数值仍可能超过浏览器支持的 Date 范围,包括秒数乘以 1000 后溢出的情况。工具会保留可读的格式化载荷,并在该行显示“时间值超出支持的日期范围。”,不显示时间状态标签。日期格式化诊断描述的是显示边界,不是对令牌有效性的可信判断。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式MDN:JavaScript Date 表示与支持范围MDN:Intl.DateTimeFormat 语言区域与默认时区

将解码作为诊断中的一个步骤

令牌即使可读,也可能被伪造、篡改、面向其他受众、来自意外的签发方,或被应用策略拒绝。iss、aud 和 sub 等声明会显示在载荷中,但这里不检查它们。工作区也不会获取头部指定的密钥或验证 typ 值。

接收令牌的应用应执行符合其令牌配置规范的检查,包括允许的算法、使用可信密钥的密码学验证,以及相关的签发者、受众和时间规则。应将应用的实际检查结果与解码文本比较。不要把成功解析、声明的算法或“尚未过期”当成授权决定。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式IETF RFC 8725:JWT 算法、签发者与受众检查

编辑后的输入可能与显示结果不同

编辑“令牌”会清除提示,但旧的解码结果或错误会保留,直到再次选择“解码令牌”。若粘贴第二个令牌后立即选择“复制载荷”,复制的仍是之前显示的载荷。复制或下结论前,应确认可见结果对应打算解码的输入。

解码在加载格式化器时异步运行。多个解码操作重叠时,只有最后一次操作可以交付结果或错误。可用的“清空”也会使待交付内容失效,避免旧解码恢复已清空的载荷。这种交付保护不会停止全部运算或安全擦除内存;仅编辑输入也不算新的解码操作。

清空在可用时重置工作区

“清空”会移除输入、显示的结果和错误,并显示“令牌已清空”。输入非空或存在结果时,该按钮可用。如果收到错误后手动删空输入,仅有保留的错误不会让“清空”可用。可选择“试用示例”,或输入新的非空测试数据并解码,以替换该错误。

重新加载页面后工作区为空。“清空”和重新加载都不会删除此前复制到系统剪贴板或其他应用的文本。移除可见状态不等于安全擦除浏览器内存、撤销凭证或删除其他位置的副本。

本地解码与主动复制具有不同边界

解码操作在浏览器中读取令牌,不发送包含令牌的请求,也不持久保存令牌库。正常的页面托管、分析统计和代码加载与此操作是不同事项。历史用语“JWT 在线解析”表示可使用的浏览器页面,并不表示此解码器会将令牌上传到验证服务。

真实令牌即使过期,也可能包含凭证和私密声明。可读的 Base64URL 是编码,不是加密;过期字段不会删除载荷。演示和共享排查应优先使用公开样本或合成测试数据。不要把私密令牌放入截图、问题报告或复制的示例中。

IETF RFC 7519:JWT 声明、NumericDate 与无安全保护形式IETF RFC 8725:JWT 算法、签发者与受众检查

复制载荷会复制格式化的可见载荷

“复制载荷”会将完整、格式化的显示载荷写入系统剪贴板,成功后显示“载荷已复制”。它不会复制原始紧凑令牌或头部。目标应用会得到一个独立副本;应检查粘贴位置及其中包含的声明。

Clipboard API 写入失败时,工作区会显示剪贴板不可用并提示选择载荷进行复制。可以手动选中只读输出。本页面没有下载、令牌导出、保存历史或向其他工具自动传送功能。复制提示不会验证签名,也不会在之后删除已有剪贴板数据。

MDN:Clipboard.writeText 与写入失败

输入长度与 JSON 嵌套分别受限

“令牌”字段将用户输入限制为 100000 个 UTF-16 代码单元。这是工作区控件限制,不是 JWT 标准的最大值、网络请求头额度,也不保证每个接收服务都接受这样的令牌。Base64URL 令牌文本通常是 ASCII,但粘贴的外围文本仍受该字段计量单位约束。

JSON 格式化器支持的最大嵌套深度为 256。更深的头部或载荷 JSON 可能通过解析,却在格式化时报深度错误。此工具没有文件上传、流式处理、批量解码或可配置的深度限制。应缩短合成测试数据或使用适合所需输入的流程,不要把每次失败都归因于签名错误。

MDN:maxlength 与 UTF-16 代码单元输入限制

按错误指明的层次排查

先数清部分数量,再检查提示的头部、载荷或签名错误。Base64URL、UTF-8、JSON 语法和 JSON 对象结构错误对应不同阶段。成功解析会清除旧错误;解码失败会移除旧结果并显示当前错误。

应用拒绝令牌与解码器报错是不同问题。在应用的受控环境中保持原始令牌完整,通过其验证日志和策略排查。本页面无法判断密钥、受众、签发者、撤销规则或授权策略是否正确。

按错误指明的层次排查
现象检查项下一步
部分数量不符紧凑结构与粘贴的包装文本使用完整三部分测试数据;不支持五部分紧凑 JWE。
Base64URL 或 UTF-8 错误报告出错的编码部分检查无填充字符集、完整字节及意外空白。
JSON、对象或深度错误解码内容与嵌套两个可读部分都应是 JSON 对象,并在格式化器限制内。
可读令牌被应用拒绝实际验证器与应用策略在应用中检查可信密钥、算法、签发者、受众及相关时间规则。

IETF RFC 7515:JWS 序列化、Base64URL 与验证IETF RFC 8725:JWT 算法、签发者与受众检查MDN:TextDecoder.decode 与严格解码错误

选择正确字符集和字节解释方式后,Base64 编码解码工具可以帮助检查单独的部分。JWT 工作区已经执行自身的 Base64URL 和 UTF-8 检查。在其他工具中解码一个部分,并不会验证其签名或证明整个令牌可以被接受。

JSON 格式化工具可独立检查公开或合成的 JSON 对象;时间戳转换工具可帮助比较单位和日期表示。这些是独立流程,本页面不会自动传递令牌或声明。共享示例中应排除私密凭证,并在接收应用中验证身份认证。

常见问题

此工具会验证 JWT 签名吗?

不会。它读取头部和载荷,报告声明的算法及第三部分是否非空。没有密钥输入、密码学验证或应用是否接受令牌的决定。

“存在,未验证”是否表示存在有效签名?

只表示非空第三部分的文本使用允许的字符集。不会解码该部分,也不会检查密码学有效性、长度或与声明算法的一致性。

没有签名的令牌能解码吗?

头部和载荷通过可读对象检查时,允许第三部分为空。RFC 7519 的无安全保护形式使用值为 none 的 alg,但此解码器不强制这种组合,也不判断应用能否接受它。

为什么五部分令牌被拒绝?

五部分紧凑输入符合 JWE 的形式,而此工作区不支持该形式。它没有解密操作或密钥输入;仅凭部分数量不能确定输入是有效的加密数据。

能粘贴 Bearer 令牌吗?

可以。去掉首尾空白后,会移除开头一个不区分大小写、后接空白的 Bearer 前缀。完整的 Authorization: 行或其他包装文本不会按 HTTP 请求头解析。

exp、nbf 和 iat 是秒还是毫秒?

JWT NumericDate 是自 Unix 纪元起的秒数,允许小数。工具使用有限数值,乘以 1000 后在浏览器中显示日期;不会推断单位或把数字字符串转换为时间行。

看起来是数字的时间声明为什么没有时间行?

带引号的数字是字符串,解析为非有限数的数字也不会加入时间信息。原始载荷文本仍可见。超出支持的 Date 范围的有限数值会生成诊断行,不显示时间状态标签。

“尚未过期”是否表示令牌已被接受?

不是。该标签只将解析值与当前设备时钟比较。没有自动倒计时、签名验证、时钟偏差策略、签发者或受众验证,也不作授权决定。

为什么显示重复声明,却只使用一个时间?

阅读视图保留重复字段。JavaScript JSON 解析在提取信息时采用最后一次出现,因此时间显示使用该值。接收应用应执行自己认可的解析和令牌验证规则。

为什么编辑输入后仍显示旧结果或错误?

编辑与“解码令牌”是独立操作。旧结果或错误保留到下一次解码。“复制载荷”针对显示的结果,而它可能与刚编辑的输入不同。

解码过程中点击清空会怎样?

可用的“清空”会清空工作区,并使待交付的解码内容失效。更早的结果或错误不能通过该解码流程返回。这不会取消每项运算、清除剪贴板或安全擦除浏览器内存。

过期令牌可以安全分享吗?

过期不会加密或删除私密声明,令牌仍可能敏感。演示和共享错误报告应使用提供的公开样本或合成数据。

复制载荷会复制什么?

复制完整的格式化可见载荷,不含头部或原始紧凑令牌。剪贴板写入可能失败,此时工作区提示手动选择。“清空”不会删除工作区外的副本。

输入可以多大、嵌套多深?

用户输入限于 100000 个 UTF-16 代码单元,JSON 格式化支持最大 256 层嵌套。这是工作区限制,不是通用 JWT、HTTP 或接收应用限制。没有批量处理或文件上传界面。

来源与延伸阅读

动手试试。

相关指南