Frida Workbench pour VSCode

Dépôt | Problèmes | Installer

Il s'agit d'un projet contribué par la communauté, non affilié à l'équipe officielle Frida. Il est développé et maintenu par @CodeColorist en tant qu'extension open-source pour Visual Studio Code afin d'améliorer l'expérience de script Frida.

中文说明

Prérequis

• Python >= 3.7
• Paquet Python frida-tools

Dépendances optionnelles

• libimobiledevice (pour la commande inetcat afin de démarrer un shell SSH)
• iTunes sous Windows (pour la connexion USB iOS)

Si vous êtes sous Windows, vous devez garder iTunes ouvert afin d'interagir avec les appareils iOS via USB.

Installer frida-tools

En raison de PEP0668, vous pourriez rencontrer une erreur lors de l'exécution de pip3 install frida-tools globalement.

La méthode recommandée consiste à ouvrir un dossier (espace de travail) dans VSCode, puis à créer et activer un environnement virtuel à l'aide de l'extension Python. Dans ce cas, l'extension utilisera votre environnement virtuel Python actif pour charger les commandes frida.

Alternativement, vous pouvez utiliser un gestionnaire de paquets comme pipx ou UV pour l'installer dans $PATH, tout en le gardant isolé.

Fonctionnalités

Liste des applications et processus

Listez les applications et processus sur les appareils connectés dans un panneau latéral. Faites un clic droit pour attacher, attacher avec des privilèges élevés pour les cibles locales, lancer, lancer en mode suspendu, tuer des processus, ou copier les informations de l'appareil/processus dans le presse-papiers. Prend en charge les appareils locaux, Apple Simulator, USB et distants. Les entrées de processus locaux incluent des métadonnées au mieux telles que le chemin de l'exécutable, le propriétaire, le PID parent et les arguments lorsqu'ils sont disponibles.

Panneaux d'exécution interactifs

Navigateur de modules et exports

Parcourez les modules natifs chargés et leurs fonctions exportées pour tout processus attaché. Filtrez les modules par nom, inspectez l'adresse de base, la taille et le chemin, puis sélectionnez les exports pour la génération de hooks.

Navigateur de classes et méthodes

Explorez les classes et méthodes d'exécution pour Java et Objective-C. Filtrez les classes, basculez entre les méthodes propres et héritées, et sélectionnez par lots les méthodes pour la génération de hooks. Inclut également l'inspection des protocoles Objective-C pour parcourir et analyser les protocoles.

Générer un en-tête

Extrayez les en-têtes de classe pour l'ingénierie inverse :

• Objective-C — générez des fichiers d'en-tête à partir des métadonnées de classe d'exécution
• Java — générez des stubs de classe décompilés avec les instructions de package et d'import

Génération de hooks

Générez du code de hook Frida à partir des panneaux Modules et Classes :

• Hooks natifs — Interceptor.attach() avec les callbacks onEnter / onLeave pour les fonctions exportées
• Hooks Objective-C — hooks basés sur la classe et le sélecteur avec une utilisation appropriée du pont ObjC
• Hooks Java — hooks Java.perform() / Java.use() avec prise en charge de la surcharge de méthodes
• Hooks assistés par IA — utilisez GitHub Copilot pour déduire les signatures de fonctions natives (types de paramètres, types de retour) et générer une journalisation d'arguments sensible aux types

Autocomplétion intelligente (LSP)

Complétions contextuelles pour les scripts Frida en JavaScript / TypeScript :

• ObjC.classes.<ClassName> — complète les noms de classes Objective-C
• ObjC.classes.Foo['<method>'] — complète les sélecteurs de méthodes
• ObjC.classes.Foo.method — complète les sélecteurs de méthodes de classe
• Java.use('<ClassName>') — complète les noms de classes Java
• Process.getModuleByName('<name>') — complète les noms de modules chargés

Le serveur de langage dépend d'un contexte de processus cible. Vous devez créer un fichier de configuration .vscode/frida.json dans votre espace de travail. Le plus simple est de faire un clic droit sur un processus ou une application dans la barre latérale et de sélectionner Set LSP Target, ce qui génère automatiquement le fichier.

Configuration .vscode/frida.json

Le fichier spécifie à quel appareil et à quelle cible le LSP doit s'attacher. Il nécessite un champ device et exactement l'un des champs app, pid ou process.

Attacher par identifiant d'application (recommandé — lance ou s'attache à l'application) :

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

Attacher par nom de processus :

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

Attacher par PID (utile lorsque plusieurs processus partagent le même nom) :

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

La valeur device correspond à l'ID de l'appareil Frida — local pour la machine hôte, un ID de Simulator ou d'appareil USB, ou une chaîne host:port pour les appareils distants.

Le LSP surveille ce fichier pour les modifications. Le modifier ou le recréer redémarre automatiquement le serveur de langage avec la nouvelle cible.

Syslog

Diffusez les journaux d'application en temps réel des processus attachés.

Échafaudage de projet

• Nouvel Agent — créez un nouveau projet Frida Agent avec prise en charge de TypeScript
• Nouveau module C — créez un nouveau projet Frida C Module
• Télécharger les typages — téléchargez les définitions de types TypeScript de Frida pour l'autocomplétion

Configuration de débogage

Générez les fichiers launch.json et tasks.json de VSCode pour déboguer les scripts Frida avec des points d'arrêt.

Outils Android

• Télécharger et démarrer frida-server sur un appareil Android (détection automatique de l'architecture)
• Extraire l'APK de l'appareil (clic droit sur une application Android pour extraire)

Intégration d'outils externes

• Objection — Exploration mobile à l'exécution

Shell

Pour les appareils Android, Open Shell est un wrapper pour adb shell.

Pour iOS, il fournit un shell SSH sur les appareils jailbreakés. Peut nécessiter la configuration des identifiants.

Prise en charge des appareils distants

Connectez-vous à des appareils Frida distants via host:port directement depuis la barre latérale.

CHANGELOG

Contributeurs