WebSocket Turbo Intruder

Eine Erweiterung zum Fuzzing von WebSocket-Nachrichten mit benutzerdefiniertem Python-Code.

Verwendung

Intruder-Tool

1. Klicken Sie mit der rechten Maustaste auf eine WebSocket-Nachricht und navigieren Sie zu Extensions > WebSocket Turbo Intruder > Send to WebSocket Turbo Intruder. Wenn Sie vor dem Senden einen Teil der Nachricht markieren, wird der markierte Inhalt durch %s ersetzt.
2. Wählen Sie eine Vorlage aus der Dropdown-Liste.
3. Passen Sie den Python-Code an Ihren Anwendungsfall an.
4. Starten Sie den Angriff.

Hinweis: Dadurch wird eine neue WebSocket-Verbindung zum Senden von Nachrichten hergestellt.

Middleware-Tool

1. Klicken Sie mit der rechten Maustaste auf eine WebSocket-Nachricht und navigieren Sie zu Extensions > WebSocket Turbo Intruder > Send to WebSocket HTTP middleware.
2. Klicken Sie auf die Schaltfläche Start, um die HTTP-Server-Middleware zu starten.
3. Für jede eindeutige WebSocket-Verbindung erstellt die Erweiterung einen HTTP-POST-Endpunkt, der Anfragen an den Remote-Server weiterleitet.
4. Wählen Sie den HTTP-Server aus der Tabellenliste aus und senden Sie Anfragen über eines der Tools von Burp Suite.

Dokumentation

queue_websockets(base_websocket, message)

Das Objekt websocket_connection bietet die folgenden Methoden:

• create(base_websocket) erstellt eine WebSocket-Verbindung mit Burp Suite.
• create(base_websocket, engine) initialisiert eine Verbindung mit einer der unterstützten Engines: BURP, TURBO oder THREADED.
• create(base_websocket, engine, config) initialisiert eine Verbindung mit manuellen Einstellungen unter Verwendung der Engines TURBO und THREADED.
• config() erstellt die Standardkonfiguration, die von den Engines TURBO und THREADED verwendet wird
• config(connectionTimeout, sendingInterval, retries, number_of_threads, hello_message, send_ping_messages, use_chunks)
• • connectionTimeout - Verbindungs-Timeout (Integer)
• • sendingInterval - Verzögerung zwischen WebSocket-Frames in Millisekunden (Integer)
• • retries - Anzahl der Wiederverbindungsversuche, wenn die Verbindung geschlossen wird (Integer)
• • number_of_threads - Anzahl der von der Engine THREADED verwendeten Threads (Integer)
• • hello_message - anfängliche WebSocket-Nachricht, die beim Verbindungsaufbau gesendet wird (String)
• • send_ping_messages - ob die Engine Ping-Nachrichten senden soll (boolean)
• • use_chunks - ob die Engine chunked Requests senden soll (boolean)

Sobald eine WebSocket-Verbindung hergestellt ist, können Nachrichten zum Senden in die Warteschlange gestellt werden.

Verwenden Sie die Methode queue() für dieses Objekt.

• queue(String message): Sendet die Nachricht
• queue(String message, String replacement): Sendet die Nachricht. replacement ersetzt alle Vorkommen von %s in Ihrer Nachricht
• queue(FrameType code, byte[] message): Sendet eine Payload mit einem angegebenen Typcode:
• • CONTINUATION
• • TEXT
• • BINARY
• • CLOSE
• • PING
• • PONG
• queue(FrameType code, byte[] message, Integer legth): Sendet eine Payload mit einer benutzerdefinierten Länge und einem Typcode.
• queue(FrameType code, byte[] message, String legth): Sendet eine Payload mit einer benutzerdefinierten Länge, die als Long-String definiert ist.
• queueWithComment(String message, String comment): Sendet eine Nachricht mit einem angehängten Kommentar.
• queueWithComment(String message, String replacement, String comment): Sendet eine Nachricht mit einem Kommentar, wobei replacement alle %s-Vorkommen in der Nachricht ersetzt.

Die message repräsentiert den Inhalt des WebSocket-Nachrichten-Editors oben auf dem Bildschirm. Sie kann manuell bearbeitet oder innerhalb des Python-Skripts geändert werden.

handle_outgoing_message(websocket_message)

Verwenden Sie diese Methode, um ausgehende Nachrichten bedingt zur Ergebnistabelle hinzuzufügen.

handle_incoming_message(websocket_message)

Verwenden Sie diese Methode, um eingehende Nachrichten bedingt zur Ergebnistabelle hinzuzufügen.

websocket_message

Methoden:

• getMessage(): Ruft die Nachricht als String ab.
• getDirection(): Ruft die Nachrichtenrichtung ab (burp.api.montoya.websocket.Direction).
• getLength(): Ruft die Nachrichtenlänge ab.
• getDateTime(): Ruft den Zeitstempel ab (java.time.LocalDateTime).
• getComment(): Ruft den mit der Nachricht verknüpften Kommentar ab.
• setComment(String comment): Setzt einen Kommentar für die Nachricht.
• getConnection(): Ruft die Verbindung ab, wodurch weitere Nachrichten in die Warteschlange gestellt werden können.
• getHash(): Ruft den Nachrichten-Hash ab. Eingehende und ausgehende Nachrichten mit demselben Hash werden als Request-Response-Paare markiert.
• setHash(long id): Setzt einen benutzerdefinierten Hash für die Nachricht.
• getTime(): Ruft die Antwortzeit in Millisekunden ab.
• isInteresting(): Bestimmt, ob sich die Nachrichtenattribute von anderen Nachrichten unterscheiden, basierend auf:
• • Anzahl der JSON-Schlüssel
• • JSON-Schlüsselnamen
• • Backslash Powered Scanner-Schlüsselwörtern
• • Anzahl der Zeilen
• • Anzahl der Leerzeichen
• • Nachrichtenlänge