Chinois | English

ZAFrida UI - Plugin Frida pour PyCharm

Version actuelle : 0.3.6

Présentation du projet

Outil graphique Frida conçu pour PyCharm / IntelliJ

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

Son point fort principal est son « système de gestion de modèles par cases à cocher » : l'utilisateur peut, en cochant/décochant des cases, insérer dynamiquement des extraits de code dans le script principal ou les commenter, réalisant ainsi un assemblage de scripts Hook « en briques ». Par ailleurs, le plugin intègre une gestion complète par projet (zafrida-project.xml) permettant de basculer rapidement entre plusieurs configurations d'appareils et d'environnements.

ZAFrida ne remplace pas Frida, mais sert de puissante interface graphique pour frida-tools, s'interfaçant de manière transparente avec votre environnement Python et Frida existant.

Wiki simplifié : ZAFrida UI 简易 Wiki (BBS) (ceci est un Wiki encore 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 un disque.
2. Configurer l'environnement : ouvrez Settings -> Tools -> ZAFrida et configurez le chemin de l'exécutable frida (s'il n'est pas détecté automatiquement).
3. Créer un projet : faites un clic droit dans la vue Projet -> New Frida Project.
4. Écrire/sélectionner un script : dans le panneau Run, sélectionnez votre agent.js.
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 : passez à l'onglet Templates, cochez la fonctionnalité Hook souhaitée (par ex. « SSL Pinning Bypass ») et le code sera automatiquement injecté dans votre script.
7. Automatisation Skills (optionnelle) : 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 démarrer/arrêter manuellement). Emplacement de la CLI et des modèles :
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

Code QR du groupe de discussion

Fonctionnalités

• Gestion des appareils et processus
  Intègre frida-ls-devices et frida-ps, permet d'actualiser la liste des appareils en un clic, d'afficher les processus en cours d'exécution, les applications en cours ou les applications installées.

• Connexion multimode
  Prend en charge les modes USB / Remote / Gadget, avec configuration personnalisée du Host et du Port distant, sans avoir à assembler manuellement des paramètres de ligne de commande complexes.

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

  • Prend en charge deux actions : Run (Spawn par défaut) et Attach, plutôt qu'un simple « changement de mode ».
  • Prend en charge Force Stop pour forcer l'arrêt de l'application cible.
  • Sortie de logs dans la console intégrée, avec sauvegarde automatique dans le répertoire du projet zafrida-logs/.

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

  • Dans la zone d'édition d'un fichier JS Frida, faites un clic droit pour sélectionner :
    • Run Frida JS : exécute le fichier JS actuel comme script principal (Spawn par défaut).
    • Attach Frida JS : injecte le fichier JS actuel comme script annexe dans un processus cible déjà en cours.
  • Avant l'exécution, le fichier actuel est automatiquement sauvegardé et le projet ZAFrida correspondant est activé.
  • Idéal pour les PoC rapides, les démos, le mode Gadget ou l'injection instantanée dans des processus en cours.
  • Raccourcis clavier :
    • Windows / Linux : Ctrl + Alt + S
    • macOS : ⌘ + ⌥ + S

Cas d'utilisation

ZAFrida UI convient à tous les scénarios de rétro-ingénierie utilisant Frida, en particulier :

• Tests de pénétration et analyse de rétro-ingénierie d'applications Android/iOS.
• Processus de débogage nécessitant des changements fréquents de scripts Hook.
• Ingénieurs habitués à utiliser un IDE (PyCharm/IDEA) pour le développement mixte Python et JS.

Documentation technique

• Prérequis :

  • IntelliJ IDEA ou PyCharm (recommandé 2024.3+)
  • 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.

• Retours de problèmes : Github Issues

Lancer le projet

1. Clonez la 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 lancer l'environnement de débogage.

Aperçu du système

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

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

Gestion des modèles dynamiques (Template Panel)

Catégories à gauche, cases à cocher au milieu, aperçu en temps réel à droite. Les cases activent/désactivent le contenu du script.

Interface des paramètres (Settings)

Prend en charge la personnalisation du chemin des outils Frida, de l'adresse de connexion distante et de la configuration des logs.

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 avec Gradle Kotlin DSL
• Framework : IntelliJ Platform SDK
• Outil de construction : Gradle
• Dépendances : frida frida-tools (environnement Python)

Remerciements

Remerciements particuliers aux contributeurs suivants pour leur support des modèles de scripts Frida JS :

• 小佳
• Lane
• 迷人

Pour plus de contributeurs et de remerciements, veuillez consulter : CONTRIBUTORS.md