在 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>
8.9 KiB
SSZipArchive 动态 Framework 保护试点
日期:2026-11-11。范围:工程内 readoor-test 副本的独立观察包,以及已审核 SSZipArchive 的四个文件函数导入。PDF 越界修复、完整业务回归和检测报告复测继续暂缓。
实施机制
SSZipArchive 原函数调用 → SDK 内原 stub/GOT
→ dyld 绑定至 IGArchiveGuard.framework 的 ig_a0…ig_a3
→ 校验系统提供方、代码前缀、缓存地址和 SDK GOT
→ 间接调用 fopen / fread / fwrite / fclose
这里由 dyld 处理镜像间绑定,不把 SDK 的 BL 指令写成主程序地址。SDK 的 __text 保持不变,变化在绑定表、符号表、加载命令和重新生成的签名中。不同签名不能用整文件相等代替运行代码相同:最终两包主程序及保护库排除签名后相同,SDK 的 __text 相同,见 package-v2-comparison.json。
tools/macho_guard/redirect_framework_imports.py 同步更新 LC_DYLD_CHAINED_FIXUPS 的符号名称/库序号及 LC_SYMTAB 的名称/库序号,再在已验证的零填充中增加 LC_LOAD_DYLIB。导入索引、指针链、SDK 段地址及机器码不移动。映射为 _fopen → _ig_a0、_fread → _ig_a1、_fwrite → _ig_a2、_fclose → _ig_a3;不是运行中全进程 interpose。
当前只接受 thin arm64、two-level 动态库、无压缩且格式为 DYLD_CHAINED_IMPORT 的绑定。四个函数必须各有唯一且来自 libSystem 的非 weak 导入;缺失、重复、名称重叠、头部空间不足、格式或摘要变化均拒绝输出。已审核 SDK SHA256:485c0c95b4701a4e51625e16b6c2a9781c1a8a6f6c9b9cbe392709ecfc95191a。不支持 arm64e/PAC、其他 chained 格式或任意 SDK 无条件处理。
运行时与错误语义
defender/dispatch/IGArchiveGuard.{c,h} 固定四种函数签名,以线程安全 once 解析和缓存地址,复用 IGResolve 和 IGAntiHook 的提供方/序言检查。每次转发校验对应缓存及 16 字节代码基线,同时核对 SDK 四个非惰性 GOT 槽是否仍指向保护入口。缺槽、重复镜像、不可读等标记不可验证。普通转发保留原返回值、系统错误、FILE*、元素计数和 errno,不增加重试。
异常时拒绝:fopen 返回 NULL,fread/fwrite 返回 0,fclose 返回 EOF;errno 分别使用 EACCES(异常)、ENOSYS(不可验证)、EDEADLK(解析重入)。拒绝路径不能移植地设置 FILE 内部 ferror 标志,拒绝 fclose 也可能保留未关闭流。因此该异常状态不能被称为完整 stdio 兼容;业务错误传播、取消和恢复仍需覆盖。保护入口拒绝机制不受 Swift observe 开关控制。
导出的 ig_archive_check() 返回 0/1/-1(正常/检测异常/不可验证),仅观察构建导出只读计数 ig_archive_counter()。业务库不含地址覆盖和测试豁免;IG_ARCHIVE_TESTING 只用于宿主 ABI fixture。主程序在现有安全事件和 SDK 边界读取库状态及计数,记录到独立观察日志,不替换既有 Defender 的原因码和业务策略。普通构建不包含此观察记录;本轮未把新 SDK 状态接入生产强制业务门禁。
对照方法
新观察参数 --IGArchiveReplayStyle 只在 IG_OBSERVATION 且 Bundle ID 为 cn.touchv.iosguard.observe.* 时生效。进入指定词书时,将同一样式包重新下载并解压到现有临时目录;正式目录已发布时仍沿原 publish 分支保留正式目录。它不伪造账号、不跳过鉴权、不改服务器数据;无参数时沿原缓存逻辑。
服务在成功解压后记录文件数、总字节及聚合 SHA256,不记录路径、URL、账号、文件名。两包使用同一来源的 Release 主程序和 Link Map;两包均保留既有 ZipZap 两处改写。基线嵌入相同保护库,但 SDK 不依赖它,保留原系统绑定;保护包增加 SDK 依赖和四处导入重定向。聚合摘要只用于两次新解压的对照,不代表远程资源签名校验或可信发布。
阶段中曾尝试备份后通过设备文件服务重置样式缓存,返回 CoreDevice 7000/ActionError 3。此后观察包 Documents 出现重新初始化;现有证据不能区分发生在安装还是目录重置阶段,故停止该清理方式。仅样式缓存此前已有 9 个文件备份,未建立全观察容器备份,不声称所有观察数据已恢复原状。随后真实账号仍可打开词书,页面显示已学 0、未学 7502,词库和音频重新取得;最终有效对照使用不清目录的样式重放。设备操作始终指定独立观察 Bundle ID,未针对原业务 App。原始日志保留,不将该失败尝试当成成功的定点清理。
当前验证
readoor31Release 及独立 UI Runner 构建通过;两包嵌套签名严格验证通过,各 615 个文件哈希核对通过。- 59 项宿主/工具测试通过,其中本轮 14 项:真实 SDK 格式和拒绝路径、stdio 语义、并发、重入、缓存篡改拒绝、普通构建排除测试/观察接口,以及 Apple Silicon 上真实动态 SDK chained binding/GOT 篡改检测、拒绝与恢复。测试 fixture 的可写 GOT 操作只存在于测试源码,未编入业务库。
- 最终 Release 的四个入口均保留间接分支,未发现对原四个系统函数的直接/GOT 导入链;见
guard-v2-static-traces.json、guard-v2-disassembly.txt和guard-v2-imports.txt。 baseline-v2-wordbook.xcresult与guard-v2-wordbook.xcresult均通过:首页指定资源 → 稳操胜券课件 → 样式下载解压 → 词书页面 → 前后台恢复;显示已学 0 / 未学 7502。- 基线样式解压约 38.53 ms,保护包约 43.02 ms(增加约 4.48 ms)。单次、单机、不同运行时刻的小样本,不推导总体性能或稳定性指标;记录区间包含开始事件的观察开销,未单独扣除观测成本,不包括网络下载耗时和自动化动画等待。
- 保护包实际 dispatched:fopen 10、fread 388、fwrite 466、fclose 10;与 attempted 一致,rejected 全为零,库完整性状态为 0。四入口共 874 次调用。基线日志
archive_guard_loaded=false,保护包为 true。 - 两包输出均为 9 个文件 / 1,890,776 字节,聚合 SHA256 一致:
7043dfcd54c6ce47154feb48b8ff2a19834c5f8cd4c28dabaa012fc96537ed79。这份对照针对本轮新解压的内容,不据此声称此前缓存备份与远程资源完全一致。 - 保护解压阶段两次既有 Defender 快照无检测/不可用项;SDK 完整性状态单独记录。ZipZap 计数仍为零,不混作 SDK 命中。
guard-v2-cache-v2.xcresult 验证无重放参数的正常缓存及返回重进、前后台恢复通过;最新进程 9 条库观察事件均为状态 0,style/dict/sound 命中缓存,没有解压调用,四个函数计数均零(冷启动重置)。此前 guard-v2-cache.xcresult 因营销弹窗在自动化等待期间消失而失败,尚未进入资源;失败日志保留。最终保护阶段既有 Defender 共 5 次快照,检测/不可用项均为零;观察状态不等于攻击测试。
打包与回滚
在既有 tools/business_regression/prepare_observation_app.py 命令上追加 --archive-guard,构建嵌入库、改写 SDK,再按从内到外签名和生成 IPA;对照追加 --archive-baseline。不能同时加主程序 --baseline,避免对照同时改变 ZipZap。输出必须新目录,原 SDK 不写回工程。
最终包位于 test-results/step5-ssziparchive/{guard-v2-package,baseline-v2-package}/。取消本轮 SDK 保护可安装已签名基线包或用相同源构建取消 --archive-guard;不要在已签名 App 中只删除保护库。取消观察能力时移除宏和专用运行参数,普通构建中观察代码被剔除。备份在 test-results/step5-ssziparchive/before/,恢复时仅逐个撤销本轮修改并保留已有工作。
SDK 更新必须重新审查摘要及格式后才更新允许的输入,随后构建、绑定改写和签名步骤可自动执行;此试点不自动信任新版本。
验收边界与下一步
当前只覆盖该 SDK 的四个导入,其他 I/O、其他动态库、内部绕过这些导入的路径不在范围。入口名、导入依赖、解析器、地址缓存和混淆常量仍可被静态分析;同进程攻击者可能同时修改校验代码和基线、直接绕过入口。代码前缀检查只覆盖部分常见蹦床,不代表所有 inline Hook 均能拦截。
本轮真机证明正常业务可进入保护路径、输出与同构建基线一致;GOT 篡改正向测试在宿主完成,iPhone 上受控 GOT/实际系统代码 inline Hook、失败/取消和大包性能尚未完成。下一阶段应先补这些验证,再推广库与 ABI 范围;不能把此试点等同于原报告复测通过。
最终摘要:docs/evidence/20261111-ssziparchive-framework-summary.json。源码、测试、日志和关键包记录冻结到 test-results/step5-ssziparchive/final-evidence/,哈希清单不含自身。