1. 项目概述为什么我们需要一个自定义的加解密插件在渗透测试和Web应用安全评估的日常工作中Burpsuite几乎是每个从业者手中的瑞士军刀。无论是抓包、重放、扫描还是模糊测试它都提供了强大的基础设施。然而当测试目标涉及自定义的、非标准的通信协议或数据格式时我们常常会遇到一个痛点Burpsuite的原始数据视图是“透明”的但我们的眼睛却是“盲”的。想象一下你拦截到一串请求其请求体或Cookie值是一长串看似随机的Base64字符串或者是一段经过AES加密的密文。你无法直观地理解其含义更无法在Repeater模块中手动修改某个参数值比如把userId从10086改成10010因为一旦你修改了明文的某个字符整个加密结构就被破坏了服务器会直接拒绝你的请求。这就是自定义加解密插件的用武之地。它的核心价值在于让Burpsuite能够“理解”并“操作”经过特定算法处理的数据。插件在Burpsuite的各个关键节点Proxy、Repeater、Intruder、Scanner充当一个透明的编解码器。当数据流经Burpsuite时插件自动将其解密为明文供你查看和编辑当你完成编辑后它又自动将明文重新加密生成服务器能够识别的合法请求。整个过程对测试者来说是无感的你就像在操作一个普通的HTTP请求一样但实际上底层已经完成了复杂的密码学变换。在Burpsuite Extender API的演进史上Montoya API是一个重要的里程碑。它取代了旧有的、略显笨拙的Extender API提供了更现代、更清晰、更强大的编程接口。基于Montoya API开发插件意味着你可以更专注于业务逻辑即你的加解密算法而不用在API的兼容性和生命周期管理上耗费太多精力。对于需要开发高效、稳定插件的安全工程师来说直接基于Montoya API是当前的最优选择。2. 环境准备与项目初始化2.1 开发环境搭建工欲善其事必先利其器。开发Burpsuite插件首要任务是搭建一个顺手的Java开发环境。JDK选择与配置Burpsuite是基于Java开发的因此插件也必须使用Java编写。我强烈推荐使用JDK 11或JDK 17的LTS长期支持版本。这两个版本在企业级应用和Burpsuite自身环境中得到了广泛验证兼容性最好。你可以从Adoptium原AdoptOpenJDK或Oracle官网下载。安装后请务必确认环境变量JAVA_HOME已正确设置并且在命令行中执行java -version和javac -version命令能输出预期的版本信息。构建工具选型现代Java项目离不开构建工具。对于插件开发我首推Gradle。相比MavenGradle的构建脚本build.gradle.kts更简洁灵活依赖管理也更直观。更重要的是后续我们将使用一个专门为Montoya API设计的Gradle插件来简化开发流程这个插件目前对Gradle的支持最为友好。IDE的选择IntelliJ IDEA无疑是Java开发者的首选其社区版免费功能已完全足够。在IDEA中创建新项目时选择“Gradle”作为构建系统并勾选“Kotlin DSL”选项这会让我们的build.gradle.kts脚本更易读。2.2 创建Montoya API插件项目骨架项目初始化是第一步也是最容易踩坑的一步。一个清晰的项目结构能避免后续无数麻烦。步骤一初始化Gradle项目在IDEA中新建项目后我们需要修改根目录下的build.gradle.kts文件。核心是引入burp-gradle-plugin。这个由PortSwagger官方社区维护的插件能自动处理依赖下载、打包生成BurpExtender.jar等繁琐工作。plugins { java-library id(com.github.psxpaul.execfork) version 0.2.0 // 用于运行Burpsuite id(burp.gradle.plugin) version 0.0.5 // 核心插件 } group com.yourcompany version 1.0.0 repositories { mavenCentral() } burp { burpVersion.set(2024.6) // 指定你使用的Burpsuite版本 // 插件在Burpsuite中显示的名称 name.set(Crypto Assistant) // 作者信息 author.set(Your Name) }步骤二配置主类与依赖接下来在src/main/java目录下创建你的包和主类例如com.yourcompany.crypto.CryptoPlugin。然后在build.gradle.kts中指定主类并添加Montoya API依赖。tasks.jar { manifest { attributes( Main-Class” to “com.yourcompany.crypto.CryptoPlugin” // 非必需但建议保留 ) } } dependencies { // Montoya API依赖burp-gradle-plugin会自动将其打包 implementation(net.portswigger.burp.extensions:montoya-api:) // 如果你需要额外的加解密库例如BouncyCastle implementation(“org.bouncycastle:bcprov-jdk15on:1.70) }步骤三首次构建与验证在终端执行./gradlew build。如果一切顺利你会在build/libs/目录下看到一个以-burp.jar结尾的JAR文件例如CryptoAssistant-1.0.0-burp.jar。这个就是可以直接加载到Burpsuite中的插件文件。注意首次构建可能会因为下载Burpsuite的API JAR而较慢。确保网络通畅。另外burpVersion一定要和你本地安装的Burpsuite专业版或社区版大版本号匹配否则可能导致运行时错误。3. 理解Montoya API的核心架构与事件流在动手写代码之前我们必须像理解交通网络一样理解Montoya API的事件驱动模型。你的插件就像一个设在各个路口的智能收费站数据包就是车辆你需要决定在哪个路口拦截、检查解密还是改装加密它们。3.1 Montoya API 的关键接口Montoya API的核心是几个接口你的主类需要实现它们来声明自己具备哪些能力。BurpExtension: 这是插件的总入口。它只有一个initialize()方法当Burpsuite加载插件时首先调用这个方法。在这里你将获得一个MontoyaApi对象它是你与Burpsuite世界交互的唯一入口。HttpHandler: 这是处理HTTP流量的核心接口。实现它并注册到MontoyaApi中你的插件就能拦截到所有流经Burpsuite的HTTP请求和响应。HttpHandler有两个关键方法handleHttpRequestToBeSent(HttpRequestToBeSent request): 当一个HTTP请求即将从Burpsuite发往目标服务器时调用。这是执行请求体加密的黄金位置。handleHttpResponseReceived(HttpResponseReceived response): 当Burpsuite从服务器收到一个HTTP响应时调用。这是执行响应体解密的黄金位置。ProxyHttpRequestHandler与ProxyHttpResponseHandler: 这两个接口提供了更细粒度的、专门针对Proxy历史记录和UI显示的控制。例如你可以在这里修改Proxy历史中显示的内容将密文解密后显示为明文而不会影响实际传输的数据包。这对于“只读”式的解密展示非常有用。3.2 数据流与插件介入点理解数据在Burpsuite中的流动路径至关重要。下图展示了插件如何嵌入到这个流程中[浏览器/客户端] | (发送明文请求) v [Burpsuite Proxy] | -- (1) 请求到达ProxyHttpRequestHandler可介入修改UI显示内容 v [你的插件 - HttpHandler.handleHttpRequestToBeSent] | -- (2) **关键介入点将明文请求体加密** v [目标服务器] | (处理请求返回加密响应) v [Burpsuite Proxy] | -- (3) 响应到达ProxyHttpResponseHandler可介入修改UI显示内容 v [你的插件 - HttpHandler.handleHttpResponseReceived] | -- (4) **关键介入点将加密响应体解密** v [浏览器/客户端] (收到明文响应)一个重要的概念作用域。你肯定不希望插件对所有网站的流量都进行加解密操作那会带来混乱和错误。因此在你的插件逻辑里必须有一个“开关”或“判断”机制。通常我们会检查请求的URLHttpRequestToBeSent.url()或主机名只有匹配我们目标测试域名的流量才触发加解密逻辑。这个判断通常放在handleHttpRequestToBeSent和handleHttpResponseReceived方法的最开始。4. 核心功能实现请求加密与响应解密这是插件最核心的部分。我们将以一个常见的场景为例假设目标API的JSON请求体在传输前会对整个data字段的值进行AES-CBC加密然后Base64编码响应亦然。4.1 定义加解密服务首先我们应该将加解密算法逻辑封装成一个独立的服务类保持主流程代码的清晰。这里以AES为例。package com.yourcompany.crypto.service; import javax.crypto.Cipher; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; public class AesCryptoService { private final String secretKey; // 例如“0123456789abcdef0123456789abcdef” private final String iv; // 例如“abcdefghijklmnop” public AesCryptoService(String secretKey, String iv) { this.secretKey secretKey; this.iv iv; } public String encrypt(String plainText) throws Exception { Cipher cipher Cipher.getInstance(“AES/CBC/PKCS5Padding); SecretKeySpec keySpec new SecretKeySpec(secretKey.getBytes(“UTF-8”), “AES”); IvParameterSpec ivSpec new IvParameterSpec(iv.getBytes(“UTF-8”)); cipher.init(Cipher.ENCRYPT_MODE, keySpec, ivSpec); byte[] encrypted cipher.doFinal(plainText.getBytes(“UTF-8”)); return Base64.getEncoder().encodeToString(encrypted); } public String decrypt(String base64CipherText) throws Exception { Cipher cipher Cipher.getInstance(“AES/CBC/PKCS5Padding); SecretKeySpec keySpec new SecretKeySpec(secretKey.getBytes(“UTF-8”), “AES”); IvParameterSpec ivSpec new IvParameterSpec(iv.getBytes(“UTF-8”)); cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec); byte[] decoded Base64.getDecoder().decode(base64CipherText); byte[] decrypted cipher.doFinal(decoded); return new String(decrypted, “UTF-8”); } }实操心得算法与模式。实际项目中加解密算法千变万化。除了AES还可能遇到DES、RSA、SM4国密等。模式除了CBC还有ECB、GCM等。填充方式也有PKCS5Padding、PKCS7Padding、NoPadding等。务必与开发文档或逆向工程的结果保持绝对一致。一个错误的模式或填充设置会导致解密失败。建议将算法、模式、填充、密钥、IV等参数设计为可配置项方便后期调整。4.2 实现HttpHandler处理请求加密现在在主插件类中实现HttpHandler接口并在initialize中注册它。package com.yourcompany.crypto; import burp.api.montoya.MontoyaApi; import burp.api.montoya.core.ByteArray; import burp.api.montoya.http.handler.*; import burp.api.montoya.http.message.requests.HttpRequestToBeSent; import burp.api.montoya.http.message.responses.HttpResponseReceived; import com.yourcompany.crypto.service.AesCryptoService; import static burp.api.montoya.http.handler.RequestToBeSentAction.continueWith; import static burp.api.montoya.http.handler.ResponseReceivedAction.continueWith; public class CryptoPlugin implements BurpExtension, HttpHandler { private MontoyaApi api; private AesCryptoService cryptoService; private final String TARGET_DOMAIN “vulnerable-app.com”; // 目标域名 Override public void initialize(MontoyaApi api) { this.api api; this.cryptoService new AesCryptoService(“your-secret-key-here”, “your-iv-here”); // 设置插件名称 api.extension().setName(“Crypto Assistant”); // 注册自己为HTTP处理器 api.http().registerHttpHandler(this); api.logging().logToOutput(“Crypto Assistant Plugin Loaded!”); } Override public RequestToBeSentAction handleHttpRequestToBeSent(HttpRequestToBeSent request) { // 1. 判断是否为目标流量 if (!request.url().contains(TARGET_DOMAIN)) { return continueWith(request); // 不是目标直接放行 } // 2. 获取请求体假设是JSON格式且加密字段为data String body request.bodyToString(); if (body ! null body.contains(“\data\:”)) { try { // 3. 这是一个简化的JSON解析实际应用建议使用Jackson或Gson // 提取出data字段的明文值 int dataStart body.indexOf(“\data\:\””) 8; int dataEnd body.indexOf(“\””, dataStart); if (dataStart 8 dataEnd dataStart) { String plainData body.substring(dataStart, dataEnd); // 4. 加密 String encryptedData cryptoService.encrypt(plainData); // 5. 替换原请求体中的data字段值 String newBody body.substring(0, dataStart) encryptedData body.substring(dataEnd); // 6. 构造新的请求并返回 HttpRequestToBeSent newRequest request.withBody(ByteArray.byteArray(newBody)); api.logging().logToOutput(“[] Encrypted request data for: “ request.url()); return continueWith(newRequest); } } catch (Exception e) { api.logging().logToError(“[-] Failed to encrypt request: “ e.getMessage()); } } // 如果不符合条件或出错返回原请求 return continueWith(request); } Override public ResponseReceivedAction handleHttpResponseReceived(HttpResponseReceived response) { // 解密逻辑与加密类似方向相反 if (!response.initiatingRequest().url().contains(TARGET_DOMAIN)) { return continueWith(response); } String body response.bodyToString(); // 假设响应JSON中也有一个encryptedData字段 if (body ! null body.contains(“\encryptedData\:”)) { try { // 提取、解密、替换响应体 // ... (解密逻辑与请求加密类似) // HttpResponseReceived newResponse response.withBody(...); // return continueWith(newResponse); } catch (Exception e) { api.logging().logToError(“[-] Failed to decrypt response: “ e.getMessage()); } } return continueWith(response); } }代码解析与关键点作用域判断if (!request.url().contains(TARGET_DOMAIN))这行代码至关重要它确保了插件只处理我们关心的流量避免干扰其他测试。请求/响应不可变Montoya API的设计遵循不可变Immutable原则。HttpRequestToBeSent和HttpResponseReceived对象本身不能被修改。任何修改都必须通过其withXxx()方法如withBody()创建一个新的对象副本。动作返回handleHttpRequestToBeSent方法必须返回一个RequestToBeSentAction。continueWith(request)是最常用的表示用这个可能被修改过的请求继续后续流程。你也可以返回drop()来丢弃请求但这在加解密场景中很少用。日志输出使用api.logging().logToOutput()和logToError()进行日志记录这对于调试插件行为至关重要。你可以在Burpsuite的Extender标签页的“Output”和“Errors”子标签中看到这些日志。4.3 处理非标准数据格式与流式数据上面的例子基于一个简单的JSON键值对。但现实往往更复杂整个请求体/响应体加密数据可能不是JSON或者整个HTTP Body就是一个加密后的二进制块。这时你需要判断Content-Type然后对整个body进行加解密操作而不是解析特定字段。自定义二进制协议数据可能根本不是文本而是纯二进制流。你需要使用ByteArray类提供的getBytes()方法获取原始字节数组进行加解密后再用ByteArray.byteArray(encryptedBytes)构造新的ByteArray。URL参数或Header加密有些应用会对URL中的查询参数或特定的HTTP Header进行加密。你需要通过request.path()和request.headers()来获取并处理这些部分。注意事项字符编码。在字符串和字节数组转换时务必明确指定字符编码如“UTF-8”。使用平台默认编码是万恶之源会导致在不同操作系统上运行结果不一致出现中文乱码或加解密失败。5. 增强插件UI配置与动态规则一个只有硬编码密钥和域名的插件是不实用的。我们需要一个图形界面GUI让测试者能动态配置这些参数甚至管理多套加解密规则。5.1 使用Swing构建配置面板Montoya API允许你轻松添加自定义的标签页到Burpsuite主界面。我们将创建一个简单的Swing面板。首先创建一个配置面板类package com.yourcompany.crypto.ui; import javax.swing.*; import java.awt.*; public class CryptoConfigPanel extends JPanel { private final JTextField targetDomainField; private final JTextField secretKeyField; private final JTextField ivField; private final JCheckBox enablePluginCheckBox; public CryptoConfigPanel() { setLayout(new GridBagLayout()); GridBagConstraints gbc new GridBagConstraints(); gbc.fill GridBagConstraints.HORIZONTAL; gbc.insets new Insets(5, 5, 5, 5); gbc.gridx 0; gbc.gridy 0; add(new JLabel(“Enable Plugin:”), gbc); gbc.gridx 1; enablePluginCheckBox new JCheckBox(“” true); add(enablePluginCheckBox, gbc); gbc.gridx 0; gbc.gridy 1; add(new JLabel(“Target Domain:”), gbc); gbc.gridx 1; targetDomainField new JTextField(“vulnerable-app.com”, 25); add(targetDomainField, gbc); gbc.gridx 0; gbc.gridy 2; add(new JLabel(“Secret Key (Hex):”), gbc); gbc.gridx 1; secretKeyField new JTextField(“0123456789ABCDEF0123456789ABCDEF”, 32); add(secretKeyField, gbc); gbc.gridx 0; gbc.gridy 3; add(new JLabel(“IV (Hex):”), gbc); gbc.gridx 1; ivField new JTextField(“ABCDEFGHIJKLMNOP”, 16); add(ivField, gbc); // 可以添加保存、加载配置的按钮 gbc.gridx 0; gbc.gridy 4; gbc.gridwidth 2; JButton saveBtn new JButton(“Save Configuration”); saveBtn.addActionListener(e - saveConfig()); add(saveBtn, gbc); } private void saveConfig() { // 这里应该将配置保存到持久化存储例如Burpsuite的持久化项目设置中 // 可以使用 api.persistence().preferences() 来存储键值对 JOptionPane.showMessageDialog(this, “Config saved (In memory).”); } // Getter methods for the main plugin to read configuration public boolean isPluginEnabled() { return enablePluginCheckBox.isSelected(); } public String getTargetDomain() { return targetDomainField.getText().trim(); } public String getSecretKey() { return secretKeyField.getText().trim(); } public String getIv() { return ivField.getText().trim(); } }然后在主插件initialize方法中将这个面板注册为Burpsuite的一个标签页Override public void initialize(MontoyaApi api) { this.api api; this.configPanel new CryptoConfigPanel(); // 假设已将面板声明为类变量 api.extension().setName(“Crypto Assistant”); // 添加自定义标签页 api.userInterface().registerSuiteTab(“Crypto Config”, configPanel); api.http().registerHttpHandler(this); // 从持久化设置中加载配置如果有 loadConfiguration(); }现在当你在Burpsuite中切换到“Crypto Config”标签页就可以动态修改目标域名、密钥等参数了。你的handleHttpRequestToBeSent方法中的判断逻辑和AesCryptoService的初始化都需要改为从configPanel的Getter方法实时读取配置。5.2 实现多规则管理与上下文菜单对于更复杂的测试环境一个目标可能对应多套加解密规则例如登录接口用一种密钥支付接口用另一种。我们可以设计一个规则管理器。设计规则模型public class CryptoRule { private String name; private String pattern; // URL匹配模式支持正则 private String algorithm; private String key; private String iv; private boolean enabled; // ... getters and setters }实现规则匹配在handleHttpRequestToBeSent中遍历所有已启用的CryptoRule用pattern去匹配请求的URL。匹配成功则使用该规则对应的算法和密钥进行加解密。添加上下文菜单Montoya API允许你为HTTP请求/响应编辑器添加自定义的上下文菜单项。这非常有用例如你可以添加一个“Decrypt This”的右键菜单手动触发对选中密文的解密并将结果显示在一个对话框中。api.userInterface().registerContextMenuItemsProvider(new ContextMenuItemsProvider() { Override public ListComponent provideMenuItems(ContextMenuEvent event) { ListComponent menuItems new ArrayList(); if (event.isFromHttpRequestEditor() || event.isFromHttpResponseEditor()) { // 获取用户选中的文本 String selectedText event.selectedText(); if (selectedText ! null !selectedText.isEmpty()) { JMenuItem decryptItem new JMenuItem(“Crypto: Decrypt”); decryptItem.addActionListener(e - { try { String decrypted cryptoService.decrypt(selectedText); // 弹窗显示结果 showTextDialog(“Decryption Result”, decrypted); } catch (Exception ex) { api.logging().logToError(“Manual decryption failed: “ ex.getMessage()); } }); menuItems.add(decryptItem); } } return menuItems; } });6. 调试、打包与发布6.1 高效调试技巧开发插件时调试是家常便饭。以下是我总结的几个高效方法充分利用日志在关键决策点、异常捕获处、加解密前后使用api.logging()输出详细信息。这是定位问题最直接的手段。使用Gradle插件启动Burpsuite前面提到的burp-gradle-plugin通常集成了execFork插件。你可以在build.gradle.kts中配置让./gradlew runBurp命令直接启动一个带有你插件JAR的Burpsuite实例这比手动加载方便得多。单元测试独立算法将加解密算法逻辑单独剥离出来编写JUnit单元测试。确保你的算法逻辑在各种边界情况下空字符串、特殊字符、超长文本都能正确工作这能排除大部分核心逻辑错误。使用调试器在IDEA中你可以远程调试运行中的Burpsuite。配置Burpsuite的启动参数添加-agentlib:jdwptransportdt_socket,servery,suspendn,address5005然后在IDEA中创建Remote JVM Debug配置并连接到localhost:5005即可进行断点调试。6.2 打包与依赖管理使用./gradlew build生成的-burp.jar文件已经包含了所有必要的依赖除了Montoya API本身它由Burpsuite运行时提供。这个JAR就是最终产物。关于依赖冲突如果你的插件引入了第三方库如BouncyCastle, Gson而目标测试环境使用的Burpsuite可能也自带旧版本的相同库可能会引发冲突。Gradle的shadow插件或现在叫gradle-shadow-jar可以帮你打一个“胖JAR”将所有依赖类重命名后打包进去有效避免冲突。在build.gradle.kts中应用并配置它plugins { id(“com.github.johnrengelman.shadow”) version “8.1.1” } // ... tasks.shadowJar { archiveClassifier.set(“all”) // 生成一个 -all.jar 文件 // 可选重命名依赖包路径 relocate(“org.bouncycastle”, “com.yourcompany.shaded.bouncycastle”) }6.3 发布与分享一个成熟的插件除了核心功能还需要考虑用户体验。版本管理在build.gradle.kts中清晰定义version每次功能更新或Bug修复后递增版本号。编写README创建一个详细的README.md文件说明插件的功能、安装方法、配置步骤、常见问题。这对于其他测试者使用你的插件至关重要。错误处理与兼容性确保你的插件有良好的异常处理不会因为单个请求处理失败而导致整个Burpsuite崩溃。考虑不同Burpsuite版本的API兼容性如果使用了新版本API的特性需要在文档中注明最低版本要求。开源与反馈考虑将插件开源在GitHub等平台。这不仅能帮助他人也能通过社区反馈发现你未曾考虑到的问题和使用场景从而不断完善插件。开发一个高效的Burpsuite加解密插件就像为你的安全测试工作流安装了一个自动翻译器。它消除了手动编解码的繁琐和错误让你能聚焦于更重要的逻辑漏洞挖掘。从理解Montoya API的事件流到实现核心的加解密逻辑再到构建友好的配置界面每一步都需要耐心和细致的调试。当你看到经过加密的乱码在Burpsuite中实时变成可读、可编辑的明文时那种顺畅的测试体验就是对这项工作最好的回报。记住最好的插件往往源于你自己最真实的测试痛点解决它然后分享它这就是安全社区的协作精神。