Skip to content

About

Burp Extension to add additional functionality for pentesting websocket based applications

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

SocketSleuth Modification for Blazor

Overview

This repo contains the unholy child created by Claude Code of:

Created during a security assessment with not much time. Works ok-ish as long as the WebSocket messages are not too large.

Main Modifications

BTP tab in SocketSleuce History

Sits alongside Message/Pretty/Raw/Hex in the SocketSleuth History viewer.

  • Decodes BlazorPack into readable JSON
  • Automatically aggregates consecutive same-direction frames when Burp splits large messages at 4096 bytes (up to 32 frames). Not sure if that works correctly.
  • JSON is editable; Re-encode & Send button re-packs it and sends it over the active WebSocket

History table

  • Row colouring
  • Column sorting
  • Auto-scroll

Auto-repeater

  • Adjusted such that it forwarded the BTP messages

Build Instructions

creates target/SocketSleuth-0.1-beta-jar-with-dependencies.jar that can be added in Burp.

Requirements

  • Burp Suite Professional / Community version 2022.9.5 or later
  • JDK 17
  • Dependencies already fetched into ~/.m2/repository (run mvn dependency:resolve once if not present, or use Maven for the initial download only)

Build with Maven

mvn clean package

Build without Maven (manual)

# from socketsleuth/
find src/main/java -name "*.java" > /tmp/ss_sources.txt

M2="$HOME/.m2/repository"
CP="$M2/net/portswigger/burp/extensions/montoya-api/2023.12.1/montoya-api-2023.12.1.jar:\
$M2/org/json/json/20231013/json-20231013.jar:\
$M2/com/intellij/forms_rt/7.0.3/forms_rt-7.0.3.jar:\
$M2/org/msgpack/msgpack-core/0.9.10/msgpack-core-0.9.10.jar"

mkdir -p /tmp/ss_build
javac --release 17 -cp "$CP" -d /tmp/ss_build @/tmp/ss_sources.txt

cd /tmp/ss_build
for jar in \
  "$M2/org/json/json/20231013/json-20231013.jar" \
  "$M2/com/intellij/forms_rt/7.0.3/forms_rt-7.0.3.jar" \
  "$M2/org/msgpack/msgpack-core/0.9.10/msgpack-core-0.9.10.jar"; do
  jar xf "$jar"
done

cp <socketsleuth>/src/main/resources/logo-black-sm.png .
cp <socketsleuth>/src/main/resources/jsonrpc.txt .

printf "Manifest-Version: 1.0\r\n\r\n" > /tmp/ss_manifest.txt
jar cfm <socketsleuth>/target/SocketSleuth-0.1-beta-jar-with-dependencies.jar \
    /tmp/ss_manifest.txt -C /tmp/ss_build .

About

Burp Extension to add additional functionality for pentesting websocket based applications

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages