mirror of
https://github.com/qtmleap/revkit.git
synced 2026-09-28 22:11:50 +02:00
tkgstrator
48036e7293
Introduces an English README as the main documentation and moves the Japanese version to a dedicated file with a language switcher badge. Updates README structure and content for clarity, consistency, and ease of navigation for both English and Japanese readers.
185 lines
6.3 KiB
Markdown
185 lines
6.3 KiB
Markdown
# revkit
|
|
|
|
[](../README.md)
|
|
|
|
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)
|
|
|
|
```bash
|
|
brew install libimobiledevice
|
|
```
|
|
|
|
### 2. iproxy の起動 (macOS)
|
|
|
|
iPhone を USB で接続した状態で:
|
|
|
|
```bash
|
|
iproxy 2222 22 &
|
|
iproxy 27042 27042 &
|
|
```
|
|
|
|
- `2222 → 22`: SSH 接続用
|
|
- `27042 → 27042`: Frida 接続用
|
|
|
|
### 接続経路
|
|
|
|
| 用途 | 方向 | 経路 |
|
|
|------|------|------|
|
|
| **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 フック
|
|
|
|
```bash
|
|
# 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
|
|
|
|
#### デバイス側の設定
|
|
|
|
1. デバイスの WiFi プロキシを macOS の LAN IP、ポート `9080` に設定
|
|
2. デバイスのブラウザで `http://mitm.it` にアクセスし、CA 証明書をインストール
|
|
- iOS: 設定 → 一般 → VPN とデバイス管理 → mitmproxy をインストール → 設定 → 一般 → 情報 → 証明書信頼設定 で有効化
|
|
|
|
#### 起動
|
|
|
|
```bash
|
|
uv run mitmdump --listen-port 9080 --set block_global=false \
|
|
-s packages/mitmproxy/<addon>.py
|
|
```
|
|
|
|
アドオンは `packages/mitmproxy/` に配置。
|
|
|
|
### iOS Tweak (Theos)
|
|
|
|
```bash
|
|
# ビルド
|
|
make -C packages/tweak/<tweak名>
|
|
|
|
# パッケージ (.deb 生成)
|
|
make -C packages/tweak/<tweak名> package
|
|
|
|
# デバイスへのインストール
|
|
make -C packages/tweak/<tweak名> package install THEOS_DEVICE_IP=<デバイスIP>
|
|
```
|
|
|
|
### バイナリ解析
|
|
|
|
```bash
|
|
# iOS: ObjC/Swift クラスダンプ
|
|
ipsw macho info <binary> --class-dump
|
|
|
|
# Android: APK 逆コンパイル
|
|
jadx -d /tmp/out <apk>
|
|
|
|
# Ghidra ヘッドレス解析
|
|
analyzeHeadless /tmp/project name -import <binary>
|
|
```
|
|
|
|
## Claude Code スキル
|
|
|
|
本プロジェクト固有のスラッシュコマンド。Claude Code 内で使用できる。
|
|
|
|
| コマンド | 説明 |
|
|
|---------|------|
|
|
| `/compose` | Agent Teams のリーダーとしてチームを編成し、計画策定→承認→実行のワークフローを開始する |
|
|
|
|
### エージェント
|
|
|
|
`/compose` から呼び出される専門エージェント。
|
|
|
|
| エージェント | 担当 |
|
|
|-------------|------|
|
|
| `tweak-engineer` | iOS Tweak 開発 (Orion/Theos, ElleKit C フック) |
|
|
| `frida-engineer` | Frida フックスクリプト、ランタイム解析 |
|
|
| `mitmproxy-engineer` | mitmproxy アドオン、トラフィックキャプチャ |
|
|
| `python-engineer` | Python ユーティリティ、デコーダー、データ処理 |
|
|
| `log-monitor` | Frida/mitmproxy/Tweak のログ監視・レポート |
|