thegame_1980/revkit

mirror of https://github.com/qtmleap/revkit.git synced 2026-10-11 20:31:51 +02:00

Files

T

tkgstrator b9fdfc5f4f feat(tweak): add AppbootKeyExtract for Netflix appboot key extraction

Introduces a new tweak project to extract Diffie-Hellman and session keys
from the Netflix iOS app using Security.framework and function hooks.
Updates documentation for improved iOS device connectivity via USB and
iproxy, and clarifies setup instructions. Adjusts devcontainer port
forwarding to expose only necessary ports.

Relates to planned appboot DH key extraction workflow.

2026-04-08 09:14:40 +00:00

5.2 KiB

Raw Blame History

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>

5.2 KiB Raw Blame History