Skip to content

Latest commit

 

History

History
184 lines (147 loc) · 22 KB

README-ZH.md

File metadata and controls

184 lines (147 loc) · 22 KB
Raw

PyBurp

English Version

PyBurp 是一个强大的BurpSuite插件，它允许你编写简单的Python代码来动态修改HTTP请求和响应。特别适用于处理那些对HTTP请求响应加密的业务场景，因为它支持远程调用Chrome或移动应用中的加解密方法。

此外，PyBurp还支持:

  • 复杂嵌套的JSON，Query String, XML之间的Content-Type转换
  • 动态注册自定义上下文菜单
  • 从HTTP history中保存需要的信息到sqlite数据库
  • Chrome DevTools Protocol
  • gRPC
  • ...

Video

与Chrome交互： https://youtu.be/FRCnZ8a7UGI
与Frida交互： https://youtu.be/zfvNqd5VmY0?t=45

对于移动应用的方法调用，PyBurp本身不直接支持，而是依赖于Frida来实现远程交互。

请注意，以上功能仅在Burp Suite v2024.5.4上进行了全面测试。建议使用该版本或更新版本以确保最佳兼容性和稳定性。

安装

从Release页面下载或直接在BApp Store中安装，然后从顶部菜单栏打开 PyBurp。

如果要使用gRPC或调用移动应用程序中的方法，还需要安装 pyburp

pip install pyburp

使用指南

预定义函数

PyBurp中预定义了一些函数，当你在脚本中定义这些函数时，会在自动在Burp Suite中注册对应的功能。详细函数如下表：

function name Description
handleRequest(request, annotations) 处理Burp Suite和服务器之间的请求
handleResponse(response, annotations) 处理Burp Suite和服务器之间的响应
handleProxyRequest(request, annotations) 处理客户端和Burp Suite之间的请求
handleProxyResponse(response, annotations) 处理客户端和Burp Suite之间的响应
urlPrefixAllowed(urls) 设置当前PyBurp标签允许处理的url前缀，通过urls.add(url)添加，需要配合上面4个方法使用。不写这个函数那么所有请求会过上面4个被重写过的函数，你也可以在上面4个函数中定义自己的filter
registerContextMenu(menus) 见注册上下文菜单
processPayload(str) 注册自定义intruder payload处理程序
handleInteraction(interaction) 轮询Collaborator服务器。该方法会自动注册Collaborator客户端，可以通过getOOBCanary()获得Payloads，示例脚本: collaborator.py
passiveScan(baseRequestResponse) 被动扫描
activeScan(baseRequestResponse, auditInsertionPoint) 主动扫描
finish() 停止脚本时会调用该函数

运行脚本后，可以在Burp Suite的Extensions选项卡中选中PyBurp插件，在Details中查看注册详情

Examples

为了方便熟悉预定义函数的使用，PyBurp内置了一些常用的脚本，如下表：

file name Description
api_documentation.py 方便查看PyBurp的预定义函数和内置函数，无需运行
notes.md 记录一些Payloads（该文件不保存，请自己添加文件），无需运行
env_init.py 环境初始化，包含一些常用类和方法，每创建一个PyBurp标签页会自动执行该代码， 无需运行
bambdas.py 快速从Proxy历史记录中提取信息,包含了查找超大响应的30x跳转，查找secretKey, web自定义字典生成三个示例
chrome_devtools_protocol.py 远程调用Chrome DevTools中的方法
collaborator.py Collaborator示例
customise_context_menu.py 注册上下文菜单，包含了NoSQL注入，条件竞争，权限绕过，unicode escape等多个示例
default.py 默认脚本，简单演示了修改请求和响应
encryptedCompleteBody.py 处理整个HTTP Body加密示例
encryptedCompleteBodyAes.py 处理整个HTTP Body AES加密示例
encryptedJsonParam.py 处理JSON参数加密示例
encryptedJsonParamRpc.py 使用RPC处理加解密示例
encryptedQueryForm.py 处理 Query String 加解密示例
highlight_interesting_http.py 高亮显示http请求和添加Notes示例，通常情况下更建议使用被动扫描
passive_active_scan.py 主动扫描和被动扫描示例
process_intruder_payload.py 创建供 Intruder 使用的 payload processing
race_condition.py 条件竞争（HTTP2使用single-packet，HTTP1.1使用last-byte sync）
rpc_debug.py RPC测试
save_subdomain_to_sqlite.py 从Proxy HTTP history中收集子域名保存到数据库或文件
signatureHeader.py 处理header中的签名
traffic_redirector.py 演示了重定向 outgoing HTTP requests 从一个主机到另一个主机
urls_from_file.py 从文件中读取url并发送请求（Python多线程）
urls_from_file2.py 从文件中读取url并发送请求（内置线程池）
use_pip2_packages.py 使用python三方库示例，不是所有三方库都能在Jython中使用，尤其是用到了C库的

请注意，对内置examples脚本文件的修改不会被保存。

注册上下文菜单

要在你的代码中注册上下文菜单项，首先需要定义一个名为 registerContextMenu 的函数，该函数接受一个菜单项集合menus作为参数。
随后，通过调用 menus 对象的 register 方法来注册具体的菜单项。register 方法接收三个参数：菜单的名称，与菜单项相关联的函数名称（当菜单项被选中时调用的函数）和菜单类型(MenuType)，下表展示了MenuType5种类型和关联函数要求。

MenuType function
CARET 无需参数，返回一个字符串，当前光标处插入该字符串
SELECTED_TEXT 接受选中的字符串作为参数，返回处理后的字符串
在可编辑的HTTP消息面板中会替换选中的字符串，反之弹窗显示返回的字符串
REQUEST 接受一个HttpRequest类型参数，无返回值，在只需要http请求的情况下使用
REQUEST_RESPONSE 接受一个HttpRequestResponse类型参数，无返回值，在同时需要http请求和响应的情况下使用
MESSAGE_EDITOR 接受一个MessageEditorHttpRequestResponse类型的参数，无返回值，在需要修改http消息面板内容时使用，通常情况下使用SELECTED_TEXT类型更方便

如下代码，演示了注册一个purify headers的上下文菜单，该菜单清除HTTP消息面板请求中多余的请求头。

def removeBoringHeaders(editor):
    request = editor.requestResponse().request()
    editor.setRequest(request.withRemovedHeader("Sec-Ch-Ua")\
                             .withRemovedHeader("Sec-Ch-Ua-Mobile")\
                             .withRemovedHeader("Sec-Ch-Ua-Platform")\
                             .withRemovedHeader("Sec-Fetch-Site")\
                             .withRemovedHeader("Sec-Fetch-Mode")\
                             .withRemovedHeader("Sec-Fetch-Dest")\
                             .withRemovedHeader("Priority")
                             )

def registerContextMenu(menus):
    menus.register("purify headers", removeBoringHeaders, MenuType.MESSAGE_EDITOR)

当菜单类型为MESSAGE_EDITOR时，还有以下两个实用方法：

  • getSelectedText(editor), 获取选中的文本，返回 ByteArray 对象
  • replaceSelectedText(editor, "new string")，替换选中的文本，返回HttpRequest 对象

更多示例请查看 customise_context_menu.py。

RPC

PyBurp允许通过gRPC调用其它程序提供的方法。你需要实现 burpextender.proto 中定义的服务接口，以便进行这些调用。

对于使用Python用户，相关服务接口已经在 pyburp 中实现，你可以通过 pip install pyburp 安装并使用这个库。
对于其他编程语言，请根据 burpextender.proto 文件生成代码并实现相应的服务接口。

接下来以Python进行演示：

  1. 运行RPC服务端，如下提供了test1, test2两个方法

    import pyburp
from base64 import b64encode

def test1(s):
    return b64encode(s)

def test2(i, j):
    return i + j

pyburp.expose(test1)
pyburp.expose(test2)
pyburp.run("127.0.0.1:30051")

  2. 在PyBurp中运行客户端代码,如下

    server = rpc("localhost", 30051)
result1 = server.callFunc('test1', bytearray("123"))
result2 = server.callFunc('test2', 3, 4)
print(result1)
print(result1.tostring()) # or print(bytearray(result1))
print(result2)
server.shutdown()

和 Frida 交互示例请查看server_frida.py

注意:

  1. pyburp 只支持str,bool,int,float,bytes,None这几种类型的参数
  2. 如果服务端暴露的方法只有一个参数且为bytes类型时，在PyBurp中需要通过bytearray封装参数，或者放入[]中，否则byte[]将被视为可变参数数组，每个字节被视为一个参数。
  3. 服务端返回的bytes在PyBurp中为array.array('b',initializer)类型，你可以将其等同于byte[]，不同的是你需要使用tostring()将其转换成字符串而不是toString()。

贡献与反馈

我们对这个项目的未来充满期待，并制定了未来工作的路线图。我们欢迎社区做出贡献，帮助我们实现目标，无论您是修复错误、添加功能还是改进文档，我们都非常感谢您的帮助。以下是我们接下来要关注的内容：

  1. 简化 HttpRequestEditorProvider and HttpResponseEditorProvider注册流程
  2. 代码提示， 这里 有一个示例程序
  3. 也许需要个简单的搜索框
  4. 代码区链接可点击

感谢您的支持和参与！

常见问题

  1. 为什么有些python库或方法无法在PyBurp中使用？
    PyBurp内置了Jython解释器而非标准的CPython，不是所有三方Python库都能使用，但能够无缝访问Java库。

  2. 怎么在Jython中创建byte[]兼容的字节数组？
    这里提供3个方法，请注意，将它转换成字符串时需要使用tostring()而不是toString()。

致谢

PyBurp 大部分灵感来自 Turbo Intruder