Frida Workbench für VSCode

Repository | Issues | Installieren

Dies ist ein von der Community beigesteuertes Projekt, das nicht mit dem offiziellen Frida-Team verbunden ist. Es wird von @CodeColorist als Open-Source-Erweiterung für Visual Studio Code entwickelt und gepflegt, um die Frida-Skripterfahrung zu verbessern.

中文说明

Voraussetzungen

• Python >= 3.7
• frida-tools Python-Paket

Optionale Abhängigkeiten

• libimobiledevice (für den Befehl inetcat, um eine SSH-Shell zu starten)
• iTunes unter Windows (für iOS-USB-Verbindung)

Wenn Sie Windows verwenden, müssen Sie iTunes geöffnet lassen, um über USB mit iOS-Geräten zu interagieren.

frida-tools installieren

Aufgrund von PEP0668 kann beim globalen Ausführen von pip3 install frida-tools ein Fehler auftreten.

Der empfohlene Weg ist, einen Ordner (Workspace) in VSCode zu öffnen und dann mit der Python-Erweiterung eine virtuelle Umgebung zu erstellen und zu aktivieren. In diesem Fall verwendet die Erweiterung Ihre aktuell aktive Python-venv, um Frida-Befehle zu laden.

Alternativ können Sie einen Paketmanager wie pipx oder UV verwenden, um es in $PATH zu installieren und dabei isoliert zu halten.

Funktionen

Liste der Apps und Prozesse

Listet Apps und Prozesse auf verbundenen Geräten in einem Seitenleisten-Panel auf. Rechtsklick zum Anhängen, Anhängen mit erhöhten Rechten für lokale Ziele, Starten, Starten im suspendierten Modus, Beenden von Prozessen oder Kopieren von Geräte-/Prozessinformationen in die Zwischenablage. Unterstützt lokale Geräte, Apple Simulator, USB und Remote-Geräte. Lokale Prozesseinträge enthalten nach bestem Bemühen Metadaten wie ausführbaren Pfad, Eigentümer, übergeordnete PID und Argumente, sofern verfügbar.

Interaktive Laufzeit-Panels

Module & Exporte-Browser

Durchsuchen Sie geladene native Module und ihre exportierten Funktionen für jeden angehängten Prozess. Filtern Sie Module nach Namen, prüfen Sie Basisadresse, Größe und Pfad und wählen Sie dann Exporte für die Hook-Generierung aus.

Klassen & Methoden-Browser

Erkunden Sie Laufzeitklassen und -methoden sowohl für Java als auch für Objective-C. Filtern Sie Klassen, wechseln Sie zwischen eigenen und geerbten Methoden und wählen Sie Methoden stapelweise für die Hook-Generierung aus. Enthält außerdem Objective-C-Protokollinspektion zum Durchsuchen und Analysieren von Protokollen.

Header generieren

Klassen-Header für Reverse Engineering ausgeben:

• Objective-C — Header-Dateien aus Laufzeit-Klassenmetadaten generieren
• Java — dekompilierte Klassen-Stubs mit Paket- und Import-Anweisungen generieren

Hook-Generierung

Frida-Hook-Code aus den Modul- und Klassen-Panels generieren:

• Native Hooks — Interceptor.attach() mit onEnter / onLeave-Callbacks für exportierte Funktionen
• Objective-C-Hooks — klassen- und selektorbasierte Hooks mit korrekter ObjC-Bridge-Nutzung
• Java-Hooks — Java.perform() / Java.use()-Hooks mit Unterstützung für Methodenüberladungen
• KI-gestützte Hooks — GitHub Copilot verwenden, um native Funktionssignaturen (Parametertypen, Rückgabetypen) abzuleiten und typsichere Argumentprotokollierung zu generieren

Intelligente Autovervollständigung (LSP)

Kontextbezogene Vervollständigungen für Frida-Skripte in JavaScript / TypeScript:

• ObjC.classes.<ClassName> — vervollständigt Objective-C-Klassennamen
• ObjC.classes.Foo['<method>'] — vervollständigt Methodenselektoren
• ObjC.classes.Foo.method — vervollständigt Klassemethodenselektoren
• Java.use('<ClassName>') — vervollständigt Java-Klassennamen
• Process.getModuleByName('<name>') — vervollständigt Namen geladener Module

Der Language Server ist von einem Zielprozesskontext abhängig. Sie müssen eine Konfigurationsdatei .vscode/frida.json in Ihrem Workspace erstellen. Der einfachste Weg ist, mit der rechten Maustaste auf einen Prozess oder eine App in der Seitenleiste zu klicken und Set LSP Target auszuwählen, wodurch die Datei automatisch generiert wird.

.vscode/frida.json-Konfiguration

Die Datei gibt an, an welches Gerät und Ziel der LSP sich anhängen soll. Sie erfordert ein device-Feld und genau eines von app, pid oder process.

Anhängen über App-Identifier (empfohlen — startet oder hängt sich an die App an):

{
    "device": "local",
    "app": "com.example.myapp"
}

Anhängen über Prozessnamen:

{
    "device": "local",
    "process": "myprocess"
}

Anhängen über PID (nützlich, wenn mehrere Prozesse denselben Namen teilen):

{
    "device": "local",
    "pid": 1234
}

Der device-Wert entspricht der Frida-Geräte-ID — local für den Host-Rechner, eine Simulator- oder USB-Geräte-ID oder ein host:port-String für Remote-Geräte.

Der LSP überwacht diese Datei auf Änderungen. Das Bearbeiten oder Neuerstellen startet den Language Server automatisch mit dem neuen Ziel neu.

Syslog

Streamen Sie Echtzeit-Anwendungsprotokolle von angehängten Prozessen.

Projekt-Gerüst

• New Agent — ein neues Frida-Agent-Projekt mit TypeScript-Unterstützung erstellen
• New C Module — ein neues Frida-C-Modul-Projekt erstellen
• Download Typings — Frida-TypeScript-Typdefinitionen für die Autovervollständigung herunterladen

Debug-Konfiguration

Generieren Sie VSCode launch.json und tasks.json zum Debuggen von Frida-Skripten mit Breakpoints.

Android-Tools

• frida-server herunterladen und starten auf einem Android-Gerät (automatische Architekturerkennung)
• APK vom Gerät abrufen (Rechtsklick auf eine Android-App zum Abrufen)

Integration externer Tools

• Objection — Runtime Mobile Exploration

Shell

Für Android-Geräte ist Open Shell ein Wrapper für adb shell.

Für iOS bietet es eine SSH-Shell auf jailbroken Geräten. Möglicherweise müssen Anmeldedaten konfiguriert werden.

Unterstützung für Remote-Geräte

Verbinden Sie sich direkt über die Seitenleiste über host:port mit Remote-Frida-Geräten.

CHANGELOG

Mitwirkende