Files
iOSGuard/docs/14_ZIPZAP_RUNTIME_DISPATCH_PILOT.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

12 KiB
Raw Blame History

14 · ZipZap 三层防护试点与验收记录

日期:2026-11-10。范围为 iOSGuard 和工程内 readoor-test 副本;原工程 /Users/shenlei/Work/ReadBook/readoor 未写入。沿用 readoor31 target 和 ZipZap,不切回构建失败的旧 target。

后续观察构建、45 项当前测试和独立业务包状态见 观察包业务回归;下文 44 项是第二步冻结证据,不覆盖业务回归。

1. 本次完成范围

层次 已实现 验证边界
直接调用关系 使用同次 Release Link Map,把 ZipZap 两处 BL 改指向已链接的调度入口 精确核对调用者/入口符号地址、改写次数、分支范围,其他指令字节不变
桥接后的目标追踪 符号名编码、首次运行时解析、校验、缓存、间接调用 最终 Release 为 br x3 / br x1;不是原来的 GOT 转接;不能据此认定静态分析无法恢复目标
运行时 Hook 接入 Defender;保留提供方、GOT、序言探针,新增缓存指针和初始代码前缀检查 宿主真实 GOT 改指、真机独立诊断私有缓存篡改拒绝等通过;受控真机 inline Hook 与完整业务回归仍待完成

仅覆盖两个调用点:

-[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 根目录,先构建:

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

保存构建日志后验证(输出目录必须不存在):

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 项真机诊断分开统计,不合并宣称整包验收通过。