中文 | English

ZAFrida UI - Plugin Frida per PyCharm

Versione corrente: 0.3.6

Descrizione del progetto

Strumento grafico Frida progettato appositamente per PyCharm/IntelliJ

ZAFrida UI è un plugin grafico per Frida integrato in PyCharm e altri IDE JetBrains. È nato per risolvere la complessità dell'uso da riga di comando di Frida e la gestione caotica degli script, offrendo un'interfaccia UI completa per gestire dispositivi, processi, script e log.

Il punto di forza principale è il "sistema a caselle di controllo" per la gestione dei template: l'utente può attivare/disattivare i template per inserire dinamicamente frammenti di codice nello script principale o commentarli, realizzando un assemblaggio "a blocchi" degli script di Hook. Inoltre, il plugin include una gestione completa a progetto (zafrida-project.xml), supportando il rapido passaggio tra configurazioni multi-dispositivo e multi-ambiente.

ZAFrida non sostituisce Frida, ma funge da potente shell UI per frida-tools, integrandosi perfettamente con l'ambiente Python e Frida esistente.

Wiki semplificato: ZAFrida UI Wiki semplice (BBS) (Wiki più semplice) Tutorial dettagliato: Wiki tutorial dettagliato ZAFrida UI

Dimostrazione

Guida rapida

1. Installa il plugin: Cerca "ZAFrida" nel marketplace dei plugin dell'IDE o installalo da disco.
2. Configura l'ambiente: Vai su Settings -> Tools -> ZAFrida, configura il percorso dell'eseguibile frida (se non viene rilevato automaticamente).
3. Crea un progetto: Tasto destro nella vista progetti -> New Frida Project.
4. Scrivi/Seleziona script: Nel pannello Run seleziona il tuo agent.js.
5. Hook e debug:

• Collega il dispositivo (USB o Remote o Gadget).
• Seleziona il processo o il nome del pacchetto target.
• Clicca su Run.

6. Usa i template: Passa alla scheda Templates, seleziona le funzioni di Hook desiderate (es. "SSL Pinning Bypass"), il codice verrà automaticamente iniettato nel tuo script.
7. Automazione Skills (opzionale): Disabilitata per impostazione predefinita. Vai su Settings/Preferences -> ZAFrida -> Skills HTTP API, spunta Enable Skills per avviare automaticamente l'API locale (puoi anche avviarla/fermarlo manualmente). Posizione CLI e template:
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

Codice QR del gruppo di discussione

Caratteristiche

• Gestione di dispositivi e processi Integra frida-ls-devices e frida-ps, supporta l'aggiornamento rapido della lista dei dispositivi, la visualizzazione dei processi in esecuzione, delle app attive o delle applicazioni installate.

• Connessione multi-modalità Supporto completo per le modalità USB / Remote / Gadget; è possibile personalizzare host e porta remote, senza dover compilare manualmente complessi parametri da riga di comando.

• Esecuzione interattiva degli script (Run / Attach)

  • Supporta due azioni: Run (Spawn predefinito) e Attach, non una semplice "modalità".
  • Supporta Force Stop per fermare forzatamente l'app target.
  • Console integrata per l'output dei log, con salvataggio automatico nella directory del progetto zafrida-logs/.

• Menu contestuale dell'editor JS (importante)

  • Nell'area di modifica dei file JS Frida, con il tasto destro è possibile selezionare:
    • Run Frida JS: esegue lo script JS corrente come script principale (Spawn predefinito).
    • Attach Frida JS: inietta lo script JS corrente come script aggiuntivo in un processo target già in esecuzione.
  • Prima dell'esecuzione il file viene salvato automaticamente e l'IDE passa automaticamente al progetto ZAFrida associato.
  • Ideale per PoC rapidi, demo, modalità Gadget o iniezione immediata in processi già avviati. Scorciatoie da tastiera:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S

• Inserimento Snippets dal menu contestuale dell'editor

Scenari d'uso

ZAFrida UI è adatto a tutti gli scenari di reverse engineering con Frida, in particolare:

• Test di penetrazione e analisi di app Android/iOS.
• Processi di debug che richiedono frequenti cambi di script di Hook.
• Ingegneri abituati a sviluppare in modo misto Python e JS con IDE (PyCharm/IDEA).

Documentazione tecnica

• Requisiti di sistema:

  • IntelliJ IDEA o PyCharm (consigliato 2024.3+)
  • Python3 installato localmente insieme a frida-tools (pip install frida-tools)
  • Assicurati che frida, frida-ps, frida-ls-devices siano nel PATH di sistema o specifica il percorso nelle impostazioni del plugin.

• Segnalazione problemi: Github Issues

Avvio del progetto

1. Clona il codice sorgente: git clone https://github.com/yilongmd/zafrida-ui.git
2. Apri il progetto con IntelliJ IDEA.
3. Esegui il task Gradle runIde per avviare l'ambiente di debug.

Schermate del sistema

Interfaccia principale e pannello di esecuzione (Run Panel)

Offre selezione dispositivo, selezione script, configurazione modalità di esecuzione e output console.

Gestione template dinamici (Template Panel)

A sinistra selezione categoria, al centro selezione template, a destra anteprima codice in tempo reale. Le caselle di controllo determinano se il codice dello script è attivo o meno.

Interfaccia impostazioni (Settings)

Supporta la personalizzazione del percorso degli strumenti Frida, indirizzo di connessione remota e configurazione dei log.

Procedura guidata di creazione progetto

Crea rapidamente una struttura di progetto Frida standardizzata.

Architettura tecnica

Ambiente di sviluppo

• Linguaggio: Java 21, Java, script di build con Gradle Kotlin DSL
• Framework: IntelliJ Platform SDK
• Strumento di build: Gradle
• Dipendenze: frida frida-tools (ambiente Python)

Ringraziamenti

Un ringraziamento speciale ai seguenti contributori per il supporto con i template di script JS Frida per questo progetto:

• Xiao Jia
• Lane
• Mi Ren

Per ulteriori informazioni su contributori e ringraziamenti, consultare: CONTRIBUTORS.md