https://github.com/silentsignal/burp-collab-gw

Simple socket-based gateway to the Burp Collaborator
https://github.com/silentsignal/burp-collab-gw

burp messagepack

Last synced: 3 months ago
JSON representation

Simple socket-based gateway to the Burp Collaborator

• Host: GitHub
• URL: https://github.com/silentsignal/burp-collab-gw
• Owner: silentsignal
• License: mit
• Created: 2016-11-23T13:12:39.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2016-11-23T13:49:03.000Z (almost 8 years ago)
• Last Synced: 2024-05-20T10:32:36.093Z (6 months ago)
• Topics: burp, messagepack
• Language: Java
• Size: 5.86 KB
• Stars: 34
• Watchers: 8
• Forks: 13
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-burp-suite - **31**星 - based gateway to the Burp Collaborator (<a id="e0b6358d9096e96238b76258482a1c2f"></a>Collaborator / <a id="93941e987724e5628e5c99b464df1593"></a>工具)

README

        
Collaborator gateway for Burp Suite

===================================

Simple socket-based gateway to the Burp Collaborator.

Protocol

--------

 - The gateway listens on TCP port 8452 of the loopback interface.

 - The protocol uses [MessagePack][1] serialization without additional framing.

 - Sending `0` or `1` to the gateway results in a string reply containing

   a new payload, which includes the Collaborator location if the number

   sent is `1`.

 - Sending `2` to the gateway results in a string reply containing the

   Collaborator location, this can be used to construct FQDNs if the

   payload was requested with the number `0`.

 - Sending a string to the gateway results in the string being interpreted

   as a payload and the gateway will reply with an array of the interactions

   with the specified payload. Elements of the array will be maps with

   string keys, the values will be almost always strings, except for

   DNS raw queries, HTTP requests and responses and client IP addresses,

   which will be represented as binaries.

A sample client in Python is provided for easier understanding of the above

in the `clients` directory of this repository, in depends only on the

[msgpack-python][2] library, run `pip install msgpack-python` to install it.

  [1]: http://msgpack.org/

  [2]: https://github.com/msgpack/msgpack-python

Building

--------

 - Install the dependencies, in case of libraries, put the JARs into `lib`

 - Save the Burp Extender API from Burp and unpack it into `src`

 - Execute `ant`, and you'll have the plugin ready in `burp-collab-gw.jar`

Dependencies

------------

 - JDK 1.7+ (tested on OpenJDK `1.8.0_91`, Debian/Ubuntu package: `openjdk-7-jdk`)

 - Apache ANT (Debian/Ubuntu package: `ant`)

 - MessagePack for Java https://github.com/msgpack/msgpack-java/

License

-------

The whole project is available under MIT license, see `LICENSE.txt`.