jc JWT 解析器实战：把 JWT 令牌结构化为 JSON，及其解码实现的源码剖析

开发工具【免费下载链接】jcCLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. This allows piping of output to tools like jq and simplifying automation scripts.项目地址https://gitcode.com/gh_mirrors/jc/jc点击查看免费下载jc 提供jwt解析器CLI 参数--jwt用于将 JWTJSON Web Token字符串直接转换为结构化的 JSON便于jq过滤和自动化脚本消费。阅读本文后你将掌握该解析器的完整使用方式CLI 与 Python 模块、输出 Schema 的逐字段含义以及从 base64url 解码、签名十六进制化到边界行为处理的源码级实现细节能够在调试 API 令牌、审计载荷字段时快速上手并理解其行为边界。文档明确声明jc不会校验 JWT 的完整性不验签。该解析器仅做结构解码任何安全验证签名有效性、exp过期检查等需要由调用方自行完成。快速上手CLI 用法将 JWT 字符串通过管道传给jc --jwt$ echo eyJhbGciOiJIUzI1N... | jc --jwt加上-p参数可获得 pretty-print 的 JSON 输出% echo eyJhbGciOiJIUzI1N... | jc --jwt -p { header: { alg: HS256, typ: JWT }, payload: { sub: 1234567890, name: John Doe, iat: 1516239022 }, signature: 49:f9:4a:c7:04:49:48:c7:8a:28:5d:90:4f:87:f0:a4:c7... }--jwt是 README 解析器参数表中登记的标准参数之一见 README.md。模块用法在 Python 代码中推荐使用 jc 的高层 APIjc.parse()import jc result jc.parse(jwt, jwt_string)jc.parse()是统一分发入口它通过get_parser()按模块名/CLI 名/参数名解析出对应解析模块后调用其parse()方法见 jc/lib.py。因此jc.parse(jwt, ...)等价于直接导入解析模块import jc.parsers.jwt result jc.parsers.jwt.parse(jwt_string)输出 Schema解析结果为一个字典固定包含三个顶层键键类型说明headerobjectJWT 头部解码后的 JSON 对象典型键为algstring算法如HS256与typstring类型通常为JWT实际包含哪些键取决于令牌头部本身payloadobjectJWT 载荷claims解码后的 JSON 对象key name的值可以是 string/integer/float/boolean/nullsignaturestring签名段的字节序列转为冒号分隔的十六进制表示如49:f9:4a:...完整示例测试用例中使用的是一条真实的三段式 HS256 JWT来自 tests/test_jwt.pyeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5cjc.parsers.jwt.parse()的完整输出为见 tests/test_jwt.py 的断言值{ header: {alg: HS256, typ: JWT}, payload: {sub: 1234567890, name: John Doe, iat: 1516239022}, signature: 49:f9:4a:c7:04:49:48:c7:8a:28:5d:90:4f:87:f0:a4:c7:89:7f:7e:8f:3a:4e:b2:25:5f:da:75:0b:2c:c3:97 }可以看到签名段SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c被解码为 32 字节HS256 输出 256 位并以冒号分隔的十六进制呈现每两个十六进制字符对应一个字节。parse() API解析入口函数签名见 jc/parsers/jwt.pydef parse(data: str, raw: bool False, quiet: bool False) - Dict参数说明datastring待解析的 JWT 字符串。解析器会先strip()去除首尾空白再分割因此携带尾部换行的字符串如从文件重定向读取的可以直接传入rawbooleanTrue时返回未经后处理的数据。对本解析器而言后处理函数_process()是直接透传见 jc/parsers/jwt.py所以rawTrue与rawFalse的输出完全一致quietbooleanTrue时抑制警告信息返回值为Dict解析成功时为三段式结构体输入为空时返回{}空字典。源码实现剖析整个解析逻辑集中在 jc/parsers/jwt.py核心流程位于parse()内部jc/parsers/jwt.py平台兼容性检查调用jc.utils.compatibility(__name__, info.compatible, quiet)仅在当前平台属于兼容列表linux、darwin、cygwin、win32、aix、freebsd时继续输入类型检查jc.utils.input_type_check(data)确认输入为字符串空数据判定jc.utils.has_data(data)为假时直接返回{}这是测试用例test_jwt_nodata所验证的行为tests/test_jwt.py三段分割header, payload, signature data.split(.)。这里要求输入恰好由两个.分隔成三段否则 Python 的解包会抛出ValueError——从源码结构看传入非 JWT 格式的数据会以异常形式暴露而不是返回部分结果base64url 解码header 与 payload 使用urlsafe_b64decode(seg )解码后以 UTF-8 转字符串再经json.loads还原为字典签名段只做字节解码不做 UTF-8 转字符串。为什么解码前要追加JWT 规范RFC 7515规定 base64url 编码省略末尾填充。Python 的urlsafe_b64decode对缺少填充的输入会报错因此解析器对每段统一追加见 jc/parsers/jwt.py。无论原段余数为 1 还是 2 个字符都提供足够的填充量对已经是 4 的倍数或已带填充的段Python 的 base64 解码器能够容忍多余的填充字符。这种写法使解析器同时兼容带填充与不带填充的输入。签名的冒号十六进制化与 Python 版本兼容签名段通过私有函数_b2a()jc/parsers/jwt.py转换为冒号分隔的十六进制字符串def _b2a(byte_string: bytes) - str: Convert a byte string to a colon-delimited hex ascii string try: return binascii.hexlify(byte_string, :).decode(utf-8) except TypeError: hex_string binascii.hexlify(byte_string).decode(utf-8) colon_seperated :.join(hex_string[i:i2] for i in range(0, len(hex_string), 2)) return colon_seperatedbinascii.hexlify()的sep分隔符参数是 Python 3.8 才引入的为了兼容 Python 3.6/3.7代码在TypeError时回退为手动按字节切片再拼冒号。冒号分隔的写法让长签名在 JSON/日志中更易逐字节比对也是该 Schema 中signature为 string 而非字节的直接原因。关于不验签的再说明文档与源码均表明parse()只解包不验证。signature字段只是对第三段字节原样呈现不会用header.alg或任何密钥去复核其正确性。因此该解析器适合检视令牌结构查看 claims、确认头部算法、人工比对签名字节而不适合做认证判定的唯一依据。测试覆盖tests/test_jwt.py 包含两个用例共同界定了解析器的行为边界test_jwt_nodata空字符串输入quietTrue应返回{}test_jwt_example完整三段 HS256 JWT 应精确命中上述 JSON 输出包括 32 字节签名的逐字节十六进制值。这两个断言值可以直接作为集成测试的期望基准。解析器信息元数据jc/parsers/jwt.py 的info类version 1.1作者 Kelly Brazilkellyjonbrazilgmail.comdescription JWT string parsertags[standard, string, slurpable]—— 标准非流式解析器输入为字符串而非命令输出且支持--slurp命令行选项将多行/多段输入聚合后解析兼容性linux、darwin、cygwin、win32、aix、freebsd源码位置jc/parsers/jwt.py配套文档docs/parsers/jwt.md。小结jc --jwt以极小的实现体量覆盖了 JWT 检视的常见诉求三段分割 → base64url 解码自动补填充→ JSON 还原 → 签名十六进制化输出稳定的三键 Schema可直接接jq进一步过滤例如取payload.sub。需要牢记的前提是它不验签也不做时间类 claims 的语义检查在自动化流水线中建议把它当作结构化观察工具与独立的签名验证逻辑配合使用。赞分享开发工具【免费下载链接】jcCLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. This allows piping of output to tools like jq and simplifying automation scripts.项目地址https://gitcode.com/gh_mirrors/jc/jc点击查看免费下载相关推荐用 jemalloc mallctl 看进程内存的真相用 jemalloc mallctl 看进程内存的真相 上次 OOM 复盘时heap profile 一片干净RSS 却在六小时内从 4GB 爬到 9GB内存管理amlogic-s9xxx-armbian 移植S905X3 电视盒变 2 瓦 Linux 服务器amlogic s9xxx armbian 移植S905X3 电视盒变 2 瓦 Linux 服务器 这台 S905X3 盒子已连续运行两个多月Docker、嵌入式开发工具构建工具操作系统如何快速掌握tymon/jwt-auth深入解析JWT令牌三部分结构与生成机制如何快速掌握tymon/jwt auth深入解析JWT令牌三部分结构与生成机制 tymon/jwt auth是一款为Laravel和Lumen框架设计的JSO认证鉴权后端安全上一篇GRR服务器架构深度解析如何构建高可用取证平台下一篇HS2游戏补丁安装与问题解决全攻略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考