ProtobufDecoder

ProtobufdeCoder

Diese Anwendung hilft bei der Analyse von Google Protocol Puffer Nutzlasten, bei denen Sie keine entsprechende .proto -Datei haben.

Szenarien, in denen Sie dies verwenden möchten, besteht darin, das Ergebnis der Serialisierung zu überprüfen oder mit einem von System sprechenden Protobuf mit einem System zu interoperieren, der jedoch keine .proto -Datei liefert. Es kann für die Reverse Engineering verwendet werden, aber denken Sie daran, dass dies in Ihrer Gerichtsbarkeit möglicherweise nicht legal ist.

ProtobufDeCoder liest und dekodiert Binärdaten, die Sie entweder aus einem Debugger oder einem Tool wie Wireshark erfassen und die Tags aus den Daten analysiert. Sie können dann die Nutzlast analysieren, um festzustellen, welche Tags vorhanden sind, welche Typen ihre Typen sind (Nummer, Zeichenfolgen usw.) und ob eingebettete Nachrichten vorhanden sind.

Ein Changelog finden Sie hier

Merkmale

• Listen Sie Felder in der erfassten Nutzlast auf und zeigen Sie Informationen an:
  • Tag Index
  • Drahttyp
  • Inhalt (rohe Bytes, Werte)
• Zeigen Sie den Standort und die Größe eines bestimmten Tags in der binären Nutzlast an (wählen Sie ein Tag in der Baumansicht aus und unterstreichen die Bytes).
• Generieren Sie eine Protobuf -Spezifikation aus der dekodierten Nutzlast (Arbeit in Arbeit).
• Speichern Sie die generierte Protobuf -Spezifikation in einer .proto -Datei
• Kopieren Sie den Wert eines Tags als C# -Byte -Array

Verwendung

Laden Sie den neuesten Installateur von der Seite "Releases" herunter.

Wenn die Anwendung startet, öffnen Sie eine Datei mit einer Protobuf -Nutzlast entweder über Datei -> Öffnen oder die Tastaturverknüpfung Strg + O verwenden.

Bitte beachten Sie, dass der ProtobufDeCoder zu diesem Zeitpunkt nur die A -Datei unterstützt, die nur eine einzelne Rohprotobuf -Nachricht enthält. Wenn die Datei ein Länge -Präfix enthält, wird sie automatisch gestrippt (da Version 0.4.0).

Für die Tastatur Warriors: Verknüpfungsschlüssel sind in der App erhältlich und werden in den Menüpunkten angedeutet.

Integration in andere Tools

ProtobufDeCoder unterstützt das Öffnen einer Datei direkt, indem sie ein Befehlszeilenargument übergeben:

C:usersjohndoe > ProtobufDecoder.Application.Wpf.exe < path to binary >

Dadurch startet ProtobufDeCoder und öffnet sofort die angegebene Datei. Wenn die Datei nicht vorhanden ist oder nicht geöffnet werden kann, wird der Fehler in der Statusleiste angezeigt.

Gebäude

Derzeit gibt es keine Verpackung der Anwendung, was bedeutet, dass Sie die Anwendung selbst zusammenstellen müssen.

1. Klonen Sie dieses Repository
2. cd in das geklonte Verzeichnis
3. cd src/ProtobufDecoder.Application.Wpf
4. dotnet run -c Release

Dadurch werden die erforderlichen Pakete wiederhergestellt, die Anwendung erstellt und starten.

Um die Anwendung nach Schritt 3 auszuführen, werden Sie einfacher ausführen:

4. dotnet publish -c Release
5. Doppelklicken Sie auf den ausführbaren ProtobufDecoder.Application.Wpf.exe im src/ProtobufDecoder.Application.Wpf/bin/Release/net5.0-windows/publish Ordner

Sie können eine Abkürzung zu dieser ausführbaren Datei im Startmenü oder überall überall erstellen, wo Sie möchten.

Todo

• Dekodieren Sie die Länge mit delimitierten Tag-Werten, die Strings, gepackte wiederholte Werte oder eingebettete Nachrichten sein könnten
• Generieren Sie eine .proto -Datei aus dekodierter Nutzlast
  • Einzelne Tags
  • Optionale VS -erforderliche Tags
  • Verschachtelte Nachrichten (in Arbeit)
  • Längendelimited Tag-Typ-Typ (ist es eine Zeichenfolge oder eine Nachricht?) (Arbeiten in Arbeit)
  • Wiederholte Wertschilder
• Paketanwendung zum Download
• Release Build für Git -Tags einrichten
• Laden Sie eine .proto .proto und wenden Sie sie auf die dekodierte Nutzlast an (um die Datei.
• Gruppen dekodieren

Lizenz

Siehe Lizenz.

Anerkennung

Diese Anwendung verwendet:

• Topas/ VarintbitConverter/ Für Varint -Decodierung aus den Protobuf -Nutzlasten. (Siehe VarintValue)
• WPF: Hexeditor zum Anzeigen der Rohnutzlast und des Markierungsdarks
• Stringerkennungstricks aus Mildsunrise/Protobuf-Inspektor