在 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>
12 KiB
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. 仍能被恢复或绕过的路径
- 入口名仍提示用途;编码名可以解码;
dlsym/dladdr仍可识别。本轮提高简单调用图追踪成本,没有实现不可静态分析。 - 自研追踪只对本地 BL/B、有界深度、报告的 12 类系统 stub 和经典 GOT 桥接做检查,不解析所有寄存器数据流、TLS、初始化回调或符号解码。未解析间接调用不构成安全证明。
- 提供方路径白名单不是签名身份验证;
dlsym/dladdr/vm_read_overwrite自身也可能被攻击者干扰。现有 GOT 检查仍允许部分系统内转发,不能覆盖全部重绑定方式。 - 初始代码快照可能在攻击后建立;同进程攻击者可同时修改缓存、期望值或校验函数。前缀之后的改写及校验与调用之间的竞态仍存在。
- 当前序言只覆盖部分 arm64 蹦床,不能识别所有 Hook,也可能把合法的系统转发判成异常;arm64e/PAC 及不同系统版本需要独立验证。
- 未完成完整 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 项真机诊断分开统计,不合并宣称整包验收通过。