Frida Workbench per VSCode

Repository | Issues | Installa

Questo è un progetto contribuito dalla community, non affiliato al team ufficiale di Frida. È sviluppato e mantenuto da @CodeColorist come estensione open-source per Visual Studio Code per migliorare l'esperienza di scripting con Frida.

中文说明

Prerequisiti

• Python >= 3.7
• pacchetto Python frida-tools

Dipendenze opzionali

• libimobiledevice (per il comando inetcat per avviare una shell SSH)
• iTunes su Windows (per la connessione USB con iOS)

Se sei su Windows, devi tenere aperto iTunes per interagire con i dispositivi iOS tramite USB.

Installare frida-tools

A causa della PEP0668, potresti riscontrare un errore eseguendo pip3 install frida-tools a livello globale.

Il metodo consigliato è aprire una cartella (workspace) in VSCode, quindi creare e attivare un ambiente virtuale tramite l'estensione Python. In questo caso, l'estensione userà il tuo venv Python attivo per caricare i comandi frida.

In alternativa, puoi usare un gestore di pacchetti come pipx o UV per installarlo in $PATH, mantenendolo comunque isolato.

Funzionalità

Elenco di app e processi

Elenca app e processi sui dispositivi connessi in un pannello laterale. Fai clic con il tasto destro per agganciare, agganciare con privilegi elevati per target locali, avviare, avviare in modalità sospesa, terminare processi o copiare le informazioni su dispositivo/processo negli appunti. Supporta dispositivi locali, USB e remoti. Le voci dei processi locali includono metadati best-effort come percorso dell'eseguibile, proprietario, PID padre e argomenti quando disponibili.

Pannelli interattivi di runtime

Browser di moduli ed export

Sfoglia i moduli nativi caricati e le loro funzioni esportate per qualsiasi processo agganciato. Filtra i moduli per nome, ispeziona indirizzo di base, dimensione e percorso, quindi seleziona gli export per generare hook.

Browser di classi e metodi

Esplora classi e metodi di runtime sia per Java che per Objective-C. Filtra le classi, passa tra metodi propri ed ereditati e seleziona più metodi per la generazione di hook. Include anche l'ispezione dei protocolli Objective-C per sfogliare e analizzare i protocolli.

Genera header

Estrai gli header delle classi per il reverse engineering:

• Objective-C — genera file header dai metadati delle classi di runtime
• Java — genera stub di classi decompilate con dichiarazioni di package e import

Generazione di hook

Genera codice Frida per hook dai pannelli Moduli e Classi:

• Hook nativi — Interceptor.attach() con callback onEnter / onLeave per funzioni esportate
• Hook Objective-C — hook basati su classi e selettori con uso corretto del bridge ObjC
• Hook Java — hook con Java.perform() / Java.use() con supporto per gli overload dei metodi
• Hook basati su IA — usa GitHub Copilot per dedurre le firme delle funzioni native (tipi di parametri, tipi di ritorno) e generare log degli argomenti sensibili ai tipi

Autocompletamento intelligente (LSP)

Completamenti sensibili al contesto per script Frida in JavaScript / TypeScript:

• ObjC.classes.<ClassName> — completa i nomi delle classi Objective-C
• ObjC.classes.Foo['<method>'] — completa i selettori di metodo
• ObjC.classes.Foo.method — completa i selettori dei metodi di classe
• Java.use('<ClassName>') — completa i nomi delle classi Java
• Process.getModuleByName('<name>') — completa i nomi dei moduli caricati

Il language server dipende dal contesto del processo target. Devi creare un file di configurazione .vscode/frida.json nel tuo workspace. Il modo più semplice è fare clic con il tasto destro su un processo o un'app nella barra laterale e selezionare Imposta target LSP, che genera automaticamente il file.

Configurazione di .vscode/frida.json

Il file specifica a quale dispositivo e target il language server deve collegarsi. Richiede un campo device e esattamente uno tra app, pid o process.

Aggancio tramite identificatore dell'app (consigliato — avvia o aggancia l'app):

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

Aggancio tramite nome del processo:

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

Aggancio tramite PID (utile quando più processi condividono lo stesso nome):

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

Il valore device corrisponde all'ID del dispositivo Frida — local per la macchina host, usb per un dispositivo connesso via USB, oppure una stringa host:port per dispositivi remoti.

Il language server monitora questo file per rilevare modifiche. Modificarlo o ricrearlo riavvia automaticamente il language server con il nuovo target.

Syslog

Mostra in tempo reale i log applicativi dei processi agganciati.

Scaffolding del progetto

• Nuovo Agent — crea un nuovo progetto Frida Agent con supporto TypeScript
• Nuovo Modulo C — crea un nuovo progetto Frida C Module
• Scarica Typings — scarica le definizioni dei tipi TypeScript di Frida per l'autocompletamento

Configurazione di debug

Genera launch.json e tasks.json di VSCode per eseguire il debug di script Frida con punti di interruzione.

Strumenti Android

• Scarica e avvia frida-server su dispositivo Android (rilevamento automatico dell'architettura)
• Estrai APK dal dispositivo (fai clic con il tasto destro sull'app Android per estrarlo)

Integrazione con strumenti esterni

• Objection — Esplorazione mobile a runtime

Shell

Per i dispositivi Android, Apri Shell è un wrapper per adb shell.

Per iOS fornisce una shell SSH su dispositivi jailbroken. Potrebbe essere necessario configurare le credenziali.

Supporto dispositivi remoti

Connettiti a dispositivi Frida remoti tramite host:port direttamente dalla barra laterale.

CHANGELOG

Contributori