在 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>
85 lines
4.7 KiB
Markdown
85 lines
4.7 KiB
Markdown
# 08 · readoor31 ZipZap 重定向接入试点验证
|
||
|
||
日期:2026-11-10
|
||
范围:`readoor-test` 副本(原工程未动)。readoor31 target,Release / iphoneos / arm64,Xcode iPhoneOS 27.1 SDK。
|
||
|
||
## 1. 结论
|
||
|
||
**链接前重定向在真实 App 构建中打通**:改写后的 libZipZapGuard.a + 桥接代码已编入 readoor31 最终二进制,ZipZap 对 `_write`/`_close` 的直接调用全部改道为 `bl _IG_write` / `bl _IG_close`,桥接内部为 GOT 取址 + `blr` 间接调用。构建成功,导入符号表与基线完全一致。
|
||
|
||
这不是"隐藏系统调用":`_write`/`_close` 仍是导入符号(桥接自身引用),扫描导入表/GOT 的检测器仍可见。边界见 §5。
|
||
|
||
## 2. 事实修正
|
||
|
||
- readoor31 **确实链接 ZipZap**:链接命令为 `-lZipZap`(经 LIBRARY_SEARCH_PATHS 解析到 `readoor/BookShelf/Classes/Factorys/ZipZap/libZipZap.a`)。早期用完整文件名 grep 日志导致误判。
|
||
- 讯飞 iflyMSC 未被 readoor31 链接(仅旧 readoor target 使用,且该 target 打包失败),故本试点改用 ZipZap。
|
||
- 原库为 **fat armv7+arm64**;重定向工具仅支持 arm64,armv7 切片原样保留。
|
||
|
||
## 3. 接入方式(零 pbxproj 改动)
|
||
|
||
```
|
||
IGFileBridge.c ──clang -arch arm64 -miphoneos-version-min=15.0──▶ IGFileBridge.o
|
||
IGFileBridge.o ──ar r──▶ libZipZapGuard.a # 桥接随库分发,App 无需加编译源
|
||
原库 armv7 切片 + 改写库(arm64) ──lipo -create──▶ fat
|
||
cp fat ──▶ readoor-test/.../ZipZap/libZipZap.a # 原位替换,工程引用不变
|
||
```
|
||
|
||
- 原库备份:`test-results/baseline/libZipZap.a`(sha256 `5caa6101…`,与 redirect-report 的 source_sha256 一致)。
|
||
- 回退:把备份拷回原路径重新构建即可。
|
||
|
||
## 4. 验证证据(基线 vs 加固)
|
||
|
||
| 项 | 基线(BUILD SUCCEEDED) | 加固(BUILD SUCCEEDED) |
|
||
| --- | --- | --- |
|
||
| `writeData:error:` 内调用 | `bl 0x100e7add8 ; stub for: _write` | `bl _IG_write` |
|
||
| `ZZFileChannelOutput close` 内调用 | `bl 0x100e7989c ; stub for: _close` | `bl _IG_close` |
|
||
| `_IG_write` / `_IG_close` 定义 | — | `T` @ 0x100c21d60 / 0x100c21da4 |
|
||
| 桥接函数体 | — | `adrp+ldr`(GOT/literal pool 取 `_write`/`_close` 地址)→ 栈存 → `blr x8`;`optnone` 生效,未被直连化 |
|
||
| 导入符号表 | 3586 项 | 3586 项,diff 为空 |
|
||
| dead_strip | `ZZFileChannelOutput` 方法保留 | 同左,另有 `_IG_*` 两个新本地符号 |
|
||
|
||
关键机器码(加固版 `_IG_close`):
|
||
```
|
||
adrp x8, … ; ldr x8, [x8, #0xc10] ; literal pool symbol address: _close
|
||
str x8, [sp] ; ldr x8, [sp] ; … ; blr x8
|
||
```
|
||
|
||
资产:
|
||
- 基线:`test-results/baseline/`(原库、undefined 列表、44M Link Map、构建日志、metadata)
|
||
- 加固:`test-results/guarded/`(undefined 列表、链接命令、构建日志 `test-results/guarded-build.log`)
|
||
- 改写报告:`readoor-test/iOSGuardIntegration/redirect-report.json`(19 成员中 1 个改动,2 处引用)
|
||
|
||
## 5. 边界与风险
|
||
|
||
1. `_write`/`_close` 仍为导入符号:桥接 GOT 引用 + App 其他代码使用;跟踪间接调用的检测器可还原调用链。
|
||
2. armv7 切片原样保留,仍引用原系统符号,不享有本次重定向效果;当前构建只验证 arm64,未验证 armv7 构建。
|
||
3. 模拟器切片未覆盖(原库本就无 simulator 架构,行为不变)。
|
||
4. 未做真机功能回归(书籍解压/下载流程依赖 ZipZap 写文件);未提交检测引擎复测。
|
||
5. 本试点只覆盖 `_write`/`_close` 两个符号;fopen 系列在 readoor31 链接路径上的候选库(如 StsPDF 系列内核库,基线中有 401 个符号入库)尚未处理。
|
||
|
||
## 6. 复现命令
|
||
|
||
```bash
|
||
# 从未改写的备份抽取 arm64,输出新库;不要重复重定向已替换的库。
|
||
lipo test-results/baseline/libZipZap.a -thin arm64 -output /tmp/ig-zipzap-original-arm64.a
|
||
python3 tools/static_sdk_redirect/redirect_symbols.py \
|
||
/tmp/ig-zipzap-original-arm64.a /tmp/ig-zipzap-redirected-arm64.a \
|
||
--mapping tools/static_sdk_redirect/mappings/zipzap.json
|
||
|
||
# 桥接注入 + fat 合并 + 原位替换(见 §3)
|
||
xcrun --sdk iphoneos clang -arch arm64 -miphoneos-version-min=15.0 -Os \
|
||
-c readoor-test/iOSGuardIntegration/IGFileBridge.c -o IGFileBridge.o
|
||
# … ar r / lipo -create / cp(工作目录产物在 test-results/.work/)
|
||
|
||
# 构建
|
||
cd readoor-test && xcodebuild build -workspace readoor.xcworkspace -scheme readoor31 \
|
||
-configuration Release -sdk iphoneos \
|
||
-derivedDataPath ../test-results/DerivedData
|
||
```
|
||
|
||
## 7. 下一步
|
||
|
||
1. 真机安装加固版 readoor31.app,回归书籍下载/解压/阅读流程。
|
||
2. 用原检测引擎复测,确认 ZipZap 对应命中变化。
|
||
3. 视结果扩大映射(StsPDF 内核库的 fopen 系列是下一个候选)。
|