从Python课设到CTF利器：JWT_GUI工具开发复盘与使用避坑全指南

从Python课设到CTF利器：JWT_GUI工具开发复盘与使用避坑全指南

在CTF竞赛和渗透测试中，JWT（JSON Web Token）的安全问题一直是个高频考点。作为一个原本只是应付Python课程设计的工具，JWT_GUI却意外成为了解决这类问题的利器。本文将带你深入了解这个工具的诞生历程、核心技术实现，以及那些官方文档不会告诉你的"坑点"。

1. 工具诞生：从课设作业到实战利器

2019年春季学期，某高校计算机系的Python课程设计要求学生完成一个GUI应用。当时正好在接触CTF比赛，发现JWT相关题目频繁出现，但现有工具要么命令行操作复杂，要么功能单一。于是，一个结合PyQt5和PyJWT库的图形化工具应运而生。

开发初期的三个核心目标：

• 可视化操作：避免命令行工具的参数记忆负担
• 功能整合：将解密、篡改、爆破等常见操作集中处理
• 离线可用：特别适合内网环境下的CTF比赛

# 基础功能结构示例 class JWTProcessor: def decode(self, token, key=None): # 解码逻辑实现 pass def encode(self, headers, payload, key, algorithm): # 编码逻辑实现 pass def brute_force(self, token, dict_path=None): # 爆破逻辑实现 pass

提示：工具最初仅支持HS256算法，随着CTF题目变化，逐步加入了RS256和None攻击等特性

2. 核心技术实现与那些"奇怪特性"

2.1 PyJWT库的header顺序陷阱

在开发过程中，最令人头疼的问题是PyJWT库对header字段的固定排序。标准规定JWT头部应包含alg和typ字段，但PyJWT内部实现强制将typ放在alg之前：

# PyJWT内部实现片段 default_headers = { 'typ': 'JWT', 'alg': 'HS256' }

这导致工具在处理某些CTF题目时出现兼容性问题，特别是当题目服务端严格校验字段顺序时。临时解决方案是修改PyJWT源码，但这又带来了打包部署的新问题。

2.2 JSON序列化的随机性

另一个隐蔽的坑点是Python的json模块在序列化时的字典键顺序不确定性：

import json # 同样的字典可能输出不同顺序的JSON data1 = json.dumps({'alg': 'HS256', 'typ': 'JWT'}) data2 = json.dumps({'typ': 'JWT', 'alg': 'HS256'})

这在爆破密钥时会造成严重影响，因为JWT的签名验证对header的字节级变化极其敏感。

2.3 None攻击的正确顺序

工具中None攻击的实现有个"特性"：如果先修改payload再执行None攻击，生成的头部会使用单引号而非标准双引号。这源于代码中的字符串处理逻辑：

# 问题代码片段（简化版） def none_attack(payload): headers = "{'alg':'none','typ':'JWT'}" # 错误使用单引号 return base64_encode(headers) + "." + base64_encode(payload)

正确使用顺序：

1. 先执行None攻击生成基础token
2. 解码该token后进行payload修改
3. 最后使用目标算法重新编码

3. 打包部署的实战经验

将Python脚本打包成独立exe时，PyInstaller虽然方便，但也带来了几个特定问题：

常见打包问题与解决方案：

# 推荐打包命令 pyinstaller --onefile --add-data "password.txt;." --hidden-import=PyQt5.sip jwt_gui.py

注意：打包前务必测试所有功能，特别是那些依赖外部文件的特性

4. CTF实战中的高频应用场景

4.1 基础篡改流程

1. 获取目标JWT令牌
2. 使用工具解码查看内容
3. 修改关键字段（如user→admin）
4. 选择合适的算法重新编码
5. 替换原请求中的token

4.2 密钥爆破实战技巧

工具提供三种爆破模式：

• 纯数字爆破：适用于短密钥（≤5位）
• 字典爆破：使用内置password.txt
• 自定义字典：支持用户指定字典文件

性能对比数据：

4.3 RS256算法处理

当遇到使用非对称加密的JWT时：

1. 获取目标公钥/私钥
2. 在工具中选择RS256算法
3. 加载密钥文件
4. 执行标准篡改流程

# RS256处理示例 from Crypto.PublicKey import RSA key = RSA.import_key(open('private.pem').read()) encoded = jwt.encode(payload, key, algorithm='RS256')

5. 那些年踩过的坑：用户常见问题解析

5.1 格式校验失败

典型报错：Invalid token format

• 检查是否完整包含两个点分隔的三个部分
• 确认base64编码正确（可能需要补全padding）

5.2 爆破无结果

可能原因：

1. header字段顺序与服务端不一致
2. 字典质量不足
3. 密钥长度超出工具处理能力

解决方案：

• 尝试修改PyJWT源码中的header顺序
• 使用更专业的字典（如rockyou.txt）
• 考虑转用hashcat等专业工具

5.3 跨语言兼容问题

特别是PHP和Node.js实现的JWT可能存在差异：

• PHP常使用非标准JSON格式（如['alg'=>'HS256']）
• Node.js的jsonwebtoken库有自己的一套默认header

临时解决方案是手动构造符合目标语言要求的原始token。

6. 进阶技巧与替代方案

对于工具无法直接处理的特殊情况：

Node.js环境处理：

// 使用jsonwebtoken库示例 const jwt = require('jsonwebtoken'); const token = jwt.sign({user:'admin'}, 'secret', {algorithm:'HS256'});

复杂场景下的替代工具：

• jwt_tool：功能更全面的命令行工具
• Burp JWT Editor：与Burp Suite集成
• hashcat：高性能密钥爆破

在开发过程中，最意外的收获是发现工具在内网CTF比赛中的价值。当比赛环境完全隔离，无法访问在线工具或下载新软件时，这个提前准备好的小工具就成了救命稻草。