# 14 · ZipZap 三层防护试点与验收记录 日期:2026-11-10。范围为 iOSGuard 和工程内 `readoor-test` 副本;原工程 `/Users/shenlei/Work/ReadBook/readoor` 未写入。沿用 `readoor31` target 和 ZipZap,不切回构建失败的旧 target。 后续观察构建、45 项当前测试和独立业务包状态见 [观察包业务回归](15_OBSERVATION_BUSINESS_REGRESSION.md);下文 44 项是第二步冻结证据,不覆盖业务回归。 ## 1. 本次完成范围 | 层次 | 已实现 | 验证边界 | | --- | --- | --- | | 直接调用关系 | 使用同次 Release Link Map,把 ZipZap 两处 BL 改指向已链接的调度入口 | 精确核对调用者/入口符号地址、改写次数、分支范围,其他指令字节不变 | | 桥接后的目标追踪 | 符号名编码、首次运行时解析、校验、缓存、间接调用 | 最终 Release 为 `br x3` / `br x1`;不是原来的 GOT 转接;不能据此认定静态分析无法恢复目标 | | 运行时 Hook | 接入 Defender;保留提供方、GOT、序言探针,新增缓存指针和初始代码前缀检查 | 宿主真实 GOT 改指、真机独立诊断私有缓存篡改拒绝等通过;受控真机 inline Hook 与完整业务回归仍待完成 | 仅覆盖两个调用点: ```text -[ZZFileChannelOutput writeData:error:] → IG_dispatch_write → 校验后的 write 地址 -[ZZFileChannelOutput close] → IG_dispatch_close → 校验后的 close 地址 ``` 这是一轮试点,尚未推广至讯飞、AliyunPlayer 或全部报告函数。没有在同一产物上叠加旧的整包 GOT 桥接改写。副本中的 ZipZap 已恢复原始静态库,避免先重定向成 `IG_write/IG_close` 后又重复改写;其之前状态保存在 `test-results/step2/before/`。 ## 2. 实现位置与顺序 - `tools/macho_guard/redirect_to_runtime.py`:链接后定点改写与有界追踪。 - `tools/macho_guard/profiles/zipzap.json`:调用者、原符号、目标入口及预期次数。 - `defender/dispatch/IGDispatch.{c,h}`:固定 C 签名入口、`pthread_once`、线程重入防护、原子缓存。 - `defender/resolve/IGResolve.{c,h}`:解析结果区分 CLEAR / DETECTED / UNAVAILABLE,拒绝无效或截断的符号名。 - `defender/anti_hook/IGAntiHook.{c,h}`:提供方、GOT、arm64 序言检查;代码读取使用 `vm_read_overwrite`,读失败不冒充正常。 - `defender/IGDefender.c`:聚合调度完整性检查。 - 副本的 `Base/Security/IGDefender/`:同步上述模块,通过 `scripts/add_igdefender.rb` 加入现有 target。 执行顺序为:先编译并链接运行时入口 → 保存同次 Link Map → 在可执行文件副本上改写指定分支 → 从内到外签名 → 打包与复核。实际签名发布时,必须在改写后使用匹配的开发者身份、profile 和 entitlements;下一次 Xcode 构建会生成新的未改写文件,需重新执行改写。当前尚未自动接入每次 Archive。 `dlsym/dlopen` 等解析器启动依赖保留原调用,不能把启动依赖再重定向回依赖自身的解析器。新增函数必须逐个适配 ABI、错误返回和所有权语义,不能把可变参数、结构体返回或 C++ 调用一律转换为通用 `void *` 函数。 ## 3. 运行语义与处置 首次解析地址必须通过提供方和序言检查;初始化后保存地址及前 16 字节。每次 `write/close` 前复核缓存、提供方、序言和代码前缀。正常调用恢复进入时的 `errno`,保留系统函数返回值;不重试 `EINTR`,不补齐短写,不重复 `close`。 调度入口本身拒绝不可信调用:篡改返回 `-1/EACCES`;校验不可用返回 `-1/ENOSYS`;解析重入返回 `-1/EDEADLK`。**这部分不受 Swift 观察模式控制**,可能使解包写入或关闭失败,必须真机覆盖 ZipZap 下载、解包、取消和错误路径后再发布。 Swift 策略单独保留 `unavailableReasons`,观察模式记录,强制模式拒绝不可用或强信号对应的已接入新支付入口。`RDOrderViewController.payOrder()` 新增 `allowsSensitiveOperation(.beforePayment)`;已有 Apple 待处理交易的验证/补单沿现有分支继续,避免阻断交易收尾。其余支付、VIP、登录和激活入口尚未逐一接入。`applyDecision` 的日志本身不会限制所有入口。 启动重复调用共用一次评估,回前台与选定支付入口重新扫描;前台观察者只注册一次,评估状态统一到主线程。扫描目前同步执行,尚未完成启动、支付前扫描及高频文件写入的真机耗时测量。 ## 4. Release 与静态证据 有效归档:`test-results/step2/zipzap-runtime-final-v3/`。`test-results/step2/zipzap-runtime-final/` 是 Link Map 编码问题导致的失败记录,不作通过依据;`-v2` 为之前的通过记录,本轮以 `-v3` 为准。 | 检查 | 结果 | | --- | --- | | 构建 | `readoor31` / Release / iphoneos arm64,通过;OtherPay 同步接线但未单独构建 | | 本次产物版本 | `2.156.0` / `2.156.0.1` / `com.ecnup.aSCLdl2` | | 自动化测试 | 44 项通过,无跳过,执行冻结源码 | | 本次整包直接分支规则 | 558→556,仅定点减少 2 处 | | write 调用点 | `0x100c1f604` → `_IG_dispatch_write` `0x100485924` | | close 调用点 | `0x100c1f800` → `_IG_dispatch_close` `0x100485a5c` | | 调度对象导入 | 无 `_write` / `_close` / `_memcmp` | | Release 测试后门 | 最终 App 无 `ig_dispatch_test_*` 符号 | | 静态追踪 | 两处原目标 stub 路径消失;两个调度入口存在未解析间接分支 | | 结构/打包 | 原构建文件不变、UUID 不变、嵌套 ad-hoc 签名及严格验证、重打包后扫描和哈希一致 | 测试包括:文件调用语义/errno、短写/EAGAIN、EINTR 不重试、并发、构造阶段调用、初始化失败、解析重入、缓存篡改拒绝、解析失败、arm64 序言指令分类、真实宿主 GOT 改指、Swift 观察/强制策略,以及改写工具的拒绝路径。arm64 指令分类测试不等于真机实际修改系统代码后的检测。 主要证据:`manifest.json`、`redirect-report.json`(逐调用点及前后追踪)、三个 `.asm`、`IGDispatch-imports.txt`、`source-snapshot/`、`source-files.json`、`commands.log`、`build-release.log`、`guarded.ipa`、`evidence-hashes.json`。大文件由 Git 忽略,需单独备份。 第一步 `test-results/verification/20261110-step1-final/` 的 v2.199.0 / OtherPay / 878→0 归档保持独立,不与本次新构建的 558→556 混用。原漏洞报告为 v2.197.2 / `com.ecnup.azZVz02`,本轮仍不是原报告同一二进制。 ## 5. 复现命令 在 iOSGuard 根目录,先构建: ```bash xcodebuild build -workspace readoor-test/readoor.xcworkspace \ -scheme readoor31 -configuration Release -sdk iphoneos \ -destination 'generic/platform=iOS' -derivedDataPath test-results/DerivedData \ -jobs 4 CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO \ COMPILER_INDEX_STORE_ENABLE=NO LD_GENERATE_MAP_FILE=YES ``` 保存构建日志后验证(输出目录必须不存在): ```bash python3 tools/macho_guard/verify_runtime_pilot.py \ --app test-results/DerivedData/Build/Products/Release-iphoneos/readoor31.app \ --link-map test-results/DerivedData/Build/Intermediates.noindex/readoor.build/Release-iphoneos/readoor31.build/readoor31-LinkMap-normal-arm64.txt \ --dispatch-object test-results/DerivedData/Build/Intermediates.noindex/readoor.build/Release-iphoneos/readoor31.build/Objects-normal/arm64/IGDispatch.o \ --build-log test-results/step2/build-release.log \ --output test-results/step2/new-runtime-run ``` 构建日志、Link Map、对象文件必须来自同一次构建;更换日志路径时同步参数。Link Map 符号地址与实际二进制不一致会拒绝,不能用旧 Map 套新包。 ## 6. 仍能被恢复或绕过的路径 1. 入口名仍提示用途;编码名可以解码;`dlsym/dladdr` 仍可识别。本轮提高简单调用图追踪成本,没有实现不可静态分析。 2. 自研追踪只对本地 BL/B、有界深度、报告的 12 类系统 stub 和经典 GOT 桥接做检查,不解析所有寄存器数据流、TLS、初始化回调或符号解码。未解析间接调用不构成安全证明。 3. 提供方路径白名单不是签名身份验证;`dlsym/dladdr/vm_read_overwrite` 自身也可能被攻击者干扰。现有 GOT 检查仍允许部分系统内转发,不能覆盖全部重绑定方式。 4. 初始代码快照可能在攻击后建立;同进程攻击者可同时修改缓存、期望值或校验函数。前缀之后的改写及校验与调用之间的竞态仍存在。 5. 当前序言只覆盖部分 arm64 蹦床,不能识别所有 Hook,也可能把合法的系统转发判成异常;arm64e/PAC 及不同系统版本需要独立验证。 6. 未完成完整 App 业务回归、受控真机 inline Hook、所有正常 SDK 误报与性能统计、原报告同版本及 V4.6.6 厂商复测,不能宣称报告问题全部解决。 ## 7. 回滚与后续验收 `test-results/step2/before-state.json` 记录改动前哈希,`before/` 保存工程、安全入口、ZipZap 和既有 Defender 文件。回滚应恢复相互匹配的工程配置与整套模块,并移除本轮新增源引用;不要只恢复一个静态库或仅删除调度模块。订单控制器仅撤销本轮 `payOrder()` 安全门禁插入,保留其他既有修改。 只需取消链接后改写时,使用归档 `baseline/Payload/readoor31.app` 或重新构建未改写 App;仍需按分发方式重新签名。默认观察模式仅控制 Swift 业务门禁,不是调度层回滚开关。 独立诊断真机验证已完成,见下一节。下一验收顺序:合法签名的 App 观察包执行下载/解包及支付收尾回归 → 受控真机提供方/GOT/inline Hook 正向验证与性能测量 → 固定同版本输入向 V4.6.6 复测。通过后再按 ABI 分类推广到其他调用者。 ## 8. 独立诊断真机结果 设备:iPhone 16 Plus,设备工具报告 iOS `27.2`。使用现有通配开发 profile 签名,测试专用 Bundle ID 为 `cn.touchv.iosguard.dispatchpilot.20261110`;安装前确认不存在同名应用,测试后已卸载。没有安装覆盖现有 readoor。 有效记录:`test-results/step2/device-dispatch-v5/`。`console.log` 包含明确的 8 个逐项 PASS 与最终 PASS,`launch.json` 记录 exitCode=0;Defender 正常环境扫描 `detected=0 / unavailable=0`。通过项为:errno/返回值和文件语义、短写/EAGAIN、EINTR 不重试、8 线程并发、解析重入、解析失败、序言指令分类、私有缓存改指后拒绝调用。构造阶段调用由共用 fixture 一并执行。 该程序直接执行共用测试 fixture,再退出诊断进程;没有业务 UI,也不执行真实支付或网络请求。早期使用界面启动回调的诊断尝试未取得逐项结果,不计为通过;`v5` 改为直接执行测试并使用系统日志确认。短写测试的大缓冲区改为堆分配,避免依赖真机线程栈大小。 源码入口为 `tests/fixtures/dispatch_device.m` 和 `tools/macho_guard/build_dispatch_device.py`。构建脚本只接受专用 Bundle ID 前缀和匹配的有效通配开发 profile,不修改开发者门户;安装、运行与卸载单独执行。诊断程序使用 `IG_DISPATCH_TESTING` 允许改自身测试缓存,**不作为业务 App 发布包**。其冻结源码以该诊断目录的 `source-snapshot/` 为准;Release 静态归档独立保存同次构建与宿主测试输入。 此结果不包含实际修改系统函数代码的 inline Hook,也未在完整 App 中执行 ZipZap 解包。44 项自动化测试与 8 项真机诊断分开统计,不合并宣称整包验收通过。