在 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>
105 lines
7.7 KiB
Markdown
105 lines
7.7 KiB
Markdown
# 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 仍需单独处理。
|