Frida UI

Un'interfaccia utente web moderna e leggera per Frida, progettata per il penetration testing di applicazioni Android. Permette di interagire con dispositivi, processi e script direttamente dal tuo browser.

Avvio rapido

# Installa usando uv (consigliato) o pipx/pip
uv tool install frida-ui
# Oppure: pipx install frida-ui
# Oppure: pip install frida-ui

# Avvia il server
frida-ui

Apri il browser e vai su: http://localhost:8000

Funzionalità

📱 Gestione dei dispositivi

• Rilevamento automatico: Rileva automaticamente i dispositivi USB e locali connessi.
• Dispositivi remoti: Aggiungi e gestisci facilmente server Frida remoti (es. 192.168.1.x:27042).
• Informazioni sul dispositivo: Visualizza parametri di sistema dettagliati (SO, Architettura, Livello API) e indicatori visivi del tipo di dispositivo selezionato.

🚀 Controllo di processi e app

• Elenco applicazioni: Visualizza le applicazioni installate e i processi in esecuzione.
• Ricerca: Filtraggio in tempo reale delle applicazioni per nome o identificatore.
• Gestione sessioni:
  • Attach: Connettiti a processi in esecuzione.
  • Spawn: Avvia applicazioni installate.
  • Spawn & Run: Avvia un'app e inietta immediatamente lo script dell'editor insieme a qualsiasi script CodeShare in coda (strumentazione precoce).
  • Kill/Detach: Termina i processi o disconnettiti in modo controllato.

💻 Scripting e strumentazione

• Editor di script: Editor integrato per scrivere script Frida. Include un editor Monaco opzionale per una modifica più ricca (evidenziazione della sintassi e layout automatico) con un fallback graduale a un semplice textarea.
• Caricamento file: Carica script da file locali o trascina e rilascia file .js nell'editor.
• Scarica script: Esporta il contenuto corrente dell'editor come file .js (frida-ui_<app id>_<timestamp>.js) direttamente dalla testata dell'editor.
• Integrazione CodeShare:
  • Importa script direttamente da Frida CodeShare.
  • Coda CodeShare: Metti in coda più script CodeShare per caricarli ed eseguirli automaticamente durante Spawn & Run o manualmente tramite il pulsante "Esegui script CodeShare".

📊 Console e logging

• Output in tempo reale: Visualizza console.log, messaggi send() ed errori dei tuoi script.
• Cronologia log: Log persistenti per sessione applicativa.
• Esportazione: Scarica i log della console come file .txt per l'analisi.

🎨 UI/UX

• Tema scuro: Interfaccia pulita e coerente in modalità scura.
• Persistenza: Ricorda il dispositivo, l'applicazione e le dimensioni dei pannelli selezionati tra una sessione e l'altra.
• Responsivo: Pannelli regolabili per sidebar, editor e console.
• Modalità focus: Attiva le viste Solo editor o Solo console per nascondere gli altri pannelli e lavorare senza distrazioni.
• Accessibilità: Scorciatoie da tastiera (es. Escape per ripristinare la vista o chiudere i sovrapposti) e supporto ARIA.

Per iniziare

Prerequisiti

• Python 3.7+
• uv (consigliato) / pipx / pip.

Installazione

Opzione 1: Installa da PyPI (consigliata)

uv tool install frida-ui

Puoi anche personalizzare la versione di Frida:

uv tool install frida-ui --with frida==16.7.19

Opzione 2: Installa dal sorgente (ultima versione)

uv tool install git+https://github.com/adityatelange/frida-ui

Puoi personalizzare la versione di Frida:

uv tool install git+https://github.com/adityatelange/frida-ui --with frida==16.7.19

[!IMPORTANT] La versione di Frida installata deve corrispondere alla versione di frida-server sul tuo dispositivo Android per garantire la compatibilità.

Esecuzione

Avvia il server con la configurazione predefinita:

frida-ui

Oppure con opzioni personalizzate:

frida-ui --host 127.0.0.1 --port 8000 --reload

• --host: Specifica l'host (predefinito: 127.0.0.1)
• --port: Specifica la porta (predefinito: 8000)
• --reload: Abilita il ricaricamento automatico per lo sviluppo

Apri http://localhost:8000 nel tuo browser.

Configurazione del dispositivo Android

Prima di usare frida-ui, devi avere frida-server in esecuzione sul tuo dispositivo Android. La versione di frida-server deve corrispondere alla versione di Frida installata nel passaggio precedente.

Opzione 1: Connessione USB

Se hai ADB installato e vuoi connetterti via USB:

1. Scarica frida-server: Visita Frida releases e scarica il binario frida-server per Android corrispondente all'architettura/abi del tuo dispositivo (es. frida-server-x.x.x-android-arm64.xz).

2. Estrai e invia al dispositivo:

   root@kitploit:~

   unxz frida-server-x.x.x-android-arm64.xz
   mv frida-server-x.x.x-android-arm64 frida-server
   adb push frida-server /data/local/tmp/
   

3. Esegui frida-server:

   root@kitploit:~

   adb shell "chmod 755 /data/local/tmp/frida-server"
   adb shell "/data/local/tmp/frida-server -D"
   

4. Verifica la connessione: Assicurati che il dispositivo sia collegato via USB e visibile con adb devices. frida-ui lo rileverà automaticamente durante l'esecuzione.

Opzione 2: Connessione remota (rete)

In alternativa, puoi eseguire frida-server con un listener di rete e connetterti da remoto:

1. Scarica ed esegui frida-server sul tuo dispositivo Android (usando qualsiasi metodo - ADB, script personalizzato, ecc.):

   root@kitploit:~

   ./frida-server -l 0.0.0.0:27042 -D
   

2. Aggiungi dispositivo remoto in frida-ui: Nell'interfaccia di frida-ui, aggiungi un dispositivo remoto con l'indirizzo IP e la porta su cui frida-server è in ascolto (es. 192.168.1.x:27042).

   Per questo metodo non è richiesta l'installazione di ADB.

Guida all'uso

1. Seleziona un dispositivo: Scegli un dispositivo dal menu a tendina nella testata superiore.
2. Seleziona un'app: Clicca su un'applicazione nella barra laterale.
3. Scrivi/Carica script:
   • Scrivi JS nell'editor.
   • Oppure trascina e rilascia un file.
   • Oppure aggiungi l'URL degli script da CodeShare.
4. Azione:
   • Clicca Attach per iniettare in un processo in esecuzione.
   • Clicca Spawn per avviare l'app.
   • Clicca Spawn & Run per avviare l'app con il tuo script iniettato immediatamente.
5. Monitora: Guarda la console per l'output.

💡 Script di esempio

Prova questo semplice script per agganciare un metodo (sostituisci con il tuo target):

// Esempio di hook di un metodo
Java.perform(() => {
  const MainActivity = Java.use("com.example.app.MainActivity");
  MainActivity.checkPassword.implementation = function (password) {
    console.log("[*] checkPassword chiamato con: " + password);
    return true; // Bypass del controllo
  };
});

Note

[!NOTE] Questo strumento è un progetto indipendente e non fa parte del set di strumenti ufficiale di Frida e non è sponsorizzato dal progetto Frida. È un'interfaccia utente di terze parti costruita per interagire con le funzionalità principali di Frida.

[!WARNING] Questo strumento permette di eseguire JavaScript arbitrario nei processi target. Esponi frida-ui solo a reti e utenti fidati. Eseguire script non fidati può compromettere il sistema e i dati. Il server web viene eseguito localmente per impostazione predefinita, ma espone potenti capacità di strumentazione.

Crediti

• Progetto Frida - https://frida.re/.
• Monaco Editor - https://microsoft.github.io/monaco-editor/.
• Grazie a Github Copilot per suggerimenti e miglioramenti del codice.

Stargazers nel tempo