Frida UI

Frida 向けのモダンで軽量な Web ベースのユーザーインターフェースです。Frida 用に設計されており、Android アプリケーションのペネトレーションテストを目的としています。ブラウザから直接、デバイス、プロセス、スクリプトを操作できます。

クイックスタート

# uv（推奨）または pipx/pip を使用してインストール
uv tool install frida-ui
# または: pipx install frida-ui
# または: pip install frida-ui

# サーバーを起動
frida-ui

ブラウザを開いて、次の URL にアクセスしてください: http://localhost:8000

機能

📱 デバイス管理

• 自動検出: 接続されている USB デバイスおよびローカルデバイスを自動的に検出します。
• リモートデバイス: リモートの Frida サーバー（例：192.168.1.x:27042）を簡単に追加・管理できます。
• デバイス情報: 選択したデバイスの詳細なシステムパラメータ（OS、アーキテクチャ、API レベル）と視覚的なタイプインジケータを表示します。

🚀 プロセス・アプリ制御

• アプリケーション一覧: インストール済みのアプリケーションと実行中のプロセスを表示します。
• 検索: アプリケーション名または識別子によるリアルタイムフィルタリング。
• セッション管理:
  • アタッチ: 実行中のプロセスに接続します。
  • スポーン: インストール済みのアプリケーションを起動します。
  • スポーン & 実行: アプリを起動し、同時にエディタのスクリプトとキューに入った CodeShare スクリプトを注入します（早期インストルメンテーション）。
  • 強制終了 / デタッチ: プロセスを終了するか、正常に切断します。

💻 スクリプト作成とインストルメンテーション

• スクリプトエディタ: Frida スクリプトを作成するためのビルトインエディタ。オプションで Monaco エディタ を使用すると、よりリッチな編集（シンタックスハイライトと自動レイアウト）が可能で、フォールバックとしてプレーンなテキストエリアも用意しています。
• ファイル読み込み: ローカルファイルからスクリプトを読み込むか、.js ファイルをエディタにドラッグ＆ドロップできます。
• スクリプトのダウンロード: エディタのヘッダーから、現在のエディタ内容を .js ファイル（frida-ui_<アプリID>_<タイムスタンプ>.js）としてエクスポートできます。
• CodeShare 連携:
  • Frida CodeShare から直接スクリプトをインポートできます。
  • CodeShare キュー: 複数の CodeShare スクリプトをキューに入れて、「スポーン & 実行」時に自動的に読み込んで実行したり、「CodeShare スクリプトを実行」ボタンで手動で実行できます。

📊 コンソールとログ

• リアルタイム出力: スクリプトからの console.log、send()、エラーメッセージを表示します。
• ログ履歴: アプリケーションセッションごとにログを保持します。
• エクスポート: コンソールログを .txt ファイルとしてダウンロードし、分析に利用できます。

🎨 UI/UX

• ダークテーマ: クリーンで一貫性のあるダークモードインターフェース。
• 永続性: 選択したデバイス、アプリケーション、ペインサイズをセッション間で記憶します。
• レスポンシブ: サイドバー、エディタ、コンソールの各ペインのサイズを調整可能。
• 集中モード: 「エディタのみ」または「コンソールのみ」の表示に切り替え、他のペインを非表示にして気を散らさないワークフローを実現できます。
• アクセシビリティ: キーボードショートカット（例：Escape でビューをリセット、オーバーレイを閉じる）と ARIA サポート。

はじめに

前提条件

• Python 3.7 以上
• uv（推奨）/ pipx / pip

インストール

オプション 1: PyPI からインストール（推奨）

uv tool install frida-ui

Frida のバージョンをカスタマイズすることもできます:

uv tool install frida-ui --with frida==16.7.19

オプション 2: ソースからインストール（最新版）

uv tool install git+https://github.com/adityatelange/frida-ui

Frida のバージョンをカスタマイズできます:

uv tool install git+https://github.com/adityatelange/frida-ui --with frida==16.7.19

[!IMPORTANT] インストールする Frida のバージョンは、Android デバイス上の frida-server のバージョンと一致している必要があります。互換性を確保してください。

実行

デフォルト構成でサーバーを起動します:

frida-ui

カスタムオプションでも実行可能:

frida-ui --host 127.0.0.1 --port 8000 --reload

• --host: ホストを指定（デフォルト: 127.0.0.1）
• --port: ポートを指定（デフォルト: 8000）
• --reload: 開発用の自動リロードを有効化

ブラウザで http://localhost:8000 を開いてください。

Android デバイスのセットアップ

frida-ui を使用する前に、Android デバイス上で frida-server が実行されている必要があります。frida-server のバージョンは、前の手順でインストールした Frida のバージョンと一致している必要があります。

オプション 1: USB 接続

ADB がインストールされており、USB 経由で接続する場合:

1. frida-server をダウンロード: Frida リリースページ にアクセスし、デバイスのアーキテクチャ/ABI に合った Android 用の frida-server バイナリ（例: frida-server-x.x.x-android-arm64.xz）をダウンロードします。

2. 展開してデバイスにプッシュ:

   root@kitploit:~

   unxz frida-server-x.x.x-android-arm64.xz
   mv frida-server-x.x.x-android-arm64 frida-server
   adb push frida-server /data/local/tmp/
   

3. frida-server を実行:

   root@kitploit:~

   adb shell "chmod 755 /data/local/tmp/frida-server"
   adb shell "/data/local/tmp/frida-server -D"
   

4. 接続を確認: デバイスが USB で接続され、adb devices で認識されていることを確認します。frida-ui は実行時に自動的に検出します。

オプション 2: リモート接続（ネットワーク）

別の方法として、frida-server をネットワークリスナーで実行し、リモート接続することもできます:

1. Android デバイスで frida-server をダウンロードして実行（ADB、カスタムスクリプトなど任意の方法）:

   root@kitploit:~

   ./frida-server -l 0.0.0.0:27042 -D
   

2. frida-ui でリモートデバイスを追加: frida-ui のインターフェースで、frida-server がリッスンしている IP アドレスとポート（例: 192.168.1.x:27042）を使用してリモートデバイスを追加します。

   この方法では ADB のインストールは不要です。

使用方法

1. デバイスを選択: 上部ヘッダーのドロップダウンからデバイスを選択します。
2. アプリを選択: サイドバーでアプリケーションをクリックします。
3. スクリプトを作成 / 読み込み:
   • エディタに JavaScript を入力します。
   • ファイルをドラッグ＆ドロップします。
   • CodeShare からスクリプトの URL を追加します。
4. アクション:
   • アタッチ をクリックして実行中のプロセスに注入します。
   • スポーン をクリックしてアプリを起動します。
   • スポーン & 実行 をクリックして、アプリを起動すると同時にスクリプトを注入します。
5. 監視: コンソールで出力を確認します。

💡 スクリプト例

メソッドをフックする簡単なスクリプトです（ターゲットに置き換えてください）:

// シンプルなメソッドフックの例
Java.perform(() => {
  const MainActivity = Java.use("com.example.app.MainActivity");
  MainActivity.checkPassword.implementation = function (password) {
    console.log("[*] checkPassword called with: " + password);
    return true; // チェックをバイパス
  };
});

注記

[!NOTE] このツールは独立したプロジェクトであり、公式の Frida ツールセットの一部ではありません。また、Frida プロジェクトのスポンサーを受けているわけでもありません。Frida のコア機能を操作するためのサードパーティのユーザーインターフェースです。

[!WARNING] このツールは、ターゲットプロセス内で任意の JavaScript を実行できます。frida-ui は信頼できるネットワークとユーザにのみ公開してください。信頼できないスクリプトを実行すると、システムやデータが危険にさらされる可能性があります。Web サーバーはデフォルトでローカルで実行されますが、強力なインストルメンテーション機能を公開します。

クレジット

• Frida プロジェクト - https://frida.re/
• Monaco Editor - https://microsoft.github.io/monaco-editor/
• コードの提案と改善に対して GitHub Copilot に感謝します。

経時的なスター獲得数