在 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>
4.7 KiB
4.7 KiB
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(sha2565caa6101…,与 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. 边界与风险
_write/_close仍为导入符号:桥接 GOT 引用 + App 其他代码使用;跟踪间接调用的检测器可还原调用链。- armv7 切片原样保留,仍引用原系统符号,不享有本次重定向效果;当前构建只验证 arm64,未验证 armv7 构建。
- 模拟器切片未覆盖(原库本就无 simulator 架构,行为不变)。
- 未做真机功能回归(书籍解压/下载流程依赖 ZipZap 写文件);未提交检测引擎复测。
- 本试点只覆盖
_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. 下一步
- 真机安装加固版 readoor31.app,回归书籍下载/解压/阅读流程。
- 用原检测引擎复测,确认 ZipZap 对应命中变化。
- 视结果扩大映射(StsPDF 内核库的 fopen 系列是下一个候选)。