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

4.7 KiB
Raw Permalink Blame History

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. 复现命令

# 从未改写的备份抽取 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 系列是下一个候选)。