Grapefruit: オープンソースのモバイルセキュリティテストスイート

Frida を利用したランタイムモバイルアプリケーションインストルメンテーションツールキット。 Webベースのインターフェースを通じて、モバイルアプリの検査、フック、変更を行えます。

現在、iOSとAndroidの両方をサポートしています！

クイックスタート

デバイス上で Frida サーバーが動作している必要があります。まず公式セットアップガイド(Android)に従ってください。

npm (推奨、Node.js 22.18+ が必要)

npm install -g igf
igf

またはインストールせずに実行 (Node.js 22.18+ が必要)

npx igf

macOS、Linux、Windows用のビルド済みバイナリは GitHub Releases で入手できます。ソースからの開発とビルド済み実行ファイルの両方でNode.jsを使用します。npmワークフローについては開発ガイドを参照してください。

使用方法

igf [options]           サーバーを起動 (デフォルト)

Options:
  --frida <16 | 17>      使用するFridaバージョン (デフォルト: 17)
  --host <host>          バインドするホスト (デフォルト: 127.0.0.1)
  --port <port>          バインドするポート (デフォルト: 31337)
  --project <path>       data/cache/logs用のプロジェクトディレクトリ (デフォルト: カレントディレクトリの.igf)
  --no-open              起動時にブラウザを開かない
  --help, -h             ヘルプメッセージを表示

環境変数

変数	説明	デフォルト
`HOST`	サーバーのバインドアドレス	`127.0.0.1`
`PORT`	サーバーポート	`31337`
`FRIDA_VERSION`	Fridaメジャーバージョン (`16` または `17`)	`17`
`FRIDA_TIMEOUT`	Frida操作のタイムアウト (ms)	`1000`
`PROJECT_DIR`	data/cache/logs用のプロジェクトディレクトリ	カレントディレクトリの`.igf`
`LLM_PROVIDER`	AIプロバイダー (`anthropic`、`openai`、`gemini`、`openrouter`)
`LLM_API_KEY`	LLMプロバイダーのAPIキー
`LLM_MODEL`	モデル名 (例: `claude-sonnet-4-20250514`)
`LLM_BASE_URL`	カスタムエンドポイント (プロバイダーのデフォルトを上書き)

コマンドラインフラグと環境変数の両方が設定されている場合、コマンドラインフラグが優先されます。

機能

ランタイムメソッドフッキング - ネイティブおよびマネージド関数を構造化ログでインターセプト
暗号化APIインターセプション - 暗号化/復号操作をデータキャプチャ付きで監視
ファイルシステムブラウザ - ファイルのナビゲート、アップロード、ダウンロード、およびhex/テキストプレビュー付きの検査
SQLiteデータベース検査 - テーブルの閲覧、クエリの実行、結果の表示
Syslogストリーミング - リアルタイムのシステムおよびエージェントログ監視
プロセスクラッシュレポート - レジスタダンプとバックトレース付きの例外ハンドラー
Flutterサポート - プラットフォームメソッドチャネルの監視と、Dart AOTスナップショット、関数、クラス、文字列、参照、復元されたコンポーネントの探索
React Nativeサポート - ブリッジインスペクターとJavaScriptインジェクションREPL
メモリスキャナー - プロセスメモリの検索と検査
プライバシーモニター - 機密APIアクセス (カメラ、マイク、位置情報、センサーなど) の追跡
スレッドインスペクター - プロセススレッドの表示と管理
モジュール/シンボルブラウザ - ロードされたモジュールとエクスポートされたシンボルの検査
分析と逆コンパイル - DEX、Flutter AOT、Hermesバイトコード、ネイティブコード。フックスクリプト生成にはAI支援が利用可能

iOS

Keychainへのアクセスと変更
NSURLセッショントラフィックのキャプチャ (HTTP/HTTPS/WebSocket)
JavaScript実行を伴うWebViewとJSContextの検査
UI階層のダンプと要素のハイライト
Info.plist、entitlements、バイナリcookieビューア
生体認証 (Touch ID / Face ID) のバイパス
UserDefaultsブラウザ
ペーストボードとファイル操作の監視
位置情報のスプーフィング
デバイスIDのスプーフィング
Objective-Cクラスとメソッドの検査
開いているファイルハンドルとネットワーク接続 (lsof)
セキュリティ分析 (PIE、ARC、スタックカナリア、暗号化)
アセットカタログビューア (Assets.car)
XPC/NSXPCメッセージの検査

Android

AndroidManifest.xmlデコーダーとコンポーネントブラウザ (activities、services、receivers、providers)
キー属性付きのAndroid Keystore検査
コンテンツプロバイダーのクエリ、挿入、更新、削除
引数、戻り値、バックトレース付きのJNIコールトレース
Javaクラス検査 (メソッド、フィールド、インターフェース)
Intentの構築と起動
開いているファイルハンドルとネットワーク接続 (lsof)
HTTPトラフィックのキャプチャ (OkHttp、Volley、URLConnection)
リソースブラウザ
クリップボードとSharedPreferencesの監視
ブロードキャストレシーバーの監視

ドキュメント

スコープと非目標

このプロジェクトには、改ざん防止保護のための組み込みバイパスは含まれていません:

Frida検出のバイパス
SSL/TLS証明書ピンニングのバイパス
脱獄またはroot検出のバイパス

根拠: RASP (Runtime Application Self-Protection) ソリューションは、インストルメンテーションフレームワークを検出するために継続的に進化しています。効果的なバイパスを維持するには、新しい検出方法に追従し続ける継続的な取り組みが必要であり、多大なメンテナンス負担と潜在的な安定性の問題を引き起こします。これらのバイパスはアプリケーション固有の要素が強く、汎用ソリューションは脆弱になります。

脆弱な組み込みバイパスを提供するのではなく、Grapefruitは専用のバイパスツールと組み合わせてうまく機能するインストルメンテーションと検査機能に焦点を当てています。

RASPバイパスが必要な許可された評価における推奨アプローチ:

Frida Syscall Tracer — frida-strace (Frida 17.8.0+) を使用して、ターゲットプロセスのシステムコールをトレースします。これは検出アーティファクトを特定し、Grapefruitをアタッチする前にどのようなパッチが必要かを判断するのに役立ちます:
```
frida-strace -U -f com.example.app
```
詳細はFrida 17.8.0リリースノートを参照してください。
マルチセッションアーキテクチャ — Fridaは同じプロセスにアタッチされた複数のセッションをサポートしています。まずRASPバイパススクリプトで別のセッションを起動し、その後Grapefruitを起動します。Grapefruitはターゲットアプリがすでに実行中であることを検出すると、再起動するのではなく既存のプロセスにアタッチし、すでに有効なバイパスを保持します。

セキュリティ

Grapefruitはデフォルトで 127.0.0.1 にバインドされ、組み込みの認証はありません。Web UIとAPIは任意のローカルプロセスからアクセス可能です。クロスオリジンリクエストはデフォルトでブロックされますが (CORSヘッダーなし、Socket.IOはクロスオリジン接続を拒否)、これだけでは共有環境やリモート環境には十分ではありません。

リモートアクセスやマルチユーザーセキュリティが必要な場合は、TLS、アクセス制御、ログ記録のために Caddy などの認証付きリバースプロキシの背後にGrapefruitを配置してください。認証なしでGrapefruitを直接ネットワークに公開しないでください。

ライセンス

MIT

人気

grapefruit