revkit

iOS / Android アプリのリバースエンジニアリングツールキット。

• iOS Tweak 開発 — Theos/Orion による Substrate Tweak のビルド・デプロイ (arm64, rootless)
• Frida フック — iOS / Android アプリのランタイム解析・動的インストルメンテーション
• mitmproxy — HTTPS トラフィックキャプチャ・プロトコルデコード
• バイナリ解析 — Ghidra, radare2, jadx, ipsw による APK / IPA の静的解析

構成

.
├── packages/
│   ├── frida/                  # Frida フックスクリプト (TypeScript → JS)
│   │   └── src/
│   │       ├── ios/            #   iOS 用フック (ObjC/C++)
│   │       ├── android/        #   Android 用フック (Java/JNI)
│   │       └── common/         #   共通ユーティリティ
│   ├── mitmproxy/              # mitmproxy アドオン
│   └── tweak/                  # iOS Tweak (Theos/Orion)
│
├── tools/                      # Python ユーティリティ
│   ├── run.py                  #   Frida フック実行ランナー
│   ├── transformers/           #   ログ変換 (Frida → 統一フォーマット)
│   └── ...
│
├── handlers/                   # Objection ハンドラ (CommonCrypto, Security 等)
├── docs/                       # 解析結果・仕様書
├── assets/                     # IPA/APK バイナリ (.gitignore)
├── raws/                       # Frida 生キャプチャログ (.gitignore)
└── logs/                       # 変換済みログ (.gitignore)

開発環境

DevContainer で構築済み。Rebuild Container で全ツールが揃う。

ランタイム

ツール	用途
Python 3.12 (uv)	ユーティリティ、ログ変換、解析スクリプト
Node.js 25.x	Frida スクリプトのビルド (frida-compile)
Bun	Chrome 拡張のビルド
Frida 17.x	動的インストルメンテーション
mitmproxy	プログラマブル HTTPS プロキシ

リバースエンジニアリング

ツール	用途
radare2	ARM64 逆アセンブル・バイナリ解析
Ghidra (headless)	擬似コード生成・関数解析
jadx	Android APK → Java 逆コンパイル
apktool	Android APK リソース展開・smali
ipsw	iOS Mach-O 解析・ObjC/Swift クラスダンプ
lief (Python)	Mach-O/ELF バイナリパーサー
capstone (Python)	ARM64 ディスアセンブラ
unicorn (Python)	CPU エミュレーション
pywidevine (Python)	Widevine DRM 解析

iOS Tweak 開発

ツール	用途
Theos	Tweak ビルドシステム
Orion	Swift Tweak フレームワーク
Swift 5.8 (cross-compile)	iOS 向けクロスコンパイル
iOS SDK 15.6 / 16.5	ビルドターゲット

macOS ホスト設定

DevContainer は Docker Desktop の Linux VM 内で動作するため、iOS デバイスと直接通信できない。USB 接続の iproxy を経由することで、WiFi の IP 変更やネットワーク不安定の影響を受けずに接続できる。

1. iproxy のインストール (macOS)

brew install libimobiledevice

2. iproxy の起動 (macOS)

iPhone を USB で接続した状態で:

iproxy 2222 22 &
iproxy 27042 27042 &

• 2222 → 22: SSH 接続用
• 27042 → 27042: Frida 接続用

3. VS Code ポートフォワーディング設定

.vscode/settings.json に以下を追加して、mitmproxy のポートを LAN に公開する:

"remote.localPortHost": "allInterfaces"

4. SSH config (コンテナ内)

~/.ssh/config:

Host iPhone
  HostName host.docker.internal
  User root
  Port 2222

接続経路

用途	方向	経路
SSH	コンテナ → デバイス	ssh iPhone → host.docker.internal:2222 → iproxy (USB) → デバイス:22
Frida	コンテナ → デバイス	frida -H host.docker.internal → iproxy (USB) → デバイス:27042
mitmproxy	デバイス → コンテナ	デバイスの WiFi プロキシを macOS の LAN IP:9080 に設定

使い方

Frida フック

# iOS (objection 経由で spawn)
uv run python tools/run.py packages/frida/<script>.js

# Android (spawn モード)
uv run python tools/run.py --android packages/frida/<script>.js

.env にデバイスのホストを設定 (iproxy 経由の場合は host.docker.internal):

IOS_HOST=host.docker.internal
ANDROID_HOST=192.168.x.x

mitmproxy

uv run mitmdump -p 8080 -s packages/mitmproxy/<addon>.py

iOS Tweak (Theos)

# ビルド
make -C packages/tweak/<tweak名>

# パッケージ (.deb 生成)
make -C packages/tweak/<tweak名> package

# デバイスへのインストール
make -C packages/tweak/<tweak名> package install THEOS_DEVICE_IP=<デバイスIP>

バイナリ解析

# iOS: ObjC/Swift クラスダンプ
ipsw macho info <binary> --class-dump

# Android: APK 逆コンパイル
jadx -d /tmp/out <apk>

# Ghidra ヘッドレス解析
analyzeHeadless /tmp/project name -import <binary>