Voltron

Voltron ist ein erweiterbares Debugger-UI-Toolkit, das in Python geschrieben ist. Es zielt darauf ab, die Benutzererfahrung verschiedener Debugger (LLDB, GDB, VDB und WinDbg) zu verbessern, indem es das Anhängen von Hilfsansichten ermöglicht, die Daten vom Debugger-Host abrufen und anzeigen können. Durch das Ausführen dieser Ansichten in anderen TTYs können Sie eine angepasste Debugger-Benutzeroberfläche erstellen, die Ihren Anforderungen entspricht.

Voltron möchte nicht für jeden alles sein. Es ist kein vollständiger Ersatz für die CLI Ihres Debuggers. Vielmehr soll es Ihre bestehende Einrichtung ergänzen und Ihnen erlauben, Ihren CLI-Debugger so viel oder so wenig zu erweitern, wie Sie möchten. Wenn Sie nur eine Ansicht der Registerinhalte in einem Fenster neben Ihrem Debugger haben möchten, können Sie das tun. Wenn Sie alles geben und etwas haben möchten, das eher wie OllyDbg aussieht, können Sie das auch tun.

Es werden integrierte Ansichten für Folgendes bereitgestellt:

• Registers
• Disassembly
• Stack
• Memory
• Breakpoints
• Backtrace

Die Einrichtung des Autors sieht ungefähr so aus:

Jeder Debugger-Befehl kann in eine Ansicht aufgeteilt und mit einem angegebenen Pygments-Lexer hervorgehoben werden:

Weitere Screenshots finden Sie hier.

Support

Voltron unterstützt LLDB, GDB, VDB und WinDbg/CDB (über PyKD) und läuft auf macOS, Linux und Windows.

Die WinDbg-Unterstützung ist noch relativ neu, bitte eröffnen Sie ein Issue, wenn Sie Probleme haben.

Die folgenden Architekturen werden unterstützt:

Installation

Hinweis: Nur macOS und Debian-Abkömmlinge werden vom Installationsskript vollständig unterstützt. Es sollte hoffentlich auf anderen Linux-Distributionen nicht fehlschlagen, aber es wird nicht versuchen, Paketabhängigkeiten zu installieren. Wenn Sie eine andere Distribution verwenden, werfen Sie einen Blick auf install.sh, um herauszufinden, welche Abhängigkeiten Sie vor der Ausführung installieren müssen.

Laden Sie den Quellcode herunter und führen Sie das Installationsskript aus:

$ git clone https://github.com/snare/voltron
$ cd voltron
$ ./install.sh

Standardmäßig installiert das Skript in das site-packages-Verzeichnis des Benutzers. Wenn Sie in das systemweite site-packages installieren möchten, verwenden Sie das Flag -s:

$ ./install.sh -s

Sie können auch in eine virtuelle Umgebung (nur für LLDB) installieren, wie folgt:

$ ./install.sh -v /path/to/venv -b lldb

Wenn Sie Windows ohne Shell verwenden, Installationsprobleme haben oder eine manuelle Installation bevorzugen, lesen Sie bitte die Dokumentation zur manuellen Installation.

Quick Start

1. Wenn Ihr Debugger ein Init-Skript hat (.lldbinit für LLDB oder .gdbinit für GDB), konfigurieren Sie es so, dass Voltron beim Start geladen wird, indem Sie das Einstiegspunkt-Skript entry.py einbinden. Der vollständige Pfad befindet sich innerhalb des voltron-Pakets. Auf macOS könnte er beispielsweise /Library/Python/2.7/site-packages/voltron/entry.py sein. Das Skript install.sh fügt dies automatisch zu Ihrer .gdbinit oder .lldbinit hinzu, wenn es GDB oder LLDB in Ihrem Pfad erkennt.

   LLDB:

   root@kitploit:~

    command script import /path/to/voltron/entry.py
   

   GDB:

   root@kitploit:~

    source /path/to/voltron/entry.py
   

2. Starten Sie Ihren Debugger und initialisieren Sie Voltron bei Bedarf manuell.

   Bei neueren Versionen von LLDB müssen Sie Voltron nicht manuell initialisieren:

   root@kitploit:~

    $ lldb target_binary
   

   Bei älteren Versionen von LLDB müssen Sie voltron init aufrufen, nachdem Sie das Ziel geladen haben:

Dokumentation

Siehe das Wiki auf GitHub.

FAQ

F. Warum erhalte ich einen ImportError beim Laden von Voltron?

A. Möglicherweise haben Sie mehrere Python-Versionen installiert und Voltron mit der falschen installiert. Siehe die ausführlicheren Installationsanweisungen.

F. GEF? PEDA? PwnDbg? fG's gdbinit?

A. Alles großartige Erweiterungen für GDB. Diese Tools bieten hauptsächlich zusätzliche Befehle für Exploitation-Aufgaben, aber jedes bietet auch eine „Kontext“-Anzeige mit einer Ansicht von Registern, Stapel, Code usw., ähnlich wie Voltron. Diese Tools geben ihre Kontextanzeige in der Debugger-Konsole jedes Mal aus, wenn der Debugger anhält. Voltron verfolgt einen anderen Ansatz, indem es einen RPC-Server-Implantat in den Debugger einbettet und das Anhängen von Ansichten von anderen Terminals (oder sogar Webbrowsern oder jetzt Synchronisation mit Binary Ninja) ermöglicht, was dem Benutzer erlaubt, eine sauberere Multi-Fenster-Oberfläche für seinen Debugger zu erstellen. Voltron funktioniert hervorragend zusammen mit all diesen Tools. Sie können einfach die Kontextanzeige in Ihrer bevorzugten GDB-Erweiterung deaktivieren und einige Voltron-Ansichten einrichten, während Sie dennoch von allen nützlichen Befehlen profitieren, die diese Tools hinzufügen.

Fehler und Errata

Siehe den Issue-Tracker auf GitHub für weitere Informationen oder um Probleme zu melden.

Wenn Sie beim Laden von Voltron einen ImportError erhalten, stellen Sie bitte sicher, dass Sie die Installationsanweisungen für Ihre Plattform befolgt haben.

LLDB

Bei älteren Versionen von LLDB muss der Befehl voltron init manuell ausgeführt werden, nachdem das Debug-Ziel geladen wurde, da ein Ziel geladen werden muss, bevor Voltrons Hooks installiert werden können. Voltron versucht, seinen Event-Handler automatisch zu registrieren und informiert den Benutzer, wenn voltron init erforderlich ist.

WinDbg

Weitere Informationen zur WinDbg/CDB-Unterstützung hier.

Sonstiges

Die Autoren verwenden Voltron hauptsächlich mit der aktuellsten Version von LLDB auf macOS. Wir werden versuchen, vor Veröffentlichungen alles auf so vielen Plattformen und Architekturen wie möglich zu testen, aber LLDB/macOS/x64 wird mit Abstand die am häufigsten verwendete Kombination sein. Hoffentlich setzt Voltron Ihre Haustiere nicht in Brand, aber Ihre Erfahrung kann abweichen.

Lizenz

Siehe die LIZENZ-Datei.

Wenn Sie dies verwenden und es nicht hassen, kaufen Sie mir irgendwann auf einer Konferenz ein Bier. Diese Lizenz gilt auch für andere Mitwirkende – richo hat definitiv ein paar Biere für seine Beiträge verdient.

Danksagungen

Danke an meine ehemaligen Arbeitgeber Assurance und Azimuth Security, dass sie mir Zeit gegeben haben, an diesem Projekt zu arbeiten.

Respekt an richo für all seine Beiträge zu Voltron.

Das gdbinit von fG! war die ursprüngliche Inspiration für dieses Projekt.

Danke an Willi für die Implementierung der VDB-Unterstützung.

Voltron verwendet jetzt Capstone für die Disassemblierung sowie den internen Disassemblierungsmechanismus der Debugger-Hosts. Capstone ist ein leistungsstarker, quelloffener, multi-Architektur-Disassembler, auf dem die nächste Generation von Reverse-Engineering- und Debugging-Tools aufbaut. Schauen Sie es sich an.

Danke an grazfather für die laufenden Beiträge.