在 iOSGuard 侧产出可集成产物与接入文档,不修改 readoor 代码。 - defender/: anti_hook/anti_frida/anti_debug/anti_jailbreak 探针 + syscall 直发、 policy 分级层、poison 数据依赖毒化、dispatch/resolve/call_bridge 等子模块 - poison: 三副本冗余、无分支掩码;健康恒等、毒化破坏 key(替代 if-exit 处置) - policy: STRONG/MEDIUM/WEAK 分级,守误报底线,仅 DETECTED 参与、组合命中才毒化 - anti_jailbreak: IGSyscall 直发 svc 检测越狱文件(400)/沙盒逃逸(401),绕 libc hook - tools/build_defender_lib.sh: 一键交叉编译打包 libIGDefender.a(arm64) + umbrella 头 - docs/18_READOOR_DEFENDER_INTEGRATION.md: 精确到文件/bridging/替换点/代码片段 - docs/05-17 + evidence + tests + macho_guard/static_sdk_redirect 工具链 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
69 lines
6.6 KiB
Markdown
69 lines
6.6 KiB
Markdown
# 17 · 真机 HOOK 正向验证(step11)
|
||
|
||
日期:2026-11-12。状态:**已完成,11/11 用例通过**。补齐 [11](11_RUNTIME_ANTIHOOK_MODULE.md) §5.3、[14](14_ZIPZAP_RUNTIME_DISPATCH_PILOT.md) §6、[16](16_SSZIPARCHIVE_FRAMEWORK_GUARD_PILOT.md) 验收边界中反复挂账的"受控真机正向验证":此前所有真机证据只有干净环境零误报,攻击形态能否命中从未在真机证明。同轮新增两个探针并接入聚合:**调试器跟踪**(reason=300,复用 docs/12 的 `ig_sys_is_debugged`)与 **ObjC 方法 IMP 基线**(reason=110,docs/05 P1 点名的 swizzle 检测空洞),随 `ig_defender_scan` 在真机逐例执行。
|
||
|
||
设备:iPhone 16 Plus(iPhone17,4),iOS 27.2,非越狱,开发签名(TouchLinked_dev 通配 profile,专用 Bundle ID `cn.touchv.iosguard.hookpilot.20261112`,测试后已卸载)。
|
||
|
||
## 1. 验证方式
|
||
|
||
独立诊断进程 `tests/fixtures/hook_device.m`(模式沿用 step2 `dispatch_device.m`),在**自身进程内**构造攻击形态后运行真实探针链。构建器 `tools/macho_guard/build_hook_device.py`,执行器 `tools/macho_guard/run_hook_device.py`(安装→两相位→卸载→证据哈希)。攻击构造(可写 GOT、装载模拟 dylib、特征线程名、方法替换)只存在于诊断源码,绝不编入业务库。
|
||
|
||
两相位:
|
||
|
||
- **相位 A(干净启动)**:10 个用例,覆盖 5 类攻击形态 + 基线 + 恢复检查。
|
||
- **相位 B(DYLD_INSERT_LIBRARIES 启动)**:宿主以 `devicectl -e` 注入环境变量启动,**dyld 在非越狱设备上真实装载** Documents 下的模拟 dylib——这是越狱外可行的真实注入路径(等同 Frida gadget 的加载形态)。
|
||
|
||
## 2. 用例与结果(`20261112-v1`,全部 PASS)
|
||
|
||
| 用例 | 攻击形态 | 期望 | 实测 |
|
||
| --- | --- | --- | --- |
|
||
| baseline_clean | 无(聚合含新调试器探针) | 0 DETECTED | PASS(零误报;直发 sysctl 真机 clear) |
|
||
| got_rebind | fishhook 同款:`vm_protect(VM_PROT_COPY)` 改写自身 `__got` 的 getpid 槽 → 本进程函数 | reason=102 | PASS,证据含槽址/当前值/提供方 |
|
||
| got_restore_clean | 恢复原始指针 | 0 DETECTED | PASS(恢复有效、无粘滞) |
|
||
| prologue_b_branch | 导出符号首指令 `b .+64`(经 dlsym→dladdr→vm_read_overwrite 完整链) | reason=100+101 | PASS |
|
||
| prologue_ldr_br | `ldr x16,#8; br x16` 蹦床 | reason=100+101 | PASS |
|
||
| frida_thread | 子线程 `pthread_setname_np("gum-js-loop")` | reason=203 | PASS |
|
||
| frida_thread_gone | join 后重扫(2s 轮询容忍内核回收延迟) | 0 DETECTED | PASS |
|
||
| injected_image | Documents 下 dlopen 特征名 `libfrida-sim.dylib` | reason=200 | PASS |
|
||
| foreign_image | Documents 下 dlopen 无特征名 `libiosutil-sim.dylib` | reason=201(弱信号) | PASS |
|
||
| objc_imp_baseline | 运行期类采集基线后 `class_replaceMethod` 换实现 | reason=110 | PASS |
|
||
| dyld_insert(相位 B) | `DYLD_INSERT_LIBRARIES` 指向 Documents dylib,dyld 真实装载 | reason=202(+200) | PASS,**202 与 200 双命中** |
|
||
|
||
探针行为澄清(本轮实证):命中注入特征名(200)的镜像**不再重复上报** Bundle 外(201);200 与 201 是互斥的两种形态,分别用两个用例验证。
|
||
|
||
## 3. 性能小样本
|
||
|
||
真机整包聚合扫描(anti_hook 12 符号 + ObjC 基线 + 注入 + 线程 + 调试器探针)5 次:avg 0.55 ms / min 0.53 ms。单机单次小样本,不推导总体性能结论;此前观察包业务内 17~30ms 的量级主要来自 Swift 策略层与观察日志开销,C 探针本身远低于该值。
|
||
|
||
## 3.5 同轮新增的探针模块
|
||
|
||
- `defender/anti_debug/IGAntiDebug.{h,c}`:把 docs/12 已实测的 `ig_sys_is_debugged()`(直发 sysctl 查 P_TRACED)接入 `ig_defender_scan` 聚合,reason=300(1→DETECTED / -1→UNAVAILABLE)。此前该能力存在但策略层无从消费。
|
||
- `defender/anti_hook/IGObjCBaseline.{h,c}`:ObjC 关键方法 IMP 基线探针,reason=110。策略层用 `ig_objc_baseline_capture()` 登记关键方法(类名+选择子,≤64 条),check 时 `method_getImplementation` 与基线比较:IMP 换人(swizzle/replace/exchange)或 IMP 不变但代码前缀变化(函数体改写)即 DETECTED;类/方法不可解析 UNAVAILABLE;未 capture 时 no-op。填补 docs/05 §4 P1 指出的"IMP 基线检测"空洞。
|
||
- 原因码补充:107 显式标注为 Swift 观察层 archive-dispatch 保留;新增 110(ObjC IMP)与 300(调试器跟踪)。
|
||
- 两个设备构建器(dispatch/hook)模块清单同步更新(+IGObjCBaseline/IGAntiDebug/IGSyscall,链接 +lobjc)。
|
||
|
||
宿主测试新增 3 项(`tests/test_defender_host.py`):调试器探针干净环境、ObjC 基线干净路径、ObjC 基线 replace 正向;全套件回归通过。
|
||
|
||
## 4. 复现
|
||
|
||
```bash
|
||
python3 tools/macho_guard/build_hook_device.py \
|
||
--profile <TouchLinked_dev.mobileprovision> --identity <SHA1> \
|
||
--bundle-id cn.touchv.iosguard.hookpilot.<date> \
|
||
--output test-results/step11-device-hook/build-<date>
|
||
python3 tools/macho_guard/run_hook_device.py \
|
||
--device <UDID> --app test-results/step11-device-hook/build-<date>/IGHookPilot.app \
|
||
--bundle-id cn.touchv.iosguard.hookpilot.<date> \
|
||
--output test-results/step11-device-hook/<date>-v1
|
||
```
|
||
|
||
输出目录必须不存在;证据:`device-verification.json`(用例/结论/边界)、`console-clean.log`、`console-insert.log`、`launch-*.json`、`install/uninstall.json`、`evidence-hashes.json`;构建侧 `build-*/manifest.json` 含源码快照哈希。宿主侧另有同一 fixture 的 9 用例冒烟(/tmp,未归档);既有 59 项宿主/工具测试重跑通过,无回归。
|
||
|
||
## 5. 边界(如实声明)
|
||
|
||
1. **inline-hook 仍非"真实系统函数 patch"**:非越狱无法改写共享缓存代码页。本用例针对受控导出符号的**真实代码字节**验证"解析→读取→分类"全链,序言分类逻辑与真实 patch 场景相同;对系统函数的实际 inline Hook 检测仍需越狱设备(后续可选)。
|
||
2. **特征可规避**:镜像名/线程名改写即绕过 200/203;本验证证明"命中抓得住",未命中不等于干净(组合判定原则不变)。
|
||
3. **诊断进程 ≠ 业务 App**:独立进程、无业务代码;业务 App 内的攻击面(ObjC 方法、业务函数)不受本轮覆盖——ObjC IMP/swizzle 检测仍是空洞,见 README 差距清单。
|
||
4. `frida_thread_gone` 依赖内核线程回收延迟(2s 轮询窗口);极端缓慢环境下可能仍残留,属环境噪声。
|
||
5. 相位 B 的 dylib 路径来自相位 A 回显(Documents 容器路径),两次运行间重装会变化,不可硬编码。
|