中文 | English

ZAFrida UI - Plugin Frida pour PyCharm

Version actuelle : 0.3.7

Principales mises à jour de la version 0.3.7

• Chaque projet ZAFrida peut sélectionner ou partager indépendamment son environnement Python/Frida, en utilisant par défaut l'interpréteur du projet PyCharm actuel, avec prise en charge des environnements locaux venv, Conda, uv, Poetry, Pipenv, Hatch, etc.
• Refonte de l'interface de session et des paramètres de projet, affichage complet des versions du plugin, de Python et de Frida, avec optimisation du panneau de journaux adaptatif et déplaçable ainsi que de l'état de session.
• Prise en charge complète des fichiers .js / .ts, de Frida 16/17, du basculement entre environnements multi-projets, ainsi que des trois flux de connexion USB, Remote et Gadget.
• Renforcement de l'API HTTP locale, de la CLI et des compétences en chinois pour la récupération d'appareils, l'attente de session et les journaux incrémentaux ; suppression de la couche d'adaptation MCP redondante et instable.

Présentation du projet

Outil graphique Frida conçu pour PyCharm/IntelliJ

ZAFrida UI est un plugin d'opération graphique Frida intégré dans PyCharm et les IDE de la série JetBrains. Il vise à résoudre les problèmes d'opérations en ligne de commande Frida fastidieuses et de gestion chaotique des scripts, en fournissant une interface UI complète pour gérer les appareils, les processus, les scripts et les journaux.

Le point fort principal réside dans son système de gestion de modèles "à cases à cocher" : l'utilisateur peut, en cochant/décochant, insérer dynamiquement des extraits de code dans le script principal ou les commenter, réalisant ainsi un assemblage de scripts Hook "en blocs". Parallèlement, le plugin intègre une gestion complète par projets (zafrida-project.xml), prenant en charge le basculement rapide entre plusieurs configurations d'appareils et d'environnements.

ZAFrida ne remplace pas Frida, mais agit comme une interface UI puissante pour frida-tools, s'intégrant de manière transparente à votre environnement Python et Frida existant.

Wiki simplifié : Wiki simplifié ZAFrida UI (BBS) (il s'agit du Wiki le plus simple) Tutoriel détaillé : Wiki du tutoriel détaillé ZAFrida UI

Démonstration

Démarrage rapide

1. Installer le plugin : Recherchez "ZAFrida" dans le marché des plugins de l'IDE ou installez-le depuis le disque.
2. Configurer l'environnement par défaut : Utilisez par défaut l'interpréteur Python du projet PyCharm actuel ; les Settings globaux -> Tools -> ZAFrida ne conservent que les valeurs par défaut du nom/chemin de l'outil.
3. Créer un projet : Clic droit dans la vue projet -> New Frida Project.
   • Si ce projet nécessite une version différente de Frida, ouvrez les Project Settings de ZAFrida, sélectionnez l'interpréteur Python ou le répertoire d'environnement et cliquez sur Test.
4. Écrire/sélectionner un script : Dans le panneau Run, sélectionnez votre agent.js ou agent.ts.
5. Débogage Hook :

• Connectez l'appareil (USB, Remote ou Gadget).
• Sélectionnez le processus cible ou le nom du package.
• Cliquez sur Run.

6. Utiliser les modèles : Basculez sur l'onglet Templates, cochez les fonctions Hook dont vous avez besoin (par exemple "SSL Pinning Bypass"), le code sera automatiquement injecté dans votre script.
7. Automatisation Skills (optionnel) : Désactivée par défaut. Allez dans Settings/Preferences -> ZAFrida -> Skills HTTP API, cochez Enable Skills pour démarrer automatiquement l'API locale (vous pouvez aussi la démarrer/arrêter manuellement Start/Stop), emplacements CLI et modèles :
   • Skill et CLI principal : skills-template/zafrida-http-control/
   • Lanceur de compatibilité d'ancien chemin : skills-cli/zafrida_skill_cli.py

Code QR du groupe de discussion

Fonctionnalités

• Gestion des appareils et des processus
  Intègre frida-ls-devices et frida-ps, prend en charge l'actualisation en un clic de la liste des appareils, l'affichage des processus en cours, des applications en cours d'exécution ou des applications installées.

• Connexion multi-modes
  Prise en charge complète des modes USB / Remote / Gadget, avec prise en charge d'un Host et d'un Port distants personnalisés, sans avoir à assembler manuellement des paramètres de ligne de commande complexes.

• Exécution interactive de scripts (Run / Attach)

  • Prend en charge les actions d'exécution Run (Spawn par défaut) et Attach, plutôt qu'un simple "basculement de mode".
  • Prend en charge Force Stop pour arrêter de force l'application cible.
  • Sortie de journal de console intégrée, avec sauvegarde automatique des journaux dans le répertoire du projet zafrida-logs/.

• Menu contextuel de l'éditeur JS / TypeScript (important)

  • Dans la zone d'édition des fichiers Frida .js ou .ts, un clic droit permet de sélectionner directement :
    • Run Frida Script : exécute le fichier actuel comme script principal (Spawn par défaut).
    • Attach Frida Script : injecte le fichier actuel comme script d'attachement dans le processus cible déjà en cours d'exécution.
  • Avant l'exécution, le fichier actuel est automatiquement enregistré et le projet ZAFrida auquel appartient le script est automatiquement activé.
  • Idéal pour les PoC rapides, la validation de démos, le mode Gadget ou l'injection immédiate dans des processus déjà en cours.
  • Raccourcis clavier :

Scénarios d'utilisation

ZAFrida UI convient à tous les scénarios d'ingénierie inverse utilisant Frida, en particulier :

• Tests d'intrusion et analyse inverse d'applications Android / iOS.
• Processus de débogage nécessitant un basculement fréquent entre différents scripts Hook.
• Ingénieurs habitués à utiliser des IDE (PyCharm/IDEA) pour le développement mixte Python, JavaScript et TypeScript.

Documentation technique

• Prérequis :

  • IntelliJ IDEA ou PyCharm (2024.3+ recommandé)
  • Python3 et frida-tools installés localement (pip install frida-tools)
  • Assurez-vous que frida, frida-ps, frida-ls-devices sont dans le PATH système ou spécifiez leur chemin dans les paramètres du plugin.

• Retour de problèmes : Github Issues

Démarrage du projet

1. Clonez le code source : git clone https://github.com/yilongmd/zafrida-ui.git
2. Ouvrez le projet avec IntelliJ IDEA.
3. Exécutez la tâche Gradle runIde pour démarrer l'environnement de débogage.

Aperçu du système

Interface principale et panneau d'exécution (Run Panel)

Fournit la sélection d'appareil, la sélection de script, la configuration du mode d'exécution et la sortie console.

Gestion des modèles dynamiques (Template Panel)

Sélectionnez la catégorie à gauche, cochez les modèles au centre, aperçu du code en temps réel à droite. Les cases à cocher contrôlent directement l'activation ou non du contenu du script.

Interface de paramètres (Settings)

Prend en charge la personnalisation des chemins des outils Frida, de l'adresse de connexion distante et de la configuration des journaux.

Assistant de création de projet

Crée rapidement une structure de projet Frida standardisée.

Architecture technique

Environnement de développement

• Langage : Java 21, Java, scripts de construction en Gradle Kotlin DSL
• Framework : IntelliJ Platform SDK
• Outil de construction : Gradle
• Dépendances : frida frida-tools (environnement Python)

Remerciements

Un merci particulier aux personnes suivantes pour leur soutien en modèles de scripts Frida JS pour ce projet :

• Xiao Jia
• Lane
• Mi Ren

Pour plus de contributeurs et d'informations de remerciements, voir : CONTRIBUTORS.md