burp扩展小工具

在做Web渗透的时候，用burp抓取数据包时，经常会遇到请求包经过Url编码了，想找哪个字段，眼都要花了。本人视力本来就不行，为了查看经过Url编码的数据方便，于是便有了这个Burp扩展小工具。

首先要学会查看Burp API文档，判定哪些Burp类需要在编写工具时进行扩展。这个API文档在burp工具当中就有的。单击Extender标签，然后单击后面的APIS标签查看相关文档。这些API都是Java的风格。但是使用Python、Ruby或者纯Java，都可以对Burp进行扩展（这里使用Python）。仔细查看这些文档，我们会注意到开发Burp的人员对每一个类都进行了适当的命名，这样我们就可以轻松地找到从哪里开始。

这里将此工具扩展到右键菜单中，我们找到IBurpExtender和IContextMenuFactory。让我们看下文档对IBurpExtender和IContextMenuFactory类的介绍。

/**
* All extensions must implement this interface.
*
* Implementations must be called BurpExtender, in the package burp, must be
* declared public, and must provide a default (public, no-argument)
* constructor.
*/
public interface IBurpExtender
{
/**
* This method is invoked when the extension is loaded. It registers an
* instance of the
* <code>IBurpExtenderCallbacks</code> interface, providing methods that may
* be invoked by the extension to perform various actions.
*
* @param callbacks An
* <code>IBurpExtenderCallbacks</code> object.
*/
void registerExtenderCallbacks(IBurpExtenderCallbacks callbacks);
}

这个文档告诉我们所有的扩展类都必须实现IBurpExtender接口。当扩展程序被调用时，registerExtenderCallbacks方法被调用，同时会初始化一个IBurpExtenderCallbacks的实例，提供扩展程序功能性方法。

/**
* Extensions can implement this interface and then call
* <code>IBurpExtenderCallbacks.registerContextMenuFactory()</code> to register
* a factory for custom context menu items.
*/
public interface IContextMenuFactory
{
/**
* This method will be called by Burp when the user invokes a context menu
* anywhere within Burp. The factory can then provide any custom context
* menu items that should be displayed in the context menu, based on the
* details of the menu invocation.
*
* @param invocation An object that implements the
* <code>IMessageEditorTabFactory</code> interface, which the extension can
* query to obtain details of the context menu invocation.
* @return A list of custom menu items (which may include sub-menus,
* checkbox menu items, etc.) that should be displayed. Extensions may
* return
* <code>null</code> from this method, to indicate that no menu items are
* required.
*/
List<JMenuItem> createMenuItems(IContextMenuInvocation invocation);
}

这个文档告诉我们，扩展程序实现这个接口，并调用IBurpExtenderCallbacks.registerContextMenuFactory()来实现右键菜单功能。

本例程序涉及到的其他文档可以参考Burp APIS。

完整代码如下：

#-*- coding:utf8 -*-

from burp import IBurpExtender
from burp import IContextMenuFactory
from java.util import List, ArrayList
from javax.swing import JMenuItem
import urllib

class BurpExtender(IBurpExtender, IContextMenuFactory):
def registerExtenderCallbacks(self,callbacks):
self._callbacks = callbacks
self._helpers = callbacks.getHelpers()
self.context = None

# 我们建立起扩展工具
callbacks.setExtensionName("RequestSerialize Tools")
callbacks.registerContextMenuFactory(self)

return

# 创建菜单并处理点击事件，就是actionPerformed那里，点击调用charConvert函数
def createMenuItems(self, context_menu):
self.context = context_menu
menu_list = ArrayList()
menu_list.add(JMenuItem("Send to CharConvert", actionPerformed=self.charConvert))
return menu_list

def charConvert(self, event):
# 获取用户点击的详细信息
http_traffic = self.context.getSelectedMessages()

request=http_traffic[0].getRequest()
if request:
print urllib.unquote(request.tostring())

return

是不是很简单！！！接下来看使用方法。

1.添加Jython解释器

单击Extender标签，然后单击Options按钮。在Python环境部分，选择Jython Jar文件路径，如下图所示：


2.将扩展工具添加到Burp

单击Extender下的Extensions标签，然后单击Add按钮，选择添加文件，如下图：



单击Next，加载成功后显示如下图所示：



3.如何使用扩展工具

用Burp抓取数据包，此数据包是经过Url编码的。右键单击，选择此扩展程序，如下图：



4.查看解码后的数据

单击Extender，选择我们添加的扩展程序，单击输出结果的output按钮，可以查看解码后的数据。