BurpSuite插件开发指南之Python篇
0x00 Jython 简介
BurpSuite 是使用 Java 编程语言编写的,所以想要使用 Python 编程语言开发其插件,就必须借助于 Jython。Jython 本质上是一个 Java 应用程序,它允许 coder 们使用 Java 代码调用 Python 库反之,也可以使用 Python 调用 Java 的库。
有关 Jython 的详细使用,请读者参阅 Jython 官网的 用户手册 和 相关 doc。
类似于 Jython 的 Project 还有 JRuby ,并且 Burp 也支持 ruby 编写插件,但是无论是用 Python 还是 Ruby 编写的插件,在执行效率方面远远不如原生的 Java 高,所以笔者还是建议使用 Java 编写插件。
0x01 Python 编写 Burp 插件
Python 编写 Burp 插件辅助工具
Jython Burp API
使用 Python 编写 Burp 插件的时候会遇到各种琐碎的麻烦。最主要的原因在于,Java 与 Python 编程语言特性上的差异,如:强弱类型,数据类型等以及 Jython 本身与 CPython 的一些不同(具体请看 Jython 官网文档)。不过在熟悉了 Burp 接口和基本的编写套路后,一切都会变得很简单。
国外有牛人编写了一个 Jython Burp API,封装了一些功能,可以很方便的获取 Burp 数据并且可以调试 Jython 代码。具体使用说明请看 Git 文档。
Jython Burp API Git 地址
注:
加载 Jython Burp API 时会出现 sys 模块 PS1 PS2 未定义的错误。后来 Google 后发现这个是 Jython 本身的一个 Bug,不过官方已有 Issue 会在后续的版本中进行修复。
解决此错误的方法如下:
编辑 jython-burp-api/Lib/gds/burp/console/console.py 文件,将 25 26 行直接改为如下代码即可:
Python 编写 Burp 插件 注意事项
Python 导入相关库
Python 实现接口的方式与 Python 中类的继承写法一样。只是读者要注意的是:在 Java 中,类是单继承的,一个子类直接继承的父类只能有一个,可以通过间接的方式实现多继承,但 Python 中是可以直接继承多个类。
Python 编写 Burp 插件的示例代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
|
''' BurpSuite插件开发指南之 Python 篇 '''
from burp import IBurpExtender, IProxyListener
from java.net import URL
class BurpExtender(IBurpExtender, IProxyListener): def registerExtenderCallbacks(self, callbacks): pass def processProxyMessage(self, messageIsRequest, message): pass
|
PermGen space 错误
在 Burp 加载 Python 编写的插件时,会经常遇到如下图所示的错误:
Burp 官网也给出了解决 java.lang.OutOfMemoryError: PermGen space 错误的办法。
在启动 Burp 时设置 JVM 的 XX 参数即可,如: java -XX:MaxPermSize=1G -jar burp.jar
不过即使是使用上述参数启动 Burp,在多次加载 Python 编写的插件后,还是会出现 Burp 卡死的现象。
Burp 加载 Python 编写的插件的方法
Python 编写的插件文件后缀为 py 文件,不能由 Burp 直接加载,所以在加载前需要先设置 Jython 的路径。
在 Jython 官方下载页面选择 Jython 独立 jar 包。下载好后,按照下图所示设置:
加载 Python 插件的方式如下图:
Python 编写 Burp GUI 插件实例
本实例使用 Python 调用 Java 的 swing 图形控件库并绑定相关事件。最终结果如下图:
示例代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
|
''' BurpSuite插件开发指南之 Python 篇 '''
from burp import IBurpExtender, ITab
from javax.swing import JPanel from javax.swing import JButton class BurpExtender(IBurpExtender, ITab): def registerExtenderCallbacks(self, callbacks): self._cb = callbacks self._hp = callbacks.getHelpers() self._cb.setExtensionName('BurpPython') print 'hello burp!' self.mainPanel = JPanel() self.testBtn = JButton('Click Me!', actionPerformed=self.testBtn_onClick) self.mainPanel.add(self.testBtn) self._cb.customizeUiComponent(self.mainPanel) self._cb.addSuiteTab(self) def testBtn_onClick(self, event): print 'testBtn clicked!' def getTabCaption(self): return 'BurpPython' def getUiComponent(self): return self.mainPanel
|
相比较 Java 编写 GUI 插件,如果要实现比较复杂的 GUI,使用 Python 编写还是比较轻松的事情,不用关心太多的参数及参数类型,绑定事件也更加简单。
0x02 Python 编写 Burp 插件实例之 工具集成菜单
本小节会使用一个工具集成右键菜单的 Burp 插件举例说明 Python 编写 Burp 插件的套路。
注:读者可以在此插件的基础上修改为任何你想要执行的命令或程序 并指定不同的参数,如:使用 请求原始数据配合 SQLMap 进行SQLi 测试。另外在使用该插件过程时,可以将输出设置为系统控制台输出,如下图所示:
代码和配置文件内容如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
|
''' BurpSuite插件开发指南之 Python 篇 ''' import os import sys import json import thread import traceback
from burp import IBurpExtender from burp import IContextMenuFactory
from javax.swing import JMenu from javax.swing import JMenuItem reload(sys) sys.setdefaultencoding('utf-8') class BurpExtender(IBurpExtender, IContextMenuFactory): def registerExtenderCallbacks(self, callbacks): self.messages = [] self.menusConf = {} self.callbacks = callbacks self.helpers = callbacks.getHelpers() self.callbacks.issueAlert('toolKits is ready ...') self.callbacks.setExtensionName('toolKits') self.callbacks.registerContextMenuFactory(self) def loadMenus(self): self.menus = [] self.mainMenu = JMenu("toolKits") self.menus.append(self.mainMenu) try: with open('toolKits/toolKits.conf') as fp: self.menusConf = json.loads(fp.read()) except: self.mainMenu.add(JMenuItem(u'加载配置出错!')) else: for tool in self.menusConf: menu = JMenuItem(tool['name'], None, actionPerformed=lambda x: self.eventHandler(x)) self.mainMenu.add(menu) def createMenuItems(self, invocation): self.loadMenus() self.messages = invocation.getSelectedMessages() return self.menus if self.menus else None def eventHandler(self, x): ''' 通过获取当前点击的子菜单的 text 属性,确定当前需要执行的 command 启动线程执行命令 ''' try: menuName = x.getSource().text for tool in self.menusConf: if tool['name'] == menuName: commands = [tool['command'].replace( '{#}', val) for val in self.getValue(tool['param'])] [thread.start_new_thread(self.execCommand, (command,)) for command in commands] except: print traceback.print_exc() def getHost(self, message): return message.getHttpService().getHost() def getUrl(self, meesage): return str(self.helpers.analyzeRequest(meesage).getUrl()) def getValue(self, paramType): if paramType == 'host': return set([self.getHost(message) for message in self.messages]) elif paramType == 'url': return set([self.getUrl(message) for message in self.messages]) def execCommand(self, command): try: print '[I] 正在执行命令: {command}, 请稍后...'.format(command=command) res = '---------- 命令 {command} 执行结果: ---------- {res}'.format( command=command, res=os.popen(command).read()) print res except: print traceback.print_exc()
|
该插件有一个配置文件,格式为 JSON 格式(Jython 2.7.0 不支持 yaml):
1 2 3 4 5 6 7 8 9 10 11
| [{ "name": "Nmap 扫描端口", "param": "host", "command": "nmap -T4 {#}" }, { "name": "SQLMap 检查注入", "param": "url", "command": "python /opt/sqlmap/sqlmap.py -u {#} --dbs" }]
|
转自:https://www.tuicool.com/articles/aaaa6fA