在 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.7 KiB
10 · macho_guard 链接后改写器:自测通过
日期:2026-11-10。状态:第 1 层检测自测清零——单二进制 336 → 0(§1-6),整包 31 个 Mach-O 共 878 → 0(§7),结构合法可签。仍未向 V4.6.6 送检——"桥接即过"依旧是待验证假设(见 09 §4)。
关联:方向与改写面实测见 09,检测器判定标准推断见 09 §1。
后续已从根目录 IPA 重新运行整包验证并保存在
test-results/verification/20261110-step1-final/,含源码快照、前后包、逐二进制 UUID/哈希、逐调用点 CSV、逐指令校验和签名日志;复现入口见 13。下文 scratchpad 为早期记录,不再是唯一证据来源。
1. 结论
按 09 §5 收敛的路径,tools/macho_guard 链接后改写引擎已建成并在真实目标 appstore.ipa(readoor31OtherPay v2.199.0,com.ecnup.aSCLdl2,arm64 单切片,cryptid 0)上跑通:
- 注入
__IGUARD段(RX,一页 0x4000),内含 12 个与系统 stub 字节同构的桥接蹦床; - 改写
__text内全部 336 个命中调用点bl/b → __stubs为bl/b → IG_*; - ad-hoc 重签(
codesign -f -s -)通过,codesign -vexit 0。
对 patch 后二进制重跑本目录扫描脚本:命中 12 个符号的直接调用点 336 → 0。重新打包成 IPA 后再解包复扫,同样为 0——独立复现,非内存产物假象。
2. 改写面与结果(逐符号)
| 符号 | 改写数 | 符号 | 改写数 | 符号 | 改写数 |
|---|---|---|---|---|---|
_exit |
96 | _open |
21 | _unlink |
8 |
_fopen |
86 | _dlsym |
18 | _read |
7 |
_close |
67 | _write |
16 | _dlopen |
2 |
_getpid |
12 | _fork |
1 | _syscall |
2 |
合计 336,与注入前实测(09 §2.5)逐符号完全吻合。
3. 桥接蹦床原理
每个桥接函数 3 指令 12 字节,与系统 __stubs 条目字节同构,从同一 GOT 槽取址尾调用:
adrp x16, GOT@page ; 与系统 stub 相同的页基址
ldr x16, [x16, #off] ; 取同一 GOT 槽(dyld 已填真实函数地址)
br x16 ; 尾调用,ABI 透明,变参/errno 原样透传
关键差异:桥接函数不登记进间接符号表。因此静态扫描器遍历 __stubs→间接符号表还原"这个分支目标对应哪个导入符号"时,IG_* 无法被归为 _write/_fopen/...,调用点不再被判为对应系统符号。_write 等仍是导入符号(GOT 槽、桥接自身引用),第 2/3 层未动——与 09 §1 推断的 V4.6.6 判定口径(调用点直接分支关系,非符号存在性)一致。
尾调用正确性:b IG_sym(tail call)改写后,IG_sym 末尾 br x16 跳真实实现,返回地址仍是原调用者,ABI 透明;bl IG_sym 同理,桥接返回后回到调用点。变参 open/syscall 因纯尾调用、参数寄存器/栈原样透传,字节同构蹦床即足够(不需签名精确的 C 桥接)。
4. 段注入与偏移修正(最易错处)
在 __DATA 与 __LINKEDIT 之间插入 __IGUARD:
- 文件在
__LINKEDITfileoff(0x3458000)处插入一页段数据; - header 区(0..16384,含 load commands)在
__LINKEDIT命令前插入 72 字节LC_SEGMENT_64,header 区总长保持 16384(原 load commands 结束于 15088,余量充足); ncmds += 1,sizeofcmds += 72;__LINKEDIT段命令 vmaddr/fileoff+= PAGE;- 所有指向 __LINKEDIT 的偏移
+= PAGE:chained_fixups、exports_trie、symtab(symoff/stroff)、dysymtab(indirectsym)、function_starts、data_in_code、code_signature——漏一个即加载失败或签名区错位。命令本身也因插入右移 72 字节。
验证:otool -l exit 0 解析干净;段序 __PAGEZERO,__TEXT,__DATA,__IGUARD,__LINKEDIT 正确;codesign -v PASSED。
5. 工具与产物
tools/macho_guard/machox.py:Mach-O 解析(Macho类、linkedit_pointers())。tools/macho_guard/macho_guard.py:注入+改写+重签。CLI:inject(仅注入校验)、harden(注入→改写→重签一条龙)。因读取未信任二进制,须python3 -I运行。- 自测扫描脚本复现 V4.6.6 判定(扫
__text全部bl/b → __stubs,经间接符号表映射到 12 个命中符号)。 - 加固后 IPA、逐点 CSV 等产物当前在会话 scratchpad,未入库(113M 二进制不宜提交);需长期留存可按需拷入
test-results/。
6. 复现命令
cd tools/macho_guard
python3 -I macho_guard.py harden <原始二进制> <输出二进制>
# [1/3] 注入 __IGUARD;[2/3] 改写 336 处;[3/3] ad-hoc 重签 exit=0
# 复扫期望 336 → 0
7. 多 Mach-O 整包批处理(2026-11-10 自测通过)
单二进制验证后,把改写器推广到整个 .app 包。工程化要点:
- base 泛化:主程序
__TEXTvmaddr=0x1_0000_0000(__PAGEZERO在前),framework/dylib vmaddr=0(无__PAGEZERO)。原inject/find_stub_got_slots硬编码的BASE=0x100000000与 header 区16384均改为按__TEXT段实测值与首节文件偏移动态计算(_text_mapping/_first_section_fileoff)。扫描逻辑本就纯在 vmaddr 空间匹配,天然 base 无关。 - fat 容器:
AliyunPlayer/alivcffmpeg/AliyunMediaDownloader为cafebabefat 壳包单 arm64 切片。用lipo -thin arm64抽出 → 加固 thin →lipo -replace arm64回填,保持 fat 结构与原签名壳。 - 逐级签名:改写后自底向上
codesign -f -s -各.framework,再签主.appbundle。 - 注入前体检:
batch.py先扫全包,报告每个 Mach-O 的命中数、注入余量(首节偏移−load command 末尾)、cryptid。本包 30 个 framework + 主二进制共命中,余量全部 >8KB(所需 72B),cryptid全 0——无一受阻。
真实目标 appstore.ipa 整包结果(43 个 Mach-O/切片):
| 范围 | 命中 | 结果 |
|---|---|---|
| 主二进制 readoor31OtherPay | 336 | → 0 |
| 30 个 framework(含 3 个 fat) | 542 | → 0 |
| 全包合计 | 878 | → 0 |
命中最多:AliyunPlayer 103、TTNetworkManager 56、ATAuthSDK_D 39、WCDBSwift 27。全包 _dlsym 312 居首(媒体/网络 SDK 动态加载)。改写后:整包复扫 0 命中;fat 容器仍 cafebabe+arm64;主二进制与各 framework codesign -v 全 PASSED;otool -l 干净;重打包成 IPA 再解包复扫仍 0——独立复现。
命令:
cd tools/macho_guard
python3 -I batch.py <App.app> # 全包命中/余量体检
python3 -I macho_guard.py harden-bundle <App.app> # 整包加固 + 逐级重签
8. 下一步(未完成项,如实列出)
- 送检 V4.6.6:验证 09 §1 核心假设。过 → 收工;仍命中 → 09 §3 阶梯 A(dlsym 表 + 名字加密)。这是唯一能证实"桥接即过"的步骤,尚未做。
- 真机功能回归:讯飞语音、书籍下载/解压(ZipZap/ZIPFoundation/SSZipArchive)、AliyunPlayer 播放、GCDWebServer——878 处改写后未验证运行时行为。改写只动调用目标(桥接 ABI 透明尾调用),风险低但需实测确认。
- 正式签名:ad-hoc 仅够静态扫描;真机安装/提审需开发者身份 + entitlements + Provisioning 保留(整包重签需
--entitlements逐包传递)。 - arm64e / __auth_stubs:本包全为 arm64(常规
__stubs+__got)。若后续样本含 arm64e 切片,需处理认证指针桩(__auth_stubs/__auth_got)——当前未覆盖。 - 运行时防护正交项(05 计划):GOT 完整性校验、反调试——静态改写不覆盖,Frida 等运行时 Hook 仍需单独处理。