SocketSleuth aims to enhance Burp Suite's websocket testing capabilities and make testing websocket based applications easier. This extension is currently in beta release but contains some powerful features such as a new websocket focused history tab, match and replace rules for websockets, an intruder like utility, and a message autorepeater for authorization testing.
- Burp Suite Professional / Community version 2022.9.5 or later
- Maven
- Clone the repository
git clone https://github.com/snyk/socketsleuth.git
- Navigate to the project directory
cd socketsleuth
- Build the project using Maven
mvn clean package
- Load the generated JAR file (
SocketSleuth/target/SocketSleuth-[VERSION]-jar-with-dependencies.jar
) into Burp Suite viaExtensions -> Installed -> Add
.
The current features for the beta version are minimal, but should be quite powerful.
- Websocket history
- Websocket intruder
- JSONRPC method discovery
- Sniper
- Simple List
- Numeric
- Websocket AutoRepater
- Similar to AutoRepeater and Autoize but for websocket. Allows the contents of a source websocket to automatically be replayed in a target socket. When setup with two unique sessions, this allows for automated AuthZ testing.
- Interception Rules
- Match & Replace Rules
- Basic string
- Hex encoded string (useful when working with non string payloads)
- Regex
For updated list of bugs and issues see the project issues. However at launch for beta release, there is some known problems.
- Currently only supports text based websockets. Binary based messages need some refactoring and we intend to address this soon.
- Regular Expression Match & Replace rules can be flakey and doesn't work all the time. Will be fixed soon.
- Table sorting does not work.
Contributions are welcome. See CONTRIBUTING.md for details.
SocketSleuth is under the Apache 2.0 License. See LICENSE for more information.