Files
iOSGuard/docs/11_RUNTIME_ANTIHOOK_MODULE.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

7.0 KiB
Raw Permalink Blame History

11 · 运行时防 HOOK Defender C 模块

日期:2026-11-10。状态:模块实现 + iphoneos 交叉编译 + 宿主正向自测通过。按 docs/05 §5.C 设计原则落地;真机接入与业务回归未做。

关联:报告威胁与运行时防护设计见 05 §4/§5.C;与静态改写器(10)正交——改写器改变自研规则下的直接分支形态,本模块防运行时 HOOK 导致的信息泄露,两层都要。

后续已将宿主测试固化为 tests/test_defender_host.py 和 tests/fixtures/defender_host.c,覆盖正常环境、符号不可用、提供方异常、环境变量、镜像特征及真实 GOT 槽重绑定,并交叉编译三个模块。本轮 7 项通过,日志随 13 归档。inline Hook 真机正向测试仍未完成。

1. 定位

报告描述的"HOOK 关键系统函数 → 信息泄露"是运行时威胁,静态改写(macho_guard,桥接仍走同一 GOT 槽、ABI 透明)防不住。本模块是独立的运行时完整性探针,纯 C、无 Swift/OC 依赖,可直接编入任意 iOS target。

遵循 docs/05 §5.C 原则:探针与处置分离——只采集证据经回调上报,返回 clear/detected/unavailable(unavailable 不等于安全),绝不自行 exit,是否限制功能由上层策略决定(观察模式优先)。

2. 覆盖的 HOOK 形态

探针 reason 检测手段 对应攻击
符号提供方 100 SYMBOL_PROVENANCE dlsym→dladdr,宿主镜像须系统路径 dyld interpose / 注入 dylib 抢占符号定义
inline hook 101 INLINE_HOOK 关键函数序言首指令为无条件 B,或 LDR-literal+BR x16/x17 蹦床 Frida Interceptor / Dobby inline patch
GOT 重绑定 102 GOT_REBIND 运行时遍历自有镜像非惰性 __got 槽(fishhook 同款 loader 走法,用于校验),当前值去 PAC 后≠trusted 且提供方非系统 fishhook 类 GOT/符号指针改写
注入镜像 200 INJECTED_IMAGE 已加载镜像名匹配 frida/substrate/cycript/dobby… 特征 越狱注入框架加载
Bundle 外镜像 201 FOREIGN_IMAGE 非系统且不在 .app 内的镜像(弱信号) 未知 dylib 载入
DYLD 插入 202 DYLD_INSERT DYLD_INSERT_LIBRARIES 逐条解析(非整串前缀,对应 05 §4 P1),条目在 Bundle 外即报 DYLD_INSERT_LIBRARIES 注入
Frida 线程 203 FRIDA_THREAD task_threads+THREAD_EXTENDED_INFO 线程名匹配 gum-js-loop/gmain/pool-frida… Frida 运行时驻留
Frida 端口 204 FRIDA_PORT 非阻塞 connect 127.0.0.1:27042(默认关,弱信号) Frida 默认监听

全部基于公开 API:<dlfcn.h>、<mach-o/dyld.h>、<mach-o/loader.h>/<nlist.h>、task_threads/thread_info、BSD socket。

3. 文件与接口

defender/
  include/IGDefender.h         结果模型(IGStatus/IGReason/IGFinding/IGFindingSink)+ ig_defender_scan
  anti_hook/IGAntiHook.{h,c}   ig_anti_hook_check(names,count,sink,ctx) / _default
  anti_frida/IGAntiInject.{h,c} ig_anti_inject_check(bundle,sink,ctx) / ig_anti_frida_check(port,sink,ctx)
  IGDefender.c                 ig_defender_scan 聚合

结果模型(IGFinding):status + reason + subject(符号/镜像/线程名)+ evidence(地址/提供方/端口人读文本)。探针对每条 DETECTED/UNAVAILABLE 调 sink 一次,CLEAR 不上报。

接入(观察模式,启动/回前台/关键操作前):

static int sink(const IGFinding *f, void *ctx) {
    // 上报打点;按 f->reason 组合决定策略,勿在此直接 exit
    return 0;
}
int hits = ig_defender_scan(bundle_path, /*probe_port=*/0, sink, ctx);

4. 验证证据

iphoneos arm64 交叉编译(可编入 App 的证明):三个 .c 以 -arch arm64 -miphoneos-version-min=15.0 -O2 -Wall -Wextra 全部 OK,ar 打包 libIGDefender.a(arm64),导出 _ig_anti_hook_check / _ig_anti_hook_check_default / _ig_anti_inject_check / _ig_anti_frida_check / _ig_defender_scan。

宿主 arm64 行为自测:

场景 期望 实测
干净环境 anti_hook(12 符号 provenance+inline+GOT) 0 命中 0(无误报)
干净环境注入扫描 0 0
正向:DYLD_INSERT_LIBRARIES=/tmp/evil:/var/x/hook 逐条报 DYLD_INSERT 2 条 DYLD_INSERT(+1 FOREIGN,均正确)
正向:dlopen 名含 frida 的 dylib INJECTED_IMAGE 命中,证据含匹配特征
正向:fishhook 式篡改 getpid 的 __got 槽指向本程序函数 GOT_REBIND DETECTED reason=102,证据含槽址/当前值/非系统提供方/期望值
Frida 线程扫描(无 frida) 0 0

GOT 重绑定——即用户点名的"GOT 完整性校验"——以真实篡改正向验证抓得到,且篡改前零误报。

5. 边界(如实声明)

  1. 架构:仅 arm64/x86_64(LP64)。arm64e __auth_got 槽为认证指针,比较前 ptrauth_strip;若工具链无 ptrauth 则对认证槽判 unavailable,不强行比较。本包 appstore.ipa 全 arm64,无此问题。
  2. 惰性槽:只对非惰性 __got(S_NON_LAZY_SYMBOL_POINTERS)判 rebind;__la_symbol_ptr 首次调用前可能仍指 helper,不误判,由 provenance/inline 层兜底。
  3. inline hook 正向未测:序言检测仅验证了 12 个真实系统函数的零误报路径;正向 patch 需改写共享缓存代码页(真机受保护),宿主不可行,留真机验证。检测逻辑本身保守(仅 B / LDR+BR 蹦床),低误报。
  4. 特征可规避:镜像名/线程名/端口均为可改写特征,命中是强/弱证据,未命中不等于干净——故 05 §5.C 要求组合判定,本模块只给证据不下结论。
  5. 只检测不处置:绝不 exit;策略层须区分构建缺陷/误报/真实攻击,支付/权益仍由服务端校验。
  6. 真机接入与回归未做:启动链接入、冷启/回前台/多 Scene、正常 SDK 合法 swizzling 的误报面均未在真机验证。

6. 复现

# 在 iOSGuard 根目录运行,隔离编译宿主测试并执行正反例,另做 iphoneos/arm64 交叉编译。
python3 -m unittest discover -s tests -p 'test_defender_host.py' -v

7. 下一步

  1. 真机接入:编入 readoor31(遵守其 AGENTS.md / Skill),启动链调用 ig_defender_scan,观察模式跑正常业务,量化误报面(合法 swizzling、调试配置)。
  2. inline-hook 正向测:真机用 Frida/Dobby 实挂关键函数,确认 reason=101 命中。
  3. 策略层:把 reason 组合映射到受限操作(而非 exit),与 05 §4 指出的 RDSecurityGuard 立即 exit 缺陷一并整改。
  4. arm64e 支持:若后续样本含 arm64e 切片,补 __auth_got 认证槽校验。
  5. 与静态层串联:macho_guard(静态改写,厂商复测待完成)+ 本模块(防 HOOK)+ 可选 Plan A(dlsym+名字加密,消静态调用关系)。