Files
iOSGuard/docs/10_MACHO_GUARD_SELFTEST.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

105 lines
7.7 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.
# 10 · macho_guard 链接后改写器:自测通过
日期:2026-11-10。状态:**第 1 层检测自测清零**——单二进制 336 → 0(§1-6),整包 31 个 Mach-O 共 878 → 0(§7),结构合法可签。**仍未向 V4.6.6 送检**——"桥接即过"依旧是待验证假设(见 [09](09_ECNUP_REMEDIATION_DIRECTION.md) §4)。
关联:方向与改写面实测见 [09](09_ECNUP_REMEDIATION_DIRECTION.md),检测器判定标准推断见 09 §1。
> 后续已从根目录 IPA 重新运行整包验证并保存在 `test-results/verification/20261110-step1-final/`,含源码快照、前后包、逐二进制 UUID/哈希、逐调用点 CSV、逐指令校验和签名日志;复现入口见 [13](13_REPRODUCIBLE_BASELINE.md)。下文 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. 复现命令
```bash
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——独立复现。
命令:
```bash
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 仍需单独处理。