Burpy:Burp 经 PyRO 调用 Python 脚本自动加解密请求/响应(Burpy 类接口与三个常见报错)
tools/burp · verified
一句话结论
Burpy 是 Burp Suite 的 Python 桥接插件:Burp 通过 PyRO(Python 3 用 pyro5、Python 2 用 pyro4)调用本地 Python 脚本,脚本只需实现 Burpy 类的 main/encrypt/decrypt/processor 方法;开启 Auto Enc/Dec 后,Burp 发请求前自动调用 encrypt(header, body)、收到响应后自动调用 decrypt(header, body),把加密接口变成可读可改的明文流量。常见失败点集中在“把整个 body 当一个密文解”“按 k=v 切错 body”“把 header 当字符串”三类。
原理
- 架构:Burp 插件(Burpy)在本地启动/连接一个 PyRO 服务器,加载用户 Python 脚本并反射出
Burpy类的方法;Burp 的上下文菜单/自动模式通过 PyRO RPC 调用这些方法,返回值替换请求/响应。Python 脚本运行在独立进程,可用标准库、pycryptodome、gmssl等任意依赖。 - 必需接口:
class Burpy是必须的,插件从该类提取方法;main(header, body):通用处理入口;encrypt(header, body)/decrypt(header, body):Auto Enc/Dec 功能需要;Burp 在“发送请求”时调用encrypt,在“收到响应”时调用decrypt;processor(payload):启用 Processor 时用于处理 Intruder 等 payload;- 以
_/__开头的方法不会出现在上下文菜单(可放内部辅助函数)。 - 数据格式:
header是 dict,包含first_line(如POST /aes_1/login.php HTTP/1.1)等字段;body是字符串(原始请求/响应体,可能仍是 URL 编码)。 - 执行流:Burp 发送请求 → 调用脚本
encrypt→ 脚本解析 body、还原明文/重新加密 → 返回新的 header/body → Burp 发出;收到响应 → 调用decrypt→ 返回明文 body 展示。若只想改请求不想动响应,可在decrypt中直接返回原 header/body;反之亦然。 - 为什么需要按字段处理:很多登录接口不是“整个 body 一个 AES 密文”,而是每个参数值分别加密后再 URL 编码成
username=<base64>&password=<base64>。直接对整段 body 做 AES 解密会因长度不是块大小整数倍报Data must be aligned to block boundary in ECB mode;正确做法是先按&/=提取目标参数值,URL 解码、Base64 解码,再 AES 解密。 - 三个高频报错:
1.
Data must be aligned to block boundary in ECB mode:把整个 body 当密文;应提取单个参数值后再解密。 2.list index out of range:body.split('&')[0].split('=')[1]之类的假设不成立(body 为空、不是k=v、或处理到了响应包);应加if '=' in .../method 判断和异常处理。 3.'dict' object has no attribute 'split':header是 dict 不是字符串;要取请求行用header["first_line"],不要header.split(...)。 - 环境细节:Python 3 装
pyro5,Python 2 装pyro4;Burpy 配置需要填 Python 解释器路径(不是python命令)、PyRO host127.0.0.1、PyRO 端口(如 19999)、脚本路径;每次重启尽量换端口,避免 PyRO 旧对象注册/端口占用导致的“奇怪 bug”。
触发条件
- 已安装 Burp Suite 与 Burpy 插件,并有本地 Python 2/3 环境可安装
pyro4/pyro5。 - 目标请求/响应体由前端加密(AES/DES/SM4/RSA/自定义),且算法、Key/IV、编码顺序可在 JS 中还原,或可直接用 Python 复刻。
- 需要开启 Auto Enc/Dec 时,脚本必须实现
encrypt/decrypt,且能根据header["first_line"]区分请求/响应。 - 目标接口的 body 是表单/JSON 等可解析格式;若是整体加密的二进制/特殊分隔格式,需要按实际结构调整解析。
- 测试在授权范围内;脚本只处理本地流量,不要把 PyRO 端口暴露到公网。
利用步骤
- 安装 Burpy:Burp → Extensions → Add,选择 Burpy 插件 jar;扩展加载成功后 Burp 出现
Burpy标签页。 - 安装 PyRO:Python 3 执行
pip install pyro5;Python 2 执行pip2 install pyro4;确保 Burpy 配置的 Python 解释器路径就是安装了对应库的解释器。 - 编写脚本:定义
class Burpy,实现main/encrypt/decrypt(按需实现processor);先不要开启 Auto Enc/Dec,用上下文菜单手动调用验证。 - 在 Burpy 标签页配置:Python binary path、Pyro host
127.0.0.1、Pyro port(如 19999)、Burpy PY file path;点击 Start server,确认Pyro server started successfully且脚本加载无语法错误。 - 抓一个加密登录请求:确认 body 形如
username=<URL 编码的 Base64 密文>&password=<...>;在脚本中提取username值 → URL 解码 → Base64 解码 → AES 解密 → 去 PKCS7 填充 → 返回明文。 - 开启 Auto Enc/Dec(勾选 Enable Auto Enc/Dec),重新发送请求;在 Burpy 控制台观察
print输出与报错,确认请求被解密、响应可读。 - 在 Repeater 中修改明文参数后发送;若服务端要求重新加密,需要在同一脚本的
encrypt中实现“明文 → 加密 → URL 编码/Base64”的反向流程,再返回给 Burp。 - 出现报错时按三类问题排查:块对齐(是否整包解密)、索引越界(body 解析假设)、header 类型(是否误用
split);必要时在脚本中打印 body/header 的实际类型与内容。 - 使用 Processor 时可对 Intruder payload 做编码/加密;测试结束关闭 server、移除脚本,避免端口占用。
PoC
Burpy 脚本最小结构(按原文最终可运行的 AES-ECB 示例整理):
from Crypto.Cipher import AES
import base64
import urllib.parse
def pcs7_unpad(data: bytes) -> bytes:
padding_length = data[-1]
return data[:-padding_length]
def decrypt_request_body_username(body: str) -> str:
key = "secret_key111111" # 16 字节,按目标 JS 实际 key 替换
cipher = AES.new(key.encode(), AES.MODE_ECB)
# 只取第一个参数的值;不要对整段 body 做 AES 解密
username_encoded = body.split("&")[0].split("=")[1]
url_decoded = urllib.parse.unquote(username_encoded) # URL 解码
encrypted = base64.b64decode(url_decoded) # Base64 解码
decrypted = cipher.decrypt(encrypted)
return pcs7_unpad(decrypted).decode()
class Burpy:
def main(self, header, body):
return header, body
def encrypt(self, header, body):
# header 是 dict;取请求行必须用 header["first_line"]
method = header["first_line"].split(" ")[0]
if method in ("GET", "POST"):
print("处理请求包:", header["first_line"])
return header, decrypt_request_body_username(body)
print("处理返回包")
return header, body
def decrypt(self, header, body):
# 响应方向按需实现;不需要时原样返回
return header, body
对应的加密请求示例:
POST /aes_1/login.php HTTP/1.1
Host: target
Content-Type: application/x-www-form-urlencoded
username=XfEiAnNZOPt6uIh277KQag%3D%3D&password=6I%2BRCYnCCZCxuK8BBRPHcg%3D%3D
解密结果(原文):
Decrypted Username: orange
说明:原文第一次用 key '7777777' 且对整段 body 解密,分别触发块对齐报错;随后用 header.split(...) 触发 'dict' object has no attribute 'split';最终以 header["first_line"] + 单参数提取成功。密钥/字段名需按目标实际替换;以上 PoC 未在本机执行。
变体与关联
- 变体:AES-CBC/SM4/DES/RSA 只需替换
decrypt_request_body_username中的算法与 Key/IV 来源;如果是整体加密的 JSON body,则先解密整个 body,再json.loads。 - 变体:响应也加密时,在
decrypt中按相同逻辑处理响应 body;若响应是 JSON 内的data字段密文,先解析 JSON 再解密字段。 - 变体:需要自动重签/重放时,可在
encrypt中同时重算sign/timestamp/nonce;Burpy 只负责调用,签名逻辑仍由 Python 脚本实现。 - 变体:
processor(payload)可把 Intruder 的 payload 先编码/加密;main可用于非加解密的通用改写。 - 关联:[[tools-burp-encrypted-api-proxy-decrypt-resign]](mitmproxy 上下游代理透明解密/重签)、[[tools-burp-js-hook-bridge-traffic-encrypt-decrypt]](不还原算法,直接 hook 前端 encrypt/decrypt)、[[mobile-android-mcp-assisted-sign-reverse-autodecoder]](Android 端 sign 逆向 + autoDecoder 自动重签)。
- 边界:Burpy 只解决“Burp 内自动调用 Python 加解密”;算法/Key 仍需自行还原;如果目标使用 mTLS/证书固定、PyRO 端口被安全软件拦截、或 body 是不可解析的二进制,需要换用其他代理/插件方案。
检测与防御
- 这是授权测试工具;对防守方,前端加密只是提高逆向成本,不能替代 TLS、服务端鉴权与参数校验。
- 加固:不要依赖客户端加密作为安全边界;服务端对密文解密后仍需做身份/权限/业务校验;关键接口使用服务端一次性 nonce/时间戳并绑定会话,防止解密后重放。
- 检测:本地出现 PyRO 默认端口(如 19999/9090)监听、Burp 进程加载 Burpy/调用 Python 子进程;同一账号短时间大量请求且明文参数分布异常;请求体在 URL 编码/Base64/AES 之间呈现规律变换。
- 加固(客户端):对 JS 做混淆/完整性校验、启用 CSP 限制异常连接只能提高成本;不能阻止攻击者用本地脚本复刻算法。