Files
iOSGuard/docs/17_DEVICE_HOOK_POSITIVE_VERIFICATION.md
shenleiandClaude Opus 4.8 599e1da5ce feat(defender): 可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环)
在 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>
2026-11-12 22:16:47 +09:00

6.6 KiB
Raw Permalink Blame History

17 · 真机 HOOK 正向验证(step11)

日期:2026-11-12。状态:已完成,11/11 用例通过。补齐 11 §5.3、14 §6、16 验收边界中反复挂账的"受控真机正向验证":此前所有真机证据只有干净环境零误报,攻击形态能否命中从未在真机证明。同轮新增两个探针并接入聚合:调试器跟踪(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. 复现

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 容器路径),两次运行间重装会变化,不可硬编码。