日本語 | English

ZAFrida UI - PyCharm Frida Plugin

現在のバージョン： 0.3.6

プロジェクト紹介

PyCharm/IntelliJ 専用の Frida グラフィカルツール

ZAFrida UI は、PyCharm および JetBrains 系 IDE に統合された Frida グラフィカル操作プラグインです。Frida のコマンドライン操作の煩わしさやスクリプト管理の混乱を解消し、デバイス・プロセス・スクリプト・ログを管理するための完全な UI インターフェース を提供します。

中核となる特長は 「チェックボックス式」テンプレート管理システム です。ユーザーはチェック/チェック解除により、コードスニペットをメインスクリプトに動的に挿入したりコメントアウトしたりして、「ブロック遊び」のように Hook スクリプトを組み立てられます。同時に、プラグインは完全な プロジェクト管理 (zafrida-project.xml) を内蔵し、マルチデバイス・マルチ環境構成の素早い切り替えをサポートします。

ZAFrida は Frida を代替するものではなく、frida-tools の強力な UI ラッパーとして、既存の Python および Frida 環境とシームレスに連携します。

簡易版 Wiki： ZAFrida UI 簡易 Wiki (BBS)（より簡単な Wiki です） 詳細な使い方チュートリアル： ZAFrida UI 詳細な使い方チュートリアル Wiki

デモ

クイックスタート

1. プラグインのインストール: IDE プラグインマーケットで "ZAFrida" を検索、またはディスクからインストール。
2. 環境設定: Settings -> Tools -> ZAFrida を開き、frida 実行ファイルのパスを設定します（自動認識されない場合）。
3. プロジェクトの作成: プロジェクトビューで右クリック -> New Frida Project。
4. スクリプトの作成/選択: Run パネルで agent.js を選択します。
5. Hook デバッグ:

• デバイスに接続 (USB または Remote または Gadget)。
• ターゲットプロセスまたはパッケージ名を選択。
• Run をクリック。

6. テンプレートの使用: Templates タブに切り替え、必要な Hook 機能（例："SSL Pinning Bypass"）にチェックを入れると、コードが自動的にスクリプトに注入されます。
7. Skills 自動化（オプション）: デフォルトではオフ。Settings/Preferences -> ZAFrida -> Skills HTTP API で Enable Skills にチェックを入れるとローカル API が自動起動します（手動で Start/Stop も可能）。CLI とテンプレートの場所：
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

コミュニティグループ QR コード

機能特長

• デバイスとプロセス管理
  frida-ls-devices と frida-ps を統合。ワンクリックでデバイスリストを更新し、実行中のプロセス、動作中のアプリ、インストール済みアプリを表示。

• マルチモード接続
  USB / Remote / Gadget モードを完全サポート。カスタムリモート Host と Port を設定可能。複雑なコマンドライン引数を手動で組み立てる必要はありません。

• インタラクティブなスクリプト実行（Run / Attach）

  • Run（デフォルトは Spawn） と Attach の 2 つの実行アクションをサポート（単なる「モード切り替え」ではありません）。
  • Force Stop でターゲットアプリを強制停止できます。
  • 内蔵コンソールログ出力と、プロジェクトディレクトリ zafrida-logs/ への自動保存。

• JS エディター右クリックメニュー（重要）

  • Frida JS ファイルの編集領域で右クリックすると、以下を直接選択可能：
    • Run Frida JS：現在の JS ファイルをメインスクリプトとして実行（デフォルト Spawn）。
    • Attach Frida JS：現在の JS ファイルを追加スクリプトとして、実行中のターゲットプロセスに注入。
  • 実行前に自動的にファイルを保存し、スクリプトが属する ZAFrida Project に自動的に切り替えます。
  • 迅速な PoC、デモ検証、Gadget モード、または既に実行中のプロセスへの即時インジェクションに適しています。
  • ショートカットキー：
    • Windows / Linux：Ctrl + Alt + S
    • macOS：⌘ + ⌥ + S

• エディター右クリックによるスニペット挿入

  • JS エディターの右クリックメニューに ZAFrida Frida Snippets を提供。
  • ワンクリックで一般的な Frida コードスニペットを挿入。例：
    • Java.perform ラッパー構造
    • Java メソッド Hook テンプレート
    • Interceptor.attach Native Hook

適用シーン

ZAFrida UI は、Frida を使用するすべてのリバースエンジニアリングの場面、特に以下の場合に適しています：

• Android / iOS アプリのペネトレーションテストとリバース解析。
• 異なる Hook スクリプトを頻繁に切り替える必要があるデバッグプロセス。
• IDE（PyCharm/IDEA）で Python と JS の混合開発に慣れているエンジニア。

技術ドキュメント

• 環境要件:

  • IntelliJ IDEA または PyCharm（推奨 2024.3+）
  • ローカルに Python3 と frida-tools がインストール済み（pip install frida-tools）
  • frida, frida-ps, frida-ls-devices がシステム PATH に含まれているか、プラグイン設定でパスを指定していること。

• フィードバック: Github Issues

プロジェクトの起動

1. ソースコードをクローン: git clone https://github.com/yilongmd/zafrida-ui.git
2. IntelliJ IDEA でプロジェクトを開く。
3. Gradle タスク runIde を実行してデバッグ環境を起動。

システム画面

メイン画面と実行パネル (Run Panel)

デバイス選択、スクリプト選択、実行モード設定、コンソール出力を提供。

動的テンプレート管理 (Template Panel)

左側でカテゴリを選択、中央でテンプレートにチェック、右側でリアルタイムにコードをプレビュー。チェックボックスでスクリプト内容の有効/無効を直接制御。

設定画面 (Settings)

Frida ツールのパス、リモート接続アドレス、ログ設定をカスタマイズ可能。

プロジェクト作成ウィザード

標準化された Frida プロジェクト構成を迅速に作成。

技術アーキテクチャ

開発環境

• 言語: Java 21, Java、ビルドスクリプトには Gradle Kotlin DSL を使用
• フレームワーク: IntelliJ Platform SDK
• ビルドツール: Gradle
• 依存関係: frida frida-tools (Python environment)

謝辞

本プロジェクトの Frida JS スクリプトテンプレートを提供してくださった以下の方々に特に感謝いたします：

• 小佳
• Lane
• 迷人

その他のコントリビューターと謝辞については、CONTRIBUTORS.md をご覧ください。