Chinesisch | English

ZAFrida UI - PyCharm Frida Plugin

Aktuelle Version: 0.3.6

Projektvorstellung

Speziell für PyCharm/IntelliJ entwickeltes grafisches Frida-Tool

ZAFrida UI ist ein in PyCharm und JetBrains-IDE integriertes grafisches Frida-Plugin. Es löst die Probleme der umständlichen Frida-Befehlszeilenbedienung und des chaotischen Skriptmanagements, indem es eine vollständige UI-Oberfläche zur Verwaltung von Geräten, Prozessen, Skripten und Logs bereitstellt.

Der Kernbestandteil ist das „Checkbox-basierte“ Template-Verwaltungssystem: Benutzer können durch An- und Abwählen dynamisch Codefragmente in das Hauptskript einfügen oder auskommentieren und so „bausteinartig“ Hook-Skripte zusammenstellen. Gleichzeitig verfügt das Plugin über eine vollständige Projektverwaltung (zafrida-project.xml), die einen schnellen Wechsel zwischen verschiedenen Geräte- und Umgebungskonfigurationen ermöglicht.

ZAFrida ersetzt Frida nicht, sondern dient als leistungsstarke UI-Hülle für frida-tools und lässt sich nahtlos in Ihre vorhandene Python- und Frida-Umgebung integrieren.

Einfache Wiki-Version: ZAFrida UI Einfaches Wiki (BBS) (das einfachere Wiki) Ausführliches Tutorial: ZAFrida UI Ausführliches Tutorial Wiki

Demo

Schnellstart

1. Plugin installieren: Suchen Sie im IDE-Plugin-Markt nach „ZAFrida“ oder installieren Sie es über die Festplatte.
2. Umgebung konfigurieren: Öffnen Sie Settings -> Tools -> ZAFrida und konfigurieren Sie den Pfad zur ausführbaren frida-Datei (falls nicht automatisch erkannt).
3. Projekt erstellen: Rechtsklick im Projektansicht -> New Frida Project.
4. Skript schreiben/auswählen: Wählen Sie im Run-Panel Ihre agent.js.
5. Hook-Debugging:

• Gerät verbinden (USB oder Remote oder Gadget).
• Zielprozess oder Paketnamen auswählen.
• Klicken Sie auf Run.

6. Vorlagen verwenden: Wechseln Sie zum Tab Templates und aktivieren Sie die gewünschten Hook-Funktionen (z. B. „SSL Pinning Bypass“). Der Code wird automatisch in Ihr Skript eingefügt.
7. Skills-Automatisierung (optional): Standardmäßig deaktiviert. Gehen Sie zu Settings/Preferences -> ZAFrida -> Skills HTTP API, aktivieren Sie Enable Skills, um die lokale API automatisch zu starten (auch manuell Start/Stop möglich). CLI- und Template-Standorte:
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

QR-Code der Community-Gruppe

Funktionen

• Geräte- und Prozessverwaltung
  Integriert frida-ls-devices und frida-ps. Unterstützt das Aktualisieren der Geräteliste mit einem Klick, Anzeigen laufender Prozesse, aktiver Apps oder installierter Anwendungen.

• Mehrere Verbindungsmodi
  Vollständige Unterstützung für USB / Remote / Gadget-Modi. Ermöglicht benutzerdefinierte Remote-Hosts und -Ports, ohne komplexe Befehlszeilenparameter manuell zusammensetzen zu müssen.

• Interaktive Skriptausführung (Run / Attach)

  • Unterstützt Run (Standard: Spawn) und Attach als separate Ausführungsaktionen, nicht als einfache „Modusumschaltung“.
  • Unterstützt Force Stop, um die Zielanwendung zwangsweise zu beenden.
  • Integrierte Konsolen-Logausgabe mit automatischer Speicherung im Projektverzeichnis zafrida-logs/.

• JS-Editor-Kontextmenü (wichtig)

  • Im Bearbeitungsbereich einer Frida-JS-Datei können Sie per Rechtsklick direkt Folgendes auswählen:
    • Run Frida JS: Führt die aktuelle JS-Datei als Hauptskript aus (Standard: Spawn).
    • Attach Frida JS: Injiziert die aktuelle JS-Datei als zusätzliches Skript in einen bereits laufenden Zielprozess.
  • Vor der Ausführung wird die aktuelle Datei automatisch gespeichert und zum zugehörigen ZAFrida-Projekt gewechselt.
  • Geeignet für schnelle PoC-, Demo-Verifizierung, Gadget-Modus oder sofortige Injektion in laufende Prozesse.
  • Tastenkombination:
    • Windows / Linux: Strg + Alt + S
    • macOS: ⌘ + ⌥ + S

Anwendungsszenarien

ZAFrida UI eignet sich für alle Szenarien des Reverse Engineering mit Frida, insbesondere:

• Penetrationstests und Reverse Engineering von Android/iOS-Apps.
• Debugging-Prozesse, bei denen häufig zwischen verschiedenen Hook-Skripten gewechselt werden muss.
• Entwickler, die es gewohnt sind, Python und JS im IDE (PyCharm/IDEA) zu entwickeln.

Technische Dokumentation

• Umgebungsanforderungen:

  • IntelliJ IDEA oder PyCharm (empfohlen 2024.3+)
  • Lokal installiertes Python3 und frida-tools (pip install frida-tools)
  • Stellen Sie sicher, dass frida, frida-ps, frida-ls-devices im System-PATH liegen oder in den Plugin-Einstellungen den Pfad angeben.

• Feedback: Github Issues

Projekt starten

1. Quellcode klonen: git clone https://github.com/yilongmd/zafrida-ui.git
2. Öffnen Sie das Projekt mit IntelliJ IDEA.
3. Führen Sie die Gradle-Aufgabe runIde aus, um die Debug-Umgebung zu starten.

System-Screenshots

Hauptoberfläche und Run-Panel

Bietet Geräteauswahl, Skriptauswahl, Ausführungsmoduskonfiguration und Konsolenausgabe.

Dynamische Template-Verwaltung (Template-Panel)

Links Kategorie auswählen, in der Mitte Vorlagen aktivieren, rechts Live-Vorschau des Codes. Die Checkboxen steuern, ob der Code im Skript wirksam ist.

Einstellungen (Settings)

Ermöglicht die Anpassung des Frida-Tool-Pfads, der Remote-Verbindungsadresse und der Log-Konfiguration.

Projekterstellungs-Assistent

Erstellen Sie schnell eine standardisierte Frida-Projektstruktur.

Technische Architektur

Entwicklungsumgebung

• Sprache: Java 21, Java, Build-Skripte mit Gradle Kotlin DSL
• Framework: IntelliJ Platform SDK
• Build-Tool: Gradle
• Abhängigkeiten: frida frida-tools (Python-Umgebung)

Danksagung

Besonderer Dank an die folgenden Personen für die Unterstützung mit Frida-JS-Skriptvorlagen für dieses Projekt:

• Xiao Jia
• Lane
• Mi Ren

Weitere Mitwirkende und Danksagungen finden Sie unter: CONTRIBUTORS.md