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

91 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 11 · 运行时防 HOOK Defender C 模块
日期:2026-11-10。状态:**模块实现 + iphoneos 交叉编译 + 宿主正向自测通过**。按 docs/05 §5.C 设计原则落地;真机接入与业务回归未做。
关联:报告威胁与运行时防护设计见 [05](05_READOOR_SECURITY_REMEDIATION_PLAN.md) §4/§5.C;与静态改写器([10](10_MACHO_GUARD_SELFTEST.md))正交——改写器改变自研规则下的直接分支形态,本模块防运行时 HOOK 导致的信息泄露,两层都要。
> 后续已将宿主测试固化为 `tests/test_defender_host.py` 和 `tests/fixtures/defender_host.c`,覆盖正常环境、符号不可用、提供方异常、环境变量、镜像特征及真实 GOT 槽重绑定,并交叉编译三个模块。本轮 7 项通过,日志随 [13](13_REPRODUCIBLE_BASELINE.md) 归档。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 不上报。
接入(观察模式,启动/回前台/关键操作前):
```c
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. 复现
```bash
# 在 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+名字加密,消静态调用关系)。