在 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>
7.0 KiB
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. 边界(如实声明)
- 架构:仅 arm64/x86_64(LP64)。arm64e
__auth_got槽为认证指针,比较前ptrauth_strip;若工具链无 ptrauth 则对认证槽判 unavailable,不强行比较。本包 appstore.ipa 全 arm64,无此问题。 - 惰性槽:只对非惰性
__got(S_NON_LAZY_SYMBOL_POINTERS)判 rebind;__la_symbol_ptr首次调用前可能仍指 helper,不误判,由 provenance/inline 层兜底。 - inline hook 正向未测:序言检测仅验证了 12 个真实系统函数的零误报路径;正向 patch 需改写共享缓存代码页(真机受保护),宿主不可行,留真机验证。检测逻辑本身保守(仅 B / LDR+BR 蹦床),低误报。
- 特征可规避:镜像名/线程名/端口均为可改写特征,命中是强/弱证据,未命中不等于干净——故 05 §5.C 要求组合判定,本模块只给证据不下结论。
- 只检测不处置:绝不 exit;策略层须区分构建缺陷/误报/真实攻击,支付/权益仍由服务端校验。
- 真机接入与回归未做:启动链接入、冷启/回前台/多 Scene、正常 SDK 合法 swizzling 的误报面均未在真机验证。
6. 复现
# 在 iOSGuard 根目录运行,隔离编译宿主测试并执行正反例,另做 iphoneos/arm64 交叉编译。
python3 -m unittest discover -s tests -p 'test_defender_host.py' -v
7. 下一步
- 真机接入:编入 readoor31(遵守其 AGENTS.md / Skill),启动链调用
ig_defender_scan,观察模式跑正常业务,量化误报面(合法 swizzling、调试配置)。 - inline-hook 正向测:真机用 Frida/Dobby 实挂关键函数,确认 reason=101 命中。
- 策略层:把 reason 组合映射到受限操作(而非 exit),与 05 §4 指出的
RDSecurityGuard立即 exit 缺陷一并整改。 - arm64e 支持:若后续样本含 arm64e 切片,补
__auth_got认证槽校验。 - 与静态层串联:
macho_guard(静态改写,厂商复测待完成)+ 本模块(防 HOOK)+ 可选 Plan A(dlsym+名字加密,消静态调用关系)。