Frida Workbench per VSCode

Repository | Issues | Install

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 iOS)

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

Installare frida-tools

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

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

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

Funzionalità

Elenco App e Processi

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

Pannelli Runtime Interattivi

Browser Moduli ed Export

Sfoglia i moduli nativi caricati e le loro funzioni esportate per qualsiasi processo a cui è stato effettuato l'attach. Filtra i moduli per nome, ispeziona l'indirizzo base, la dimensione e il percorso, quindi seleziona gli export per la generazione degli hook.

Browser Classi e Metodi

Esplora le classi e i metodi runtime sia per Java che per Objective-C. Filtra le classi, alterna tra metodi propri ed ereditati e seleziona in batch i metodi per la generazione degli 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 runtime
• Java — genera stub di classi decompilate con istruzioni package e import

Generazione di Hook

Genera codice hook Frida dai pannelli Moduli e Classi:

• Hook nativi — Interceptor.attach() con callback onEnter / onLeave per funzioni esportate
• Hook Objective-C — hook basati su classe e selettore con corretto utilizzo del bridge ObjC
• Hook Java — hook Java.perform() / Java.use() con supporto agli overload dei metodi
• Hook potenziati dall'AI — usa GitHub Copilot per inferire le firme delle funzioni native (tipi dei parametri, tipi di ritorno) e generare logging degli argomenti type-aware

Autocompletamento Intelligente (LSP)

Completamenti context-aware per script Frida in JavaScript / TypeScript:

• ObjC.classes.<ClassName> — completa i nomi delle classi Objective-C
• ObjC.classes.Foo['<method>'] — completa i selettori dei metodi
• 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 di un processo target. Devi creare un file di configurazione .vscode/frida.json nel tuo workspace. Il modo più semplice è cliccare con il tasto destro su un processo o un'app nella barra laterale e selezionare Set LSP Target, che genera il file automaticamente.

Configurazione .vscode/frida.json

Il file specifica a quale dispositivo e target l'LSP deve effettuare l'attach. Richiede un campo device e esattamente uno tra app, pid o process.

Attach tramite identificatore dell'app (consigliato — esegue lo spawn o l'attach all'app):

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

Attach tramite nome del processo:

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

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

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

Il valore di device corrisponde all'ID del dispositivo Frida — local per la macchina host, un ID di Simulator o dispositivo USB, o una stringa host:port per dispositivi remoti.

L'LSP monitora questo file per le modifiche. Modificarlo o ricrearlo riavvia automaticamente il language server con il nuovo target.

Syslog

Trasmetti in streaming i log dell'applicazione in tempo reale dai processi a cui è stato effettuato l'attach.

Scaffolding del Progetto

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

Configurazione di Debug

Genera launch.json e tasks.json di VSCode per il debug degli script Frida con breakpoint.

Strumenti Android

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

Integrazione con Strumenti Esterni

• Objection — Runtime Mobile Exploration

Shell

Per i dispositivi Android, Open 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