Files
iOSGuard/docs/08_ZIPZAP_PILOT_BUILD_VERIFICATION.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

85 lines
4.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.
# 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 系列是下一个候选)。