Files
iOSGuard/docs/10_MACHO_GUARD_SELFTEST.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.7 KiB
Raw Permalink Blame History

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 -v exit 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:

  1. 文件在 __LINKEDIT fileoff(0x3458000)处插入一页段数据;
  2. header 区(0..16384,含 load commands)在 __LINKEDIT 命令前插入 72 字节 LC_SEGMENT_64,header 区总长保持 16384(原 load commands 结束于 15088,余量充足);
  3. ncmds += 1,sizeofcmds += 72;
  4. __LINKEDIT 段命令 vmaddr/fileoff += PAGE;
  5. 所有指向 __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 泛化:主程序 __TEXT vmaddr=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 为 cafebabe fat 壳包单 arm64 切片。用 lipo -thin arm64 抽出 → 加固 thin → lipo -replace arm64 回填,保持 fat 结构与原签名壳。
  • 逐级签名:改写后自底向上 codesign -f -s - 各 .framework,再签主 .app bundle。
  • 注入前体检: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. 下一步(未完成项,如实列出)

  1. 送检 V4.6.6:验证 09 §1 核心假设。过 → 收工;仍命中 → 09 §3 阶梯 A(dlsym 表 + 名字加密)。这是唯一能证实"桥接即过"的步骤,尚未做。
  2. 真机功能回归:讯飞语音、书籍下载/解压(ZipZap/ZIPFoundation/SSZipArchive)、AliyunPlayer 播放、GCDWebServer——878 处改写后未验证运行时行为。改写只动调用目标(桥接 ABI 透明尾调用),风险低但需实测确认。
  3. 正式签名:ad-hoc 仅够静态扫描;真机安装/提审需开发者身份 + entitlements + Provisioning 保留(整包重签需 --entitlements 逐包传递)。
  4. arm64e / __auth_stubs:本包全为 arm64(常规 __stubs+__got)。若后续样本含 arm64e 切片,需处理认证指针桩(__auth_stubs/__auth_got)——当前未覆盖。
  5. 运行时防护正交项(05 计划):GOT 完整性校验、反调试——静态改写不覆盖,Frida 等运行时 Hook 仍需单独处理。