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>
This commit is contained in:
shenlei
2026-11-12 22:16:47 +09:00
co-authored by Claude Opus 4.8
parent ff0aee7f47
commit 599e1da5ce
91 changed files with 8751 additions and 0 deletions
@@ -0,0 +1,190 @@
# readoor 漏洞报告分析与 iOSGuard 加固实施方案
日期:2026-11-10。状态:分析与实施设计,尚未实施修复、接入或完成检测机构复测。
后续进展:已实现独立的 [静态 SDK fopen 重定向 PoC](06_STATIC_SDK_FOPEN_POC.md),并验证讯飞 SDK 副本的符号改写与可重定位链接。[通用重定向工具](07_GENERIC_STATIC_SDK_REDIRECT.md)与 [readoor31 ZipZap 构建试点](08_ZIPZAP_PILOT_BUILD_VERIFICATION.md) 已完成;整改方向结论(检测器判定标准、链接后 Mach-O 改写器选型、升级阶梯)见 [09](09_ECNUP_REMEDIATION_DIRECTION.md)。下文保留最初分析记录;readoor 正式接入、真机业务回归和检测机构复测仍未完成。
## 1. 目标与核查边界
iOSGuard 的首要目标是为 iOS 项目提供反 Hook 与 App 加固能力,并对指定安全报告形成可追踪的整改闭环。readoor 是首个验证项目。本轮仅分析报告、核查代码、制定实施方案,不修改 readoor 源码、工程、依赖或签名产物。
核查输入:
- 报告:`/Users/shenlei/Desktop/1.docx`,通过 DOCX 内的 Word XML 提取文本、表格内容;本轮未进行页面视觉核查。
- iOSGuard:`/Users/shenlei/Work/ReadBook/iOSGuard`,HEAD `ff0aee7`。
- readoor:`/Users/shenlei/Work/ReadBook/readoor`,HEAD `d640290a`,存在用户未提交修改,分析基于当前工作区。
- `AutoPacking/config.json` 中配置 `306` 的名称、Bundle ID 与报告相符。仍需核对当时实际使用的 scheme、target、编译宏、依赖版本及归档产物。
本轮未获得报告对应的原始 IPA、同次构建 dSYM、Link Map 和完整检测规则;在 readoor 的 `build/`、`AutoPacking/` 中未找到 IPA。当前源码与 2026-10-22 被测二进制不能直接视为同一版本。报告中的匿名地址暂不归因到具体源码或 SDK。
本轮尝试在线核验 Apple 与 Clang 官方资料,但检索工具未返回内容。涉及平台 API 可用性、分发政策的实施结论,需在落地时结合目标 SDK 与官方资料再核验;本方案不作上架保证。文中的源码结论以本地证据为依据。
## 2. 报告实际说明了什么
| 字段 | 报告原文信息 |
| --- | --- |
| 应用 | ECNUP外语 |
| 版本 / Bundle ID | `2.197.2` / `com.ecnup.azZVz02` |
| 文件 | `ECNUP外语_2.197.2_AppOnly.ipa` |
| MD5 | `83daa763da5a226b914201d3e31f969e` |
| 检测日期 / 引擎 | `2026-10-22` / `V4.6.6` |
| 报告所列 SDK / 最低系统 | iOS 26.5 / iOS 15.0,尚未用 IPA 核验 |
| 风险 | 外部函数显式调用风险、系统调用暴露风险检测,均被机构标为高危 |
报告汇总写有 7 个检测项目、2 个风险项目,正文只提供这 2 项详情;不能据此推断另外 5 项的具体内容或防护状态。两项各展示 50 条记录,无法确认是否为完整清单或展示上限。
按报告中“调用方描述 + 被调符号”去重后的统计:
| 检测项 | 展示记录 | 去重描述 | 符号分布(按展示记录计数) |
| --- | ---: | ---: | --- |
| 外部函数显式调用 | 50 | 39 | `_dlopen` 1、`_dlsym` 17、`_fopen` 32 |
| 系统调用暴露 | 50 | 47 | `_syscall` 2、`_exit` 23、`_fork` 1、`_read` 2、`_write` 14、`_open` 2、`_close` 1、`_unlink` 4、`_getpid` 1 |
例如 `#0x1013372b4 -> _dlsym` 重复 10 次。去重描述数不等于唯一机器指令数:报告可能以函数入口或内部分析节点表示地址,需向检测机构确认。
报告证据是静态调用关系,未给出成功 Hook、窃取数据或绕过支付权限的动态复现。保留机构原始评级用于整改管理,同时把“可见调用关系”“防护缺口”“已复现攻击”分别记录。
### 对报告修复建议的评估
1. **函数指针 + `optnone`**:可以作为小范围调用隐藏试点,必须检查 Release 机器码和检测机构复测结果。不能直接据此宣称反 Hook 完成。
2. **用 `dlsym` 替换全部调用**:本报告本身命中 `_dlsym`,全局替换可能转移或增加命中;首期不采用这种通用处理。
3. **把 libc 调用改为 SVC 裸系统调用**:不作为 App Store 主线方案。报告示例涉及私有调用、固定系统调用号,且出现 `PT_DENT_ATTACH` 拼写;不能作为可直接复制的工程实现。文件操作还需要保持错误码、取消、变参等语义。
4. **统一包装函数**:只在包装层内部再次直接调用目标函数,可能使扫描命中位置迁移;扫描全 App 时不保证消除命中。
5. **注入一个 Defender 库**:可以增加运行时检测,但不会自动改写原主程序及静态链接 SDK 内的现存调用点。
### 本机编译验证
环境:Xcode 27.1,Build `27A9275`;iPhoneOS SDK 27.1;目标 ARM64、iOS 15.0。使用显式声明的 `getenv` 做最小实验,不依赖 App 业务代码。
```c
extern char *getenv(const char *);
char *direct_call(const char *name) { return getenv(name); }
char *pointer_optimized(const char *name) {
char *(*fn)(const char *) = getenv;
return fn(name);
}
__attribute__((optnone, noinline))
char *pointer_optnone(const char *name) {
char *(*fn)(const char *) = getenv;
return fn(name);
}
```
复现命令(先将以上源码保存为 `call_probe.c`):
```sh
xcrun --sdk iphoneos clang -target arm64-apple-ios15.0 -O2 -S call_probe.c -o call_probe.s
```
观察结果:前两者均为 `b _getenv`;第三者通过 `_getenv@GOTPAGE`、`_getenv@GOTPAGEOFF` 加载地址,再执行 `blr x8`。这证明该工具链下 `optnone` 能保留间接调用,也证明外部符号和 GOT 引用仍存在。该实验仅验证汇编形态,未验证最终链接、LTO、原检测引擎判定或抵御 Hook 的效果。
## 3. 报告调用点与当前代码的对应关系
本节路径相对 readoor 根目录;行号为本次核查位置。确认的是当前代码/库存在对应行为,不是所有报告地址已经完成符号化。
| 报告线索 | 当前证据 | 处理方向 |
| --- | --- | --- |
| `-[STSCommonUtil convertPcmToWav:wavFilePath:] -> _fopen` | `readoor/BookShelf/Classes/Util/STSCommonUtil.m:1427` 显式 `fopen`,随后 `fwrite/fclose` | 自有源码,选为首个调用隐藏与业务回归试点;属于旧架构,要显式纳入实施范围 |
| `GCDWebServerFileRequest writeData:error:` / `dealloc` | `readoor/BookShelf/Classes/Factorys/GCDWebServer/Requests/GCDWebServerFileRequest.m:46,50,61,71` 调用 `unlink/open/write/close` | 源码随仓库提供;维护可重放补丁,回归上传、临时文件与错误路径 |
| `GCDWebServerMIMEStreamParser` / `GCDWebServerMultiPartFile` | 同目录 `GCDWebServerMultiPartFormRequest.m:95,155,211,246,288` 对应 `unlink/open/write` | 覆盖流式 multipart 和清理路径,不能仅处理单一入口 |
| `IFlySpeechSynthesizerImp`、`IFlyISVMSCHandler`、`IFlyPcmRecorder` | `readoor/BookShelf/Classes/Factorys/XunFei/iflyMSC.framework/iflyMSC` 是多架构静态归档;arm64 未定义符号中确认有 `_fopen`、`_syscall`、`_exit` | 优先供应商升级/重新构建;当前不能仅修改头文件解决库内部调用 |
| `ZZFileChannelOutput writeData:error:` | `readoor/BookShelf/Classes/Factorys/ZipZap/libZipZap.a`;`nm -arch arm64 -u` 在 `ZZFileChannelOutput.o` 下确认 `_write/_close` | 取得匹配版本源码重编或升级;需验证现有业务接口和压缩文件行为 |
| 匿名 `_dlopen/_dlsym/_syscall/_fork/_exit` 地址及 google 日志函数 | 未取得同次构建产物,未完成归属定位 | 使用原始 IPA、UUID 匹配的 dSYM、Link Map 归因;不按相近名称推测属于某 SDK |
| 当前安全守卫的 `exit(0)` | `readoor/3.0/Base/Security/RDSecurityGuard.swift:114` | 当前源码确定存在;尚不能对应报告中某个匿名 `_exit` 地址 |
静态 SDK 最终可能进入主可执行文件,因此“扫描主程序”与“仅扫描自有业务代码”不是同一个范围。不可默认 LLVM Pass 或源码包装能处理无源码预编译归档。
## 4. 当前反 Hook 防护的代码核查
以下为此次额外发现,未声称来自原报告。优先级按修复依赖和防护效果排序,不替代机构的漏洞评级。
| 优先级 | 代码证据 | 问题及建议 |
| --- | --- | --- |
| P0 | `RDInjectionDetector.swift:112–116` | 白名单缺失、损坏或 HMAC 不匹配时 `detect()` 返回 `false`,且跳过后续检测。应返回 `unavailable/integrityFailure`,继续执行独立探针,由策略层区分构建缺陷和风险 |
| P0 | `RDInjectionDetector.swift:173–176` | Bundle 外非系统镜像被无条件跳过,形成注入检测盲区。改为采集来源、归类和明确例外策略;未知镜像先输出证据,避免将任何未知状态直接升级为退出 |
| P0 | `RDInjectionDetector.swift:150–154` | 新格式路径不匹配仍回退 basename 放行,削弱精确路径约束。新格式要求精确匹配,旧格式迁移独立处理;同名不同路径不能相互覆盖 |
| P1 | `RDInjectionDetector.swift:128–138` | `DYLD_INSERT_LIBRARIES` 整串前缀检查,未逐项解析。对每个条目单独验证;路径校验需要目录边界和规范化,不能仅靠 `hasPrefix(bundlePath)` |
| P1 | `RDSecurityGuard.swift:69,85` | 调试器状态始终为 `false`。增加独立探针,返回 detected/clear/unavailable,Debug、模拟器和 Release 策略分离 |
| P1 | `RDSecurityGuard.swift` 与两个 Detector 全文 | 未见 GOT 槽位、关键函数代码完整性、Objective-C IMP 基线检测。镜像名和越狱路径不能覆盖这些 Hook 形式;作为 iOSGuard 后续能力单独验收 |
| P1 | `RDAppDelegate.swift:49–52` → `STSAppStartupProcess.m:26–27` → `startForegroundObserver()` | 同一启动链两次检测、两次注册观察者;`observer` 被覆盖,只能移除最后一个 token。统一启动入口,注册幂等,多 Scene 同样处理 |
| P1 | `RDSecurityGuard.swift:76,83–89` | 调用线程和后台队列都写 `cachedContext`,缺少统一隔离;后台又执行包含 UIKit 查询的检测。状态通过串行队列/actor 隔离,UI 查询回主线程,避免重复扫描 |
| P1 | `RDSecurityGuard.swift:17–20,122–125` | 登录/支付/VIP/激活事件仅见枚举与日志分支,未在当前检索范围发现相应调用点。需在关键操作入口接入实际策略并验证,不能把声明当成已保护 |
| P1 | `RDSecurityGuard.swift:79,112–114` | 当前高风险立即 `exit(0)`,既是显式调用点,也让误判变成直接退出。改为风险状态及受限操作策略,确保订单/交易恢复路径完整 |
| P2 | `RDJailbreakDetector.swift:132–147` | 同步 `connect` 无显式超时,启动/前台同步扫描可能产生等待。移至有预算的异步检测,默认端口只作弱信号 |
`AutoPacking/obfuscation/generate_image_whitelist.py` 已有构建期白名单和 HMAC 生成流程。后续优先沿用并修复产物生成时机、路径规则、格式验证,不再并行维护第二套名单。App 内置 HMAC 密钥的设计不应承担服务端信任根职责。
现有安全守卫注释写“仅输出风险日志”,实现却会退出,实施时须同步代码注释和行为文档。
## 5. iOSGuard 的实施架构
### A. 构建期分析与证据链
优先实现只读 `audit`:解析 `.app/.ipa` 的主程序、嵌入 Framework、dylib 和扩展;记录架构、UUID、哈希、依赖、导入符号、直接调用候选及加密状态。IPA 解包须校验路径、软链接和解压体积;解析失败、加密代码、未知架构输出“不支持/无法验证”,不能输出“通过”。
每个结果至少包含:binary 相对路径、架构、UUID、调用地址、目标符号、调用方、归属对象/SDK、证据等级、规则版本、整改状态。未定义符号只是导入证据;实际调用点需要反汇编和 stub/绑定关联。使用 Link Map 判断静态对象归属,并通过 UUID 匹配 dSYM;不同构建比较按调用方/符号/所属对象归一化,不按绝对地址比较。
交付 JSON 明细与 Markdown 汇总,支持基线差异和失败退出码。先覆盖报告中的符号集,保留扩展规则接口。
### B. 源码调用保护
第一阶段以少量 C/Objective-C 包装和编译产物检查试点。仅保护确定需要保护的调用,保持函数签名、ABI、错误码、变参和线程语义。`open` 的 mode 参数、`read/write` 的短读短写、`EINTR` 等必须有行为测试;不能批量正则替换。
Release 必须检查最终机器码;评估 LTO、dead strip 和实际发布参数。包装可改变调用形态,但不能作为 GOT/Inline Hook 的替代防护。第三方源码补丁要有版本锁定与升级检查;无源码 SDK 独立列为供应商依赖。
LLVM Pass 放在手工试点有效之后,先验证所用 Xcode/LLVM 工具链兼容性;Swift、预编译 SDK 不默认拥有同等覆盖。
### C. 运行时 Defender
推荐首期通过源码或静态库接入,输出结构化风险结果。探针与处置分离:
- 镜像、白名单完整性与调试状态:优先实现,支持启动、前台和关键操作前检查。
- GOT/符号地址:记录允许的提供方和镜像范围,区分合法转发、懒绑定与非预期重绑定;明确 PAC、chained fixups、共享缓存及架构支持范围,未支持状态不能算安全。
- 关键自有代码完整性:选定小范围、稳定函数,建立与构建产物绑定的基线。运行后才采集的基线可能已经被篡改,不能作为唯一可信基线。
- Objective-C 关键 IMP:仅保护明确的业务方法,显式容纳合法 swizzling;不能将所有方法实现变化判为攻击。
- 已知工具/越狱线索:作为组合证据,不能只靠固定名称、端口或少量文件判定安全。
设计返回 `clear / detected / unavailable` 与 reason code、证据和检查时间。耗时检测有预算,异步刷新有有效期,关键交易不能无限使用旧缓存。Debug 和测试模式单独配置,Release 不允许残留测试绕过开关。
先采用观察模式验证正常用户误判,再启用明确的能力限制。支付授权、权益和订单状态仍由服务端验证;若后续增加设备证明,需作为单独的客户端/服务端工作流设计,不能声称当前项目已经支持。
### D. 二进制后处理与签名
待源码路径和 SDK 覆盖边界明确后再启动。首期不做全局段平移、Objective-C 元数据清空或自动改写所有系统调用。此类变更须逐项解决重定位、chained fixups、异常展开、指针认证、签名和 dSYM 对应关系。
如确需无源码方案,先限制输入架构、未加密二进制和可验证的加载空间,明确拒绝不支持的输入,产物始终另存。Defender 注入完成只代表库加载成功;原报告调用点是否减少仍需单独验证。
## 6. 分阶段实施与完成条件
| 阶段 | 主要产物 | 完成条件 |
| --- | --- | --- |
| M0 基线闭环 | 原报告记录清单、原 IPA/dSYM/Link Map、目标构建配置及 SDK 清单 | 核对 MD5/UUID;每条报告记录有确定归属或明确“待定位”;确认机构扫描范围、判定规则及完整命中清单 |
| M1 只读审计 | `core/macho` 解析、`cli` audit、JSON/Markdown 差异报告、测试样本 | 正常/损坏/加密/多架构输入均有明确结果;导入符号与调用指令分开统计;可重现原报告的一部分并解释差异 |
| M2 防护修复与接入 | Defender 基础探针、readoor 检测状态与策略、白名单修复、启动去重 | 白名单损坏不再等同安全;重复启动无重复观察者;并发、线程及超时测试通过;正常真机关键流程通过 |
| M3 调用保护与依赖整改 | `STSCommonUtil`/GCDWebServer 试点、第三方版本/重编方案、Release 反汇编证据 | 同引擎验证试点是否减少命中;音频、上传、解压行为无回归;无源码剩余项明确列出,不以主工程修改代替 |
| M4 深入反 Hook 与验收 | GOT/IMP/关键代码检测、受控动态测试记录、最终 IPA 与复测报告 | 已定义的 Hook 场景被检测并按策略处置;正常样本无已知误拦截;报告两项逐条复测闭环;残余项获得明确结论 |
依赖:M0 → M1;M2 可在目标构建确认后与审计开发交错推进;M3 依赖 M1 和机构试点反馈;M4 依赖实际 SDK、机器码与运行时验证结果。首个 PoC 不需要先完成 VMP、资源加密或 Class-Dump 改造。
建议实施时创建以下模块(目前均未实现):`core/macho` 只读解析、`cli` 审计入口、`defender` 探针与结果模型、`tests` 格式及运行时测试、`examples/readoor` 接入说明。readoor 修改遵守其 `AGENTS.md` 和对应开发 Skill;旧架构及第三方源码变更在任务中显式列出。
## 7. 验收矩阵
| 维度 | 必测场景 | 通过标准 |
| --- | --- | --- |
| 报告复测 | 原始与整改 IPA、同引擎/同规则,覆盖主程序和依赖 | 逐条定位与复测;两项按机构标准关闭,或保留正式残余风险;本地审计零命中不替代机构报告 |
| 编译产物 | 实际 Release 优化、LTO 配置及各发布架构 | 预期间接调用保留;新包装层及 Defender 自身亦纳入扫描;无新增不允许的系统调用依赖 |
| 白名单 | 缺失、格式错、摘要错、同名不同路径、Bundle 外镜像、多条环境变量 | 返回明确状态并执行对应策略;可重复回归,不只检查正常样本 |
| Hook | 受控测试中的动态库注入、GOT 重绑定、指定自有函数补丁、关键 IMP 替换 | 各场景独立记录覆盖结果、延迟和策略行为;不以 Frida 端口命中代替所有测试 |
| 正常环境 | 真机冷启/前台、多 Scene、测试设备、允许的 SDK swizzling、无网 | 无已知误退出或误拦截;不破坏合法调试配置 |
| 核心功能 | 登录、购买、支付回调、激活、录音/语音合成、PCM/WAV、文件上传/解压 | 功能正确,失败可恢复,订单状态一致;测试与报告对应的 SDK 路径 |
| 并发与性能 | 重复启动、并发检查、探针超时、后台刷新、生命周期 | 无状态数据竞争和重复 observer;测量首屏/回前台耗时及 p95 后确定预算,不预设未经测量的保证值 |
| 分发 | 最终签名、安装、升级、崩溃符号化 | 实际目标配置真机验证通过;构建和签名成功本身不等于安全检测通过 |
后续 Swift/Objective-C/工程修改按 readoor 规则先执行其规定的 `readoor31` 构建;ECNUP 最终验收仍需使用配置 `306` 对应的实际归档流水线,不能以默认 scheme 的通过代替产品包验证。
## 8. 本轮交付与待补输入
已完成:报告文本提取与去重统计、指定源码调用核查、第三方静态库符号核查、现有防护调用链审查、ARM64 优化实验、实施路线与验收矩阵。只新增本文并更新 iOSGuard README 的实现状态和入口;未修改 readoor,也未运行完整 App 构建或真机安全测试。
进入 M0 时需要补齐:原始被测 IPA;对应 dSYM、Link Map(如当时未保留,须说明不能精确还原);原构建配置与依赖版本;检测机构完整条目和规则口径、是否接受间接调用的试点复测。无源码 SDK 获取受限或检测规则不接受公开 API 路径时,应明确记录阻塞项和替代路线,不能承诺仅注入防护库即可消除全部报告问题。
+90
View File
@@ -0,0 +1,90 @@
# 静态 SDK fopen 重定向 PoC
日期:2026-11-10。用途:验证无 SDK 源码时的调用转发链路;不代表已经具备完整反 Hook 能力或通过报告复测。
后续扩展:核心实现现已移至 `redirect_symbols.py`,支持 JSON 多符号映射,桥接扩展至 7 个固定签名函数。本文记录初始 fopen 验证;原 `redirect_fopen.py` 命令保留兼容,最新用法和范围见 [通用重定向工具](07_GENERIC_STATIC_SDK_REDIRECT.md)。
## 1. 已实现的调用链
```text
SDK 对象的 _fopen 未定义符号
→ 改写为 _IG_fopen(保持符号索引和重定位记录不变)
→ App 链接 IGFileBridge.c
→ IG_fopen 原样传递 path/mode
→ 通过函数指针调用系统 fopen
→ 原样返回 FILE * 或 NULL
```
`defender/call_bridge/IGFileBridge.c` 不记录日志、不扫描环境、不分配额外业务状态、不主动拦截。正常系统调用后的返回路径不调用其他函数,因此不主动改写其 errno。签名和返回的 FILE 指针保持与系统接口一致,可交给系统 `fread/fwrite/fclose`。这只是透明转发实现,不保护系统函数实现或 GOT 不被 Hook。
`optnone/noinline` 用于在当前 Clang 下保留独立入口和间接调用;最终 Release 的优化、LTO、链接行为仍须重新验收。不能承诺符号不可见或任意检测引擎都不命中。
## 2. 工具边界与工作方式
入口:`tools/static_sdk_redirect/redirect_fopen.py`。环境:macOS、Python 3、Xcode 的 `lipo/ranlib`;不依赖本机未安装的 `llvm-objcopy`。
1. 接受 BSD ar 静态归档,或从 fat 文件提取 arm64 静态归档。
2. 检查成员为 little-endian ARM64 `MH_OBJECT`,遍历 `LC_SYMTAB`。
3. 仅将普通外部未定义符号 `_fopen` 的字符串索引改为新增的 `_IG_fopen` 名称。保留其他符号索引、section、机器码和重定位数据;更新字符串表长度。
4. 重新组装归档,用 `ranlib` 重建索引。输出 JSON 记录成员及输入/输出 SHA-256。
5. 写入新文件;拒绝原地覆盖、覆盖已有输出、目标符号冲突或重复处理。任何成员不支持则整个操作失败。
只支持已验证的有限布局:字符串表在对象末尾,允许不超过 7 字节的全零或全换行归档填充。允许 `__LLVM,__bitcode/__cmdline` 中单字节零值的占位标记并原样保留;拒绝实际 LLVM IR/bitcode、未知 LLVM section、arm64e、32 位、动态库、对象签名、GNU 长名称归档及其他未知格式。该工具是小范围 PoC,不是通用 Mach-O 重写器。
输出是 **arm64 真机 `.a`**,不包含原库的 armv7/x86_64,也不构成可直接替换全部目标的完整 Framework/XCFramework。模拟器必须独立处理;不能把真机归档用于 ARM64 模拟器。
## 3. 复现方式
以下命令只写入新建临时目录;保留原讯飞库。命令需整体在同一 shell 中执行,脚本失败即停止。
```sh
set -e
cd /Users/shenlei/Work/ReadBook/iOSGuard
IG_POC_DIR="$(mktemp -d /private/tmp/iosguard-fopen.XXXXXX)"
python3 tools/static_sdk_redirect/redirect_fopen.py \
/Users/shenlei/Work/ReadBook/readoor/readoor/BookShelf/Classes/Factorys/XunFei/iflyMSC.framework/iflyMSC \
"$IG_POC_DIR/iflyMSC.redirected.a" > "$IG_POC_DIR/report.json"
xcrun --sdk iphoneos clang -arch arm64 -miphoneos-version-min=15.0 \
-O2 -Wall -Wextra -Werror -c defender/call_bridge/IGFileBridge.c \
-o "$IG_POC_DIR/IGFileBridge.ios.o"
xcrun ld -r -arch arm64 -platform_version ios 15.0 27.1 \
-all_load "$IG_POC_DIR/iflyMSC.redirected.a" "$IG_POC_DIR/IGFileBridge.ios.o" \
-o "$IG_POC_DIR/iflyMSC.combined.o"
python3 -m unittest discover -s tests -v
```
`ld` 示例的 SDK 版本 `27.1` 是本次实际环境;更换 Xcode 后按实际 SDK 调整。`ld -r` 是可重定位链接检查,保留其他未解析的系统/依赖符号,不等于最终 App 完整链接或运行通过。
## 4. 已完成验证
环境:ARM64 Mac,Xcode 27.1,iPhoneOS SDK 27.1。
| 验证 | 实际结果 | 限制 |
| --- | --- | --- |
| 测试静态归档 + 原始系统调用 | 文件写入、读取、追加、截断、中文路径、ENOENT、4 线程各 20 轮均通过 | Mac 上的自建 SDK 替身,不是讯飞业务 |
| 同一归档重定向 + IGFileBridge | 同样的行为测试通过;原始输入不变;重复处理/覆盖被拒绝 | 未模拟磁盘满、真实设备权限等所有失败条件 |
| 格式和拒绝路径 | 截断、符号冲突、定义符号、动态库、实际 bitcode、异常尾部等测试通过 | 测试集不等于完整解析器安全审计 |
| 讯飞实际 arm64 归档副本 | 检查 380 个对象成员;25 条 `_fopen` 未定义符号引用改为 `_IG_fopen` | 25 是对象符号引用数,不是机器指令调用次数,也不代表最终 App 会链接全部对象 |
| 讯飞符号前后对比 | SDK 副本 `_fopen` 25 → 0,`_IG_fopen` 0 → 25;`_syscall` 13、`_exit` 1 保留 | 最终 App 的桥接实现仍引用系统 `_fopen` |
| 讯飞副本 + iOS bridge 对象 | `ld -r -all_load` 成功 | 未完整链接 readoor、未执行 SDK、未完成真机回归 |
| iOS ARM64 优化汇编 | bridge 保留 `fopen@GOTPAGE` 加载和 `blr` 间接调用 | 存在 GOT 引用,不能声称防止重绑定或 Inline Hook |
| 原始 SDK | SHA-256 前后相同 | 未改 readoor 工程和依赖 |
原始讯飞 SDK SHA-256:`b368fa4866d274da0c6e89607e9d5b95b4a59d49c183eb68c947ac2b50ff3c2c`。归档索引元数据可能受工具影响,重建后不要求整个输出文件哈希跨构建相同;每次记录本次输入和输出即可。
## 5. 后续 readoor 接入方式
本次没有修改 readoor。真正接入需要单独的目标配置或隔离分支,遵守该仓库开发流程:
1. 保留原 iflyMSC 头文件与必要资源,将 arm64 真机配置的链接输入切换为改写归档。
2. 将 `IGFileBridge.c/.h` 加入相同 target;桥接文件不参与符号改写,不定义同名系统 `fopen`。
3. 同一 target 不同时链接原始 iflyMSC 二进制和改写归档;检查 `-framework iflyMSC`、Link Binary With Libraries、其他静态依赖及 `-ObjC/-force_load` 实际设置,避免重复定义或误链接原版本。
4. 检查生成的 Link Map,确认实际选中的归档,以及 `_IG_fopen` 正好由桥接实现提供。仅依赖源码中“已配置”不算接入成功。
5. 构建实际 ECNUP Release,回归讯飞录音、语音合成、文件保存及错误恢复,并比较加固前后性能。
6. 送同引擎复测。若扫描仍识别包装层的系统引用,应记录失败并调整路线,不能把静态库内 `_fopen` 数量变成零当作整个 App 风险已关闭。
首轮只验证 `fopen`。`syscall` 的变参/调用号、`exit` 的不返回语义均需要独立设计,不能套用当前实现。GOT、IMP、Inline Hook 的实际防护也不包含在本 PoC 中。
+80
View File
@@ -0,0 +1,80 @@
# 通用静态 SDK 符号重定向
日期:2026-11-10。当前是有限格式下可复用的构建工具,不是任意 IPA 的通用加固器。
## 实现范围
将此前硬编码 `_fopen → _IG_fopen` 的解析逻辑改为 JSON 映射驱动。对不同 SDK 使用不同映射,同一次处理可重定向多个外部 C 符号。核心 `redirect_symbols.py` 不包含讯飞对象名或业务特例,旧 `redirect_fopen.py` 作为仅处理 fopen 的兼容命令保留。
通用的是**归档与符号处理**;调用转发仍须按真实函数签名实现。不能通过一个 `void *` 或任意变参入口安全地承接所有函数。符号改写工具无法从名字验证参数、返回值、可变参数、错误状态、线程取消或不返回语义。
| 层 | 当前能力 | 扩展方式 |
| --- | --- | --- |
| 重定向引擎 | 映射驱动,精确匹配外部未定义 C 符号;重建归档索引;报告每个符号、每个成员的改写量 | 新 SDK 先检查二进制格式,再选择映射 |
| 映射配置 | 标准 I/O 与 POSIX I/O 两组;支持自定义 JSON | 配置使用实际 Mach-O 名称,含前导下划线 |
| C 桥接 | `fopen/fclose/fread/fwrite/read/write/close` | 新函数需新增准确声明、实现和行为测试 |
| 业务接入 | 独立输出归档,原文件不变 | target 切换链接输入并添加桥接代码;检查 Link Map |
所有桥接均为直接参数转发、局部函数指针、`optnone/noinline`。不加日志、自动重试、短读短写补齐、策略拦截。`syscall`、`open` 变参、`exit`、ObjC 方法、C++ 符号不在自带桥接覆盖范围内;自定义映射不能代替桥接实现和 ABI 审查。
## 配置与命令
`tools/static_sdk_redirect/mappings/stdio.json`:
```json
{
"_fopen": "_IG_fopen",
"_fclose": "_IG_fclose",
"_fread": "_IG_fread",
"_fwrite": "_IG_fwrite"
}
```
`mappings/posix_io.json` 提供 `_read/_write/_close`。若需同时处理两组,将各键合并到一个 JSON,**一次处理原始库**,不要把已改写库当作重复处理输入。
下面使用新建临时目录处理当前讯飞静态 SDK 副本:
```sh
set -e
cd /Users/shenlei/Work/ReadBook/iOSGuard
IG_GENERIC_DIR="$(mktemp -d /private/tmp/iosguard-generic.XXXXXX)"
python3 tools/static_sdk_redirect/redirect_symbols.py \
/Users/shenlei/Work/ReadBook/readoor/readoor/BookShelf/Classes/Factorys/XunFei/iflyMSC.framework/iflyMSC \
"$IG_GENERIC_DIR/iflyMSC.stdio.a" \
--mapping tools/static_sdk_redirect/mappings/stdio.json \
--require-all > "$IG_GENERIC_DIR/report.json"
```
默认允许某些配置项在该 SDK 中不存在,但 JSON 报告明确列入 `unmatched_symbols`;所有项均未命中时失败。`--require-all` 要求每项至少命中一次,否则不生成输出,适合已知版本 SDK 的 CI 检查。
遇到空配置、非法 C 符号名、重复 JSON 键、自映射、链式映射、循环映射、多个源共用一个目标、归档已含目标符号、源符号有定义、格式不支持或已有输出文件均失败。报告的 `symbol_counts` 统计对象符号表条目,不是指令调用次数。
工具只输出改写后的静态库,不自动链接或嵌入桥接。target 必须链接 `defender/call_bridge/IGFileBridge.c`,或提供自定义映射对应的兼容实现。桥接代码不能参与重定向,否则可能造成自调用递归。同一 target 不要同时链接 SDK 原二进制与其改写副本。
## 已验证与未覆盖
15 项自动化测试通过:
- 原 fopen 行为与旧 CLI 保持可用。
- 同一对象中 7 个符号同时重定向,链接运行正确,逐符号计数符合预期。
- 同一行为测试分别链接原始库与改写库;二进制文件读写、追加、截断、中文路径、4 线程各 20 轮通过。
- POSIX 管道短读、零字节读写、EOF、无效描述符 EBADF、非阻塞管道满时 EAGAIN/EWOULDBLOCK 保持行为。
- 配置错误、重复键、冲突、严格模式缺项、全部未命中、已有输出、重复处理及格式拒绝路径得到验证。
当前真实讯飞 SDK 检查 380 个对象成员,标准 I/O 四符号配置共改写 95 条符号引用:`_fopen` 25、`_fclose` 30、`_fread` 17、`_fwrite` 23;`nm` 对照及 iOS ARM64 `ld -r -all_load` 可重定位链接验证通过。该检查不等于 readoor 完整链接、SDK 真机运行或报告复测。
不支持动态 Framework、IPA 中最终可执行文件、arm64e、32 位、GNU 长名称归档和实际 bitcode;fat 静态库只提取 arm64,输出不包含其他架构。保留初始 PoC 对 Mach-O 布局的限制,详见 [初始实现](06_STATIC_SDK_FOPEN_POC.md)。当前 SDK 验证是 iPhoneOS 真机切片;ARM64 Mac 测试不等于 iOS 模拟器支持声明。
基础行为测试未覆盖全部函数语义,例如磁盘满、EINTR、线程取消、全部短写模式、目标 App 优化/LTO 组合及 SDK 自校验。正式接入仍需各 SDK 的业务回归。
桥接的间接调用仍可保留 GOT 引用。多符号改写仅扩大调用转发覆盖面,不自动提供 GOT/Inline Hook 防护,也不保证原检测报告清零。新增映射应按“实现桥接 → 行为测试 → SDK 副本改写 → 真机业务回归 → 同引擎复测”逐步验收。
## 本地验证命令
```sh
cd /Users/shenlei/Work/ReadBook/iOSGuard
python3 -m unittest discover -s tests -v
```
本机 ARM64 Mac 原生编译和运行测试需要 Xcode;其他平台会跳过原生测试,不能把跳过结果当作链接或运行通过。此次未修改 readoor、替换其 SDK 或改变签名产物。
@@ -0,0 +1,84 @@
# 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`(sha256 `5caa6101…`,与 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. 边界与风险
1. `_write`/`_close` 仍为导入符号:桥接 GOT 引用 + App 其他代码使用;跟踪间接调用的检测器可还原调用链。
2. armv7 切片原样保留,仍引用原系统符号,不享有本次重定向效果;当前构建只验证 arm64,未验证 armv7 构建。
3. 模拟器切片未覆盖(原库本就无 simulator 架构,行为不变)。
4. 未做真机功能回归(书籍解压/下载流程依赖 ZipZap 写文件);未提交检测引擎复测。
5. 本试点只覆盖 `_write`/`_close` 两个符号;fopen 系列在 readoor31 链接路径上的候选库(如 StsPDF 系列内核库,基线中有 401 个符号入库)尚未处理。
## 6. 复现命令
```bash
# 从未改写的备份抽取 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. 下一步
1. 真机安装加固版 readoor31.app,回归书籍下载/解压/阅读流程。
2. 用原检测引擎复测,确认 ZipZap 对应命中变化。
3. 视结果扩大映射(StsPDF 内核库的 fopen 系列是下一个候选)。
+95
View File
@@ -0,0 +1,95 @@
# 09 · ECNUP 报告整改方向结论
日期:2026-11-10。状态:方向判断与架构设计。**尚未向 V4.6.6 提交任何加固包复测**,下文"能过检"均为待验证假设,不是已验证结果。
> 进展:本文 §5 收敛的改写引擎已建成,并在真实目标上**自测第 1 层清零(336 → 0)**、结构合法可签——见 [10](10_MACHO_GUARD_SELFTEST.md)。送检 V4.6.6 仍未做。
关联:报告分析见 [05](05_READOOR_SECURITY_REMEDIATION_PLAN.md),重定向工具见 [07](07_GENERIC_STATIC_SDK_REDIRECT.md),试点验证见 [08](08_ZIPZAP_PILOT_BUILD_VERIFICATION.md)。
## 1. 从报告修复示例推导的检测假设
报告(ECNUP外语 2.197.2,引擎 V4.6.6)两个高危项——"外部函数显式调用风险"(`_fopen/_dlopen/_dlsym`)与"系统调用暴露风险"(`_write/_read/_open/_close/_exit/_fork/_syscall/_unlink/_getpid`)——**其官方修复示例是函数指针方式**:
```c
typedef char* (*GET_ENV_TYPE)(const char *);
static inline int __attribute__((optnone)) IJMCheckInsertLib() {
GET_ENV_TYPE get_env = getenv; // ← 仍然引用 getenv 符号
char *env = get_env("DYLD_INSERT_LIBRARIES");
}
```
**关键推论**:该示例修复后,`getenv` 仍是导入符号(导入表里还在),消失的只是"直接调用关系"(调用点不再是 `bl stub(getenv)`,而是取函数指针后 `blr`)。
据此提出假设:**V4.6.6 可能关注调用点的直接分支关系**,因此优先验证消除第 1 层(见 §3)的方案。报告示例不足以证明引擎的完整规则,也不能排除其跟踪桥接、间接调用或导入表的能力。
> 证据强度:这是从报告自带示例 + `optnone` 提示反推的结论,与 docs/08 试点一致(桥接后调用点变 `bl _IG_write`,而 `_write` 仍在导入表且导入表 diff 为空,构建通过)。最终仍以 V4.6.6 复测为准。
## 2. 方向结论:链接后 Mach-O 调用点改写器
报告展示 100 条记录(50 外部函数 + 50 系统调用),涉及讯飞、GCDWebServer、glog、Sts PDF 内核、ZipZap 及匿名地址。源码可用性需逐库确认,例如工程中有 GCDWebServer 源码,不能一概认定第三方库均无法重编译。
由此排除与选定:
| 方向 | 能否覆盖报告 | 结论 |
| --- | --- | --- |
| 源码改函数指针(报告示例) | 部分 | 适用于可以修改并重编译的源码;各库情况需单独确认 |
| 链接前静态库重定向(07/08) | 部分 | 仅限能拿到 `.a` 且格式受支持的库;动态 framework、已编入 Pods 的二进制覆盖不到 |
| **链接后 Mach-O 调用点改写(自研核心)** | **待复测** | 可统一处理受支持 arm64 格式中的目标直接分支;不覆盖全部架构和调用形态 |
**选定链接后改写器**(规划 `tools/macho_guard`),形态即"类易盾":输入 `.app`/IPA → 遍历每个 Mach-O 的 arm64 切片 → 定位命中符号的 `bl → __stubs` 调用点 → 改写为 `bl IG_*`(桥接蹦床注入新段)→ 逐级重签名。桥接仍按真实签名实现(07 已覆盖 7 个,需补 `open`变参/`unlink/exit/getpid/fork` 与 `syscall` 专用蹦床)。
## 2.5 实测:appstore.ipa 改写面(2026-11-10)
项目根目录 `appstore.ipa`(readoor31OtherPay **v2.199.0**,`com.ecnup.aSCLdl2`,arm64 单切片)经解包核查:
- **`cryptid 0`**:导出的 archive 包,`__TEXT` 明文未加密——链接后改写器可直接操作(App Store 下载包才会被 Apple 加 FairPlay,那种需先脱壳)。这是整个方向可行的硬前提,已在真实包上确认。
- 自研扫描脚本按上述假设运行直接分支规则:扫 `__text` 全部 `bl/b → __stubs` 分支,主二进制命中报告涉及的 12 个符号共 **336 处直接调用点**:
| 符号 | 数 | 符号 | 数 | 符号 | 数 |
| --- | --- | --- | --- | --- | --- |
| `_exit` | 96 | `_open` | 21 | `_unlink` | 8 |
| `_fopen` | 86 | `_dlsym` | 18 | `_read` | 7 |
| `_close` | 67 | `_write` | 16 | `_dlopen`/`_syscall` | 2/2 |
| | | `_getpid` | 12 | `_fork` | 1 |
报告每类展示 50 条,是否截断及完整记录数尚未确认。当前 IPA 的版本及 Bundle ID 与报告不同;336 是当前样本的本地统计,不能据此证明复现了 V4.6.6 的规则。
- 逐点清单(site 地址 / 符号 / 分支类型):`test-results/appstore-callsites.csv`(336 行)。注意该 release 包已 strip(仅 594 函数符号),无法从符号表还原 ObjC 方法名;报告的方法名来自解析 ObjC 元数据,改写任务不需要名字,用 site 地址即可。
## 3. 检测面分层与升级阶梯
| 层 | 检测方式 | 本次是否需要处理 |
| --- | --- | --- |
| 1. 调用点直接分支 `bl stub` | 调用点模式匹配 | **优先验证**——是否足以解决报告仍待 V4.6.6 复测 |
| 2. 导入表/GOT 条目 | `nm -u`、imports 扫描 | 否(报告示例自身不消除此层) |
| 3. 符号名字符串 | strings 扫描 | 否 |
| 4. 间接调用可追踪性 | 交叉引用、轻量模拟 | 否 |
对应升级阶梯(仅当复测仍命中才向下走,不预先加码):
```
桥接改写(消除第1层)──送检 V4.6.6──┬─ 过 → 收工,成本最低【当前判断落点】
└─ 仍命中 → A: dlsym表+名字加密(消第2、3层)
└─ 仍命中 → B: raw svc 内联(消第4层进 libSystem)
└─ 仍命中 → C: 桥接 VMP/控制流平坦化
```
A/B/C 的代价与边界(变参、errno 手工处理、arm64 调用号锁定、`svc` 字节本身不可消除等)见本轮讨论,**在验证桥接即过之前不实现**。
## 4. 必须如实说明
1. **未复测**:readoor ZipZap 试点(08)与任何 ECNUP 加固包都未提交 V4.6.6。"桥接即过"是假设。
2. **过检 ≠ 安全**:消除静态调用关系不防 Frida 等运行时 Hook;GOT 完整性校验、反调试等运行时防护(05 计划)与此正交,两层都要。
3. **自研规模**:验收标准是本报告 V4.6.6 清零 + 业务回归,不是对齐易盾全家桶(字符串加密/VMP/反调试套件属季度级,暂不做)。
4. **发行验证**:结构解析和 ad-hoc 签名检查不足以证明可安装、运行或满足发行要求;当前只完成本地静态验证,后续需正式配置签名和真机回归。
## 5. 下一步
现有真实目标 `appstore.ipa`(未加密、336 个调用点已定位),实验路径收敛为:
1. 建 `tools/macho_guard` 改写引擎:桥接段注入(arm64 位置无关蹦床,补齐 `open`变参/`exit/getpid/fork/unlink/syscall`)+ 336 个 `bl` 改写为 `bl IG_*` + 重建代码签名段。
2. 对 patch 后的 `appstore.ipa` **重跑本目录扫描脚本**,期望 336 → 0(客观、无需送检即可自测第 1 层是否消除)。
3. **ad-hoc 重签**(`codesign -f -s -`)即可满足 V4.6.6 静态复测——静态扫描器一般不校验签名有效性,故不需要正式证书;仅真机安装/提审才需开发者身份与 entitlements。
4. 送检 V4.6.6 验证第 1 节核心假设:过 → 收工;仍命中 → §3 阶梯 A。
> 风险:段注入涉及 LC_SEGMENT_64 插入与 LC_CODE_SIGNATURE/__LINKEDIT 偏移修正,是本引擎最易出错处,需逐步验证(先注入可用桥接段并能正常加载,再做批量改写)。
+104
View File
@@ -0,0 +1,104 @@
# 10 · macho_guard 链接后改写器:自测通过
日期:2026-11-10。状态:**第 1 层检测自测清零**——单二进制 336 → 0(§1-6),整包 31 个 Mach-O 共 878 → 0(§7),结构合法可签。**仍未向 V4.6.6 送检**——"桥接即过"依旧是待验证假设(见 [09](09_ECNUP_REMEDIATION_DIRECTION.md) §4)。
关联:方向与改写面实测见 [09](09_ECNUP_REMEDIATION_DIRECTION.md),检测器判定标准推断见 09 §1。
> 后续已从根目录 IPA 重新运行整包验证并保存在 `test-results/verification/20261110-step1-final/`,含源码快照、前后包、逐二进制 UUID/哈希、逐调用点 CSV、逐指令校验和签名日志;复现入口见 [13](13_REPRODUCIBLE_BASELINE.md)。下文 scratchpad 为早期记录,不再是唯一证据来源。
## 1. 结论
按 09 §5 收敛的路径,`tools/macho_guard` 链接后改写引擎已建成并在真实目标 `appstore.ipa`(readoor31OtherPay v2.199.0,`com.ecnup.aSCLdl2`,arm64 单切片,`cryptid 0`)上跑通:
- **注入** `__IGUARD` 段(RX,一页 0x4000),内含 12 个与系统 stub 字节同构的桥接蹦床;
- **改写** `__text` 内全部 336 个命中调用点 `bl/b → __stubs` 为 `bl/b → IG_*`;
- **ad-hoc 重签**(`codesign -f -s -`)通过,`codesign -v` exit 0。
对 patch 后二进制重跑本目录扫描脚本:**命中 12 个符号的直接调用点 336 → 0**。重新打包成 IPA 后再解包复扫,同样为 0——独立复现,非内存产物假象。
## 2. 改写面与结果(逐符号)
| 符号 | 改写数 | 符号 | 改写数 | 符号 | 改写数 |
| --- | --- | --- | --- | --- | --- |
| `_exit` | 96 | `_open` | 21 | `_unlink` | 8 |
| `_fopen` | 86 | `_dlsym` | 18 | `_read` | 7 |
| `_close` | 67 | `_write` | 16 | `_dlopen` | 2 |
| `_getpid` | 12 | `_fork` | 1 | `_syscall` | 2 |
合计 336,与注入前实测(09 §2.5)逐符号完全吻合。
## 3. 桥接蹦床原理
每个桥接函数 3 指令 12 字节,与系统 `__stubs` 条目**字节同构**,从同一 GOT 槽取址尾调用:
```
adrp x16, GOT@page ; 与系统 stub 相同的页基址
ldr x16, [x16, #off] ; 取同一 GOT 槽(dyld 已填真实函数地址)
br x16 ; 尾调用,ABI 透明,变参/errno 原样透传
```
关键差异:桥接函数**不登记进间接符号表**。因此静态扫描器遍历 `__stubs`→间接符号表还原"这个分支目标对应哪个导入符号"时,`IG_*` 无法被归为 `_write/_fopen/...`,调用点不再被判为对应系统符号。`_write` 等仍是导入符号(GOT 槽、桥接自身引用),第 2/3 层未动——与 09 §1 推断的 V4.6.6 判定口径(调用点直接分支关系,非符号存在性)一致。
尾调用正确性:`b IG_sym`(tail call)改写后,`IG_sym` 末尾 `br x16` 跳真实实现,返回地址仍是原调用者,ABI 透明;`bl IG_sym` 同理,桥接返回后回到调用点。变参 `open`/`syscall` 因纯尾调用、参数寄存器/栈原样透传,字节同构蹦床即足够(不需签名精确的 C 桥接)。
## 4. 段注入与偏移修正(最易错处)
在 `__DATA` 与 `__LINKEDIT` 之间插入 `__IGUARD`:
1. 文件在 `__LINKEDIT` fileoff(0x3458000)处插入一页段数据;
2. header 区(0..16384,含 load commands)在 `__LINKEDIT` 命令前插入 72 字节 `LC_SEGMENT_64`,header 区总长保持 16384(原 load commands 结束于 15088,余量充足);
3. `ncmds += 1`,`sizeofcmds += 72`;
4. `__LINKEDIT` 段命令 vmaddr/fileoff `+= PAGE`;
5. **所有指向 __LINKEDIT 的偏移 `+= PAGE`**:chained_fixups、exports_trie、symtab(symoff/stroff)、dysymtab(indirectsym)、function_starts、data_in_code、code_signature——漏一个即加载失败或签名区错位。命令本身也因插入右移 72 字节。
验证:`otool -l` exit 0 解析干净;段序 `__PAGEZERO,__TEXT,__DATA,__IGUARD,__LINKEDIT` 正确;`codesign -v` PASSED。
## 5. 工具与产物
- `tools/macho_guard/machox.py`:Mach-O 解析(`Macho` 类、`linkedit_pointers()`)。
- `tools/macho_guard/macho_guard.py`:注入+改写+重签。CLI:`inject`(仅注入校验)、`harden`(注入→改写→重签一条龙)。因读取未信任二进制,须 `python3 -I` 运行。
- 自测扫描脚本复现 V4.6.6 判定(扫 `__text` 全部 `bl/b → __stubs`,经间接符号表映射到 12 个命中符号)。
- 加固后 IPA、逐点 CSV 等产物当前在会话 scratchpad,未入库(113M 二进制不宜提交);需长期留存可按需拷入 `test-results/`。
## 6. 复现命令
```bash
cd tools/macho_guard
python3 -I macho_guard.py harden <原始二进制> <输出二进制>
# [1/3] 注入 __IGUARD;[2/3] 改写 336 处;[3/3] ad-hoc 重签 exit=0
# 复扫期望 336 → 0
```
## 7. 多 Mach-O 整包批处理(2026-11-10 自测通过)
单二进制验证后,把改写器推广到**整个 `.app` 包**。工程化要点:
- **base 泛化**:主程序 `__TEXT` vmaddr=0x1_0000_0000(`__PAGEZERO` 在前),framework/dylib vmaddr=0(无 `__PAGEZERO`)。原 `inject`/`find_stub_got_slots` 硬编码的 `BASE=0x100000000` 与 header 区 `16384` 均改为按 `__TEXT` 段实测值与首节文件偏移动态计算(`_text_mapping` / `_first_section_fileoff`)。扫描逻辑本就纯在 vmaddr 空间匹配,天然 base 无关。
- **fat 容器**:`AliyunPlayer`/`alivcffmpeg`/`AliyunMediaDownloader` 为 `cafebabe` fat 壳包单 arm64 切片。用 `lipo -thin arm64` 抽出 → 加固 thin → `lipo -replace arm64` 回填,保持 fat 结构与原签名壳。
- **逐级签名**:改写后自底向上 `codesign -f -s -` 各 `.framework`,再签主 `.app` bundle。
- **注入前体检**:`batch.py` 先扫全包,报告每个 Mach-O 的命中数、注入余量(首节偏移−load command 末尾)、`cryptid`。本包 30 个 framework + 主二进制共命中,余量全部 >8KB(所需 72B),`cryptid` 全 0——无一受阻。
真实目标 `appstore.ipa` 整包结果(43 个 Mach-O/切片):
| 范围 | 命中 | 结果 |
| --- | --- | --- |
| 主二进制 readoor31OtherPay | 336 | → 0 |
| 30 个 framework(含 3 个 fat) | 542 | → 0 |
| **全包合计** | **878** | **→ 0** |
命中最多:AliyunPlayer 103、TTNetworkManager 56、ATAuthSDK_D 39、WCDBSwift 27。全包 `_dlsym` 312 居首(媒体/网络 SDK 动态加载)。改写后:整包复扫 0 命中;fat 容器仍 `cafebabe`+arm64;主二进制与各 framework `codesign -v` 全 PASSED;`otool -l` 干净;重打包成 IPA 再解包复扫仍 0——独立复现。
命令:
```bash
cd tools/macho_guard
python3 -I batch.py <App.app> # 全包命中/余量体检
python3 -I macho_guard.py harden-bundle <App.app> # 整包加固 + 逐级重签
```
## 8. 下一步(未完成项,如实列出)
1. **送检 V4.6.6**:验证 09 §1 核心假设。过 → 收工;仍命中 → 09 §3 阶梯 A(dlsym 表 + 名字加密)。这是唯一能证实"桥接即过"的步骤,尚未做。
2. **真机功能回归**:讯飞语音、书籍下载/解压(ZipZap/ZIPFoundation/SSZipArchive)、AliyunPlayer 播放、GCDWebServer——878 处改写后未验证运行时行为。改写只动调用目标(桥接 ABI 透明尾调用),风险低但需实测确认。
3. **正式签名**:ad-hoc 仅够静态扫描;真机安装/提审需开发者身份 + entitlements + Provisioning 保留(整包重签需 `--entitlements` 逐包传递)。
4. **arm64e / __auth_stubs**:本包全为 arm64(常规 `__stubs`+`__got`)。若后续样本含 arm64e 切片,需处理认证指针桩(`__auth_stubs`/`__auth_got`)——当前未覆盖。
5. **运行时防护正交项**(05 计划):GOT 完整性校验、反调试——静态改写不覆盖,Frida 等运行时 Hook 仍需单独处理。
+90
View File
@@ -0,0 +1,90 @@
# 11 · 运行时防 HOOK Defender C 模块
日期:2026-11-10。状态:**模块实现 + iphoneos 交叉编译 + 宿主正向自测通过**。按 docs/05 §5.C 设计原则落地;真机接入与业务回归未做。
关联:报告威胁与运行时防护设计见 [05](05_READOOR_SECURITY_REMEDIATION_PLAN.md) §4/§5.C;与静态改写器([10](10_MACHO_GUARD_SELFTEST.md))正交——改写器改变自研规则下的直接分支形态,本模块防运行时 HOOK 导致的信息泄露,两层都要。
> 后续已将宿主测试固化为 `tests/test_defender_host.py` 和 `tests/fixtures/defender_host.c`,覆盖正常环境、符号不可用、提供方异常、环境变量、镜像特征及真实 GOT 槽重绑定,并交叉编译三个模块。本轮 7 项通过,日志随 [13](13_REPRODUCIBLE_BASELINE.md) 归档。inline Hook 真机正向测试仍未完成。
## 1. 定位
报告描述的"HOOK 关键系统函数 → 信息泄露"是**运行时威胁**,静态改写(`macho_guard`,桥接仍走同一 GOT 槽、ABI 透明)**防不住**。本模块是独立的运行时完整性探针,纯 C、无 Swift/OC 依赖,可直接编入任意 iOS target。
遵循 docs/05 §5.C 原则:**探针与处置分离**——只采集证据经回调上报,返回 `clear/detected/unavailable`(unavailable 不等于安全),**绝不自行 `exit`**,是否限制功能由上层策略决定(观察模式优先)。
## 2. 覆盖的 HOOK 形态
| 探针 | reason | 检测手段 | 对应攻击 |
| --- | --- | --- | --- |
| 符号提供方 | 100 `SYMBOL_PROVENANCE` | `dlsym`→`dladdr`,宿主镜像须系统路径 | dyld interpose / 注入 dylib 抢占符号定义 |
| inline hook | 101 `INLINE_HOOK` | 关键函数序言首指令为无条件 B,或 LDR-literal+BR x16/x17 蹦床 | Frida Interceptor / Dobby inline patch |
| **GOT 重绑定** | 102 `GOT_REBIND` | 运行时遍历自有镜像非惰性 `__got` 槽(fishhook 同款 loader 走法,用于**校验**),当前值去 PAC 后≠trusted 且提供方非系统 | fishhook 类 GOT/符号指针改写 |
| 注入镜像 | 200 `INJECTED_IMAGE` | 已加载镜像名匹配 frida/substrate/cycript/dobby… 特征 | 越狱注入框架加载 |
| Bundle 外镜像 | 201 `FOREIGN_IMAGE` | 非系统且不在 `.app` 内的镜像(弱信号) | 未知 dylib 载入 |
| DYLD 插入 | 202 `DYLD_INSERT` | `DYLD_INSERT_LIBRARIES` **逐条**解析(非整串前缀,对应 05 §4 P1),条目在 Bundle 外即报 | `DYLD_INSERT_LIBRARIES` 注入 |
| Frida 线程 | 203 `FRIDA_THREAD` | `task_threads`+`THREAD_EXTENDED_INFO` 线程名匹配 gum-js-loop/gmain/pool-frida… | Frida 运行时驻留 |
| Frida 端口 | 204 `FRIDA_PORT` | 非阻塞 connect 127.0.0.1:27042(默认关,弱信号) | Frida 默认监听 |
全部基于公开 API:`<dlfcn.h>`、`<mach-o/dyld.h>`、`<mach-o/loader.h>`/`<nlist.h>`、`task_threads`/`thread_info`、BSD socket。
## 3. 文件与接口
```
defender/
include/IGDefender.h 结果模型(IGStatus/IGReason/IGFinding/IGFindingSink)+ ig_defender_scan
anti_hook/IGAntiHook.{h,c} ig_anti_hook_check(names,count,sink,ctx) / _default
anti_frida/IGAntiInject.{h,c} ig_anti_inject_check(bundle,sink,ctx) / ig_anti_frida_check(port,sink,ctx)
IGDefender.c ig_defender_scan 聚合
```
结果模型(`IGFinding`):`status` + `reason` + `subject`(符号/镜像/线程名)+ `evidence`(地址/提供方/端口人读文本)。探针对每条 DETECTED/UNAVAILABLE 调 `sink` 一次,CLEAR 不上报。
接入(观察模式,启动/回前台/关键操作前):
```c
static int sink(const IGFinding *f, void *ctx) {
// 上报打点;按 f->reason 组合决定策略,勿在此直接 exit
return 0;
}
int hits = ig_defender_scan(bundle_path, /*probe_port=*/0, sink, ctx);
```
## 4. 验证证据
**iphoneos arm64 交叉编译**(可编入 App 的证明):三个 `.c` 以 `-arch arm64 -miphoneos-version-min=15.0 -O2 -Wall -Wextra` 全部 OK,`ar` 打包 `libIGDefender.a`(arm64),导出 `_ig_anti_hook_check / _ig_anti_hook_check_default / _ig_anti_inject_check / _ig_anti_frida_check / _ig_defender_scan`。
**宿主 arm64 行为自测**:
| 场景 | 期望 | 实测 |
| --- | --- | --- |
| 干净环境 anti_hook(12 符号 provenance+inline+GOT) | 0 命中 | 0(无误报) |
| 干净环境注入扫描 | 0 | 0 |
| 正向:`DYLD_INSERT_LIBRARIES=/tmp/evil:/var/x/hook` | 逐条报 DYLD_INSERT | 2 条 DYLD_INSERT(+1 FOREIGN,均正确) |
| 正向:`dlopen` 名含 frida 的 dylib | INJECTED_IMAGE | 命中,证据含匹配特征 |
| 正向:fishhook 式篡改 `getpid` 的 `__got` 槽指向本程序函数 | GOT_REBIND | DETECTED reason=102,证据含槽址/当前值/非系统提供方/期望值 |
| Frida 线程扫描(无 frida) | 0 | 0 |
GOT 重绑定——即用户点名的"GOT 完整性校验"——以真实篡改正向验证抓得到,且篡改前零误报。
## 5. 边界(如实声明)
1. **架构**:仅 arm64/x86_64(LP64)。**arm64e `__auth_got`** 槽为认证指针,比较前 `ptrauth_strip`;若工具链无 ptrauth 则对认证槽判 unavailable,不强行比较。本包 appstore.ipa 全 arm64,无此问题。
2. **惰性槽**:只对非惰性 `__got`(`S_NON_LAZY_SYMBOL_POINTERS`)判 rebind;`__la_symbol_ptr` 首次调用前可能仍指 helper,不误判,由 provenance/inline 层兜底。
3. **inline hook 正向未测**:序言检测仅验证了 12 个真实系统函数的零误报路径;正向 patch 需改写共享缓存代码页(真机受保护),宿主不可行,留真机验证。检测逻辑本身保守(仅 B / LDR+BR 蹦床),低误报。
4. **特征可规避**:镜像名/线程名/端口均为可改写特征,命中是强/弱证据,未命中不等于干净——故 05 §5.C 要求组合判定,本模块只给证据不下结论。
5. **只检测不处置**:绝不 exit;策略层须区分构建缺陷/误报/真实攻击,支付/权益仍由服务端校验。
6. **真机接入与回归未做**:启动链接入、冷启/回前台/多 Scene、正常 SDK 合法 swizzling 的误报面均未在真机验证。
## 6. 复现
```bash
# 在 iOSGuard 根目录运行,隔离编译宿主测试并执行正反例,另做 iphoneos/arm64 交叉编译。
python3 -m unittest discover -s tests -p 'test_defender_host.py' -v
```
## 7. 下一步
1. **真机接入**:编入 readoor31(遵守其 AGENTS.md / Skill),启动链调用 `ig_defender_scan`,观察模式跑正常业务,量化误报面(合法 swizzling、调试配置)。
2. **inline-hook 正向测**:真机用 Frida/Dobby 实挂关键函数,确认 reason=101 命中。
3. **策略层**:把 reason 组合映射到受限操作(而非 exit),与 05 §4 指出的 `RDSecurityGuard` 立即 exit 缺陷一并整改。
4. **arm64e 支持**:若后续样本含 arm64e 切片,补 `__auth_got` 认证槽校验。
5. 与静态层串联:`macho_guard`(静态改写,厂商复测待完成)+ 本模块(防 HOOK)+ 可选 Plan A(dlsym+名字加密,消静态调用关系)。
@@ -0,0 +1,83 @@
# 12 · 内联原语 + 混淆直发系统调用 + 带校验的符号解析
日期:2026-11-10。状态:**优先级 1、2 实现 + iphoneos 交叉编译 + 宿主正向/反向自测通过**。优先级 3(LLVM/OLLVM/Hikari 混淆、控制流平坦化、字符串/段加密)**不在本轮**。
关联:威胁与运行时防护原则见 [05](05_READOOR_SECURITY_REMEDIATION_PLAN.md) §5.C;运行时探针(provenance/inline/GOT/注入)见 [11](11_RUNTIME_ANTIHOOK_MODULE.md)——本轮复用其 `ig_verify_function` 做「调用前校验」。静态过检见 [10](10_MACHO_GUARD_SELFTEST.md)。本模块与前两者正交:改写器过扫描、探针抓 HOOK、本模块让**核心逻辑自身**不给攻击者可挂的符号点。
## 1. 定位
用户落地方案四维度中的前两级:
- **优先级 1 — 核心逻辑自包含**:关键校验/鉴权/取数据不调用被监控的 libc/系统函数,改用强制内联原语 + 直发 `svc #0x80`,使 `__got`/`__la_symbol_ptr` 里**根本没有**这些符号条目可供 Fishhook 重绑、也没有 libSystem 函数入口可供 inline hook。
- **优先级 2 — 隐藏意图 + 结果验真**:确需 `dlopen/dlsym` 时,库名/符号名编译期 XOR 编码、栈上解密即用即清;解析结果**放行前**过 provenance + 序言校验,把被挟持的实现挡在调用前。
方案 §4「导入表/指针完整性自检」已由 [11](11_RUNTIME_ANTIHOOK_MODULE.md) 的 GOT/provenance 探针覆盖,本轮不重复。
## 2. 交付物
```
defender/
primitives/IGInline.h 纯头,IG_AINLINE 原语:ig_strlen/memcmp/memcpy/memset/strcmp/strncmp/strstr
syscall/IGSyscall.{h,c} 混淆直发 svc:ig_syscall6 + getpid/write/read/open/close/exit/is_debugged
resolve/IGResolve.{h,c} 加密名 dlopen/dlsym + 放行前校验 + ig_getenv(_NSGetEnviron)
anti_hook/IGAntiHook.{h,c} 新增公开 ig_verify_function(addr,name,sink,ctx)(复用 provenance+序言逻辑)
```
### 2.1 内联原语(IGInline.h)
`IG_AINLINE = static inline __attribute__((always_inline))`。使用处直接展开为离散指令,不生成 `bl`、不产生导入表项,从导入表抹除 strcmp/memcmp/memcpy/strstr/strlen 等特征。**定位是「隐藏特征」非「更安全实现」**——不做常量时间比较,防时序侧信道需另行处理。
### 2.2 混淆直发系统调用(IGSyscall)
- **ABI(本会话真机/宿主实测)**:调用号入 `x16`,arm64 BSD 调用**不加** `0x2000000`(那是 x86_64 的 class 位);参数 `x0..x5`;`svc #0x80`;返回 `x0`,出错时 carry 置位、`x0=errno`。封装对出错统一返回 `-errno`。
- **号混淆**:调用号不以 `movz x16,#n` 立即数出现。调用方传 `IG_SC(n)=n^0x5a`,运行期与 `volatile long ig_sc_key` 异或还原后入 `x16`。反汇编 `ig_sys_getpid` 实证:`eor x16, <mem>, #0x4e`(`0x4e=20^0x5a`),真实号 20 不出现;`ig_syscall6` 连立即数都没有(`eor x16, x9(mem), x0`)。还原真实号需运行期取 `ig_sc_key`。
- **调试器检测** `ig_sys_is_debugged()`:直发 `sysctl({CTL_KERN,KERN_PROC,KERN_PROC_PID,pid})` 读 `kinfo_proc` 内 `extern_proc.p_flag & P_TRACED(0x800)`。偏移 `0x20` 由本机 `offsetof(struct kinfo_proc,kp_proc)==0` + `offsetof(struct extern_proc,p_flag)==32` 实测确定(非猜测,见 scratchpad/off.c)。不经 libc sysctl,规避对其 hook。**按 05 决定不含非公开 ptrace(PT_DENY_ATTACH)**,仅做公开 API 检测,处置交策略层。
### 2.3 加密名 + 带校验解析(IGResolve)
- 库名/符号名编译期 XOR(`IG_ENC_KEY=0x3C`),运行期 `ig_decrypt` 栈上解密、`ig_wipe`(volatile 防 DCE)即用即清,明文不驻留 `__cstring`。
- `ig_dlsym_verified`:解析后调 `ig_verify_function`,provenance(提供方须系统路径)+ 序言(非 inline-hook 蹦床)双过才返回地址,否则返回 NULL(视作被挟持拒用)。
- `ig_getenv`:经 `_NSGetEnviron()` 手工遍历,规避 getenv 符号/hook。
## 3. 验证证据
全部 arm64。iphoneos:五个 `.c` 以 `-O2 -Wall -Wextra` 编译 OK,`ar` 成 `libIGDefender.a`,导出 `ig_syscall6 / ig_sys_{getpid,write,read,open,close,exit,is_debugged} / ig_decrypt / ig_wipe / ig_dlsym_verified / ig_dlopen_hidden / ig_getenv / ig_verify_function` 及 [11] 原有符号。
宿主 arm64 行为自测:
| 场景 | 期望 | 实测 |
| --- | --- | --- |
| `ig_sys_getpid` vs libc getpid | 相等 | 相等 |
| `ig_sys_write(1,…)` 直发 | 写出、返回字节数 | OK(27/27) |
| `ig_sys_open`/`read`/`close` 正常文件 | 成功 | fd=3、读 8B、close=0 |
| `ig_sys_open` 不存在路径 | 返回 `-errno` | -2(-ENOENT) |
| `ig_sys_is_debugged` 普通运行 | 0 | 0 |
| `ig_sys_is_debugged` lldb 下 | 1 | 1(P_TRACED 命中) |
| 反汇编 `ig_sys_getpid` 查立即数 | 不含真实号 20 | 仅见 `#0x4e`(编码值),真实号运行期还原 |
| `ig_decrypt` XOR 往返 | 还原明文 | "getpid" 一致 |
| `ig_dlsym_verified` 干净 libc 符号 | 非 NULL | getpid/dlsym/fopen 均解析 |
| `ig_dlsym_verified` 自身二进制符号(非系统提供方) | **NULL(拒用)** | **REJECTED**(provenance 挡住) |
| `ig_getenv(PATH)` / 缺失变量 | 命中值 / NULL | 正确 |
## 4. 边界(如实声明)
1. **仅 arm64**。直发 svc 绕过 libSystem,跨 iOS 版本调用号/ABI 稳定性由调用方负责;Apple 审核可能关注直发 svc,非 App Store 主线,用于确需防 hook 的关键路径。
2. **混淆非加密**:svc 号掩码、字符串 XOR 密钥均在二进制内,决心足够的逆向者可还原——目标是**抬高静态分析成本**,不是密码学强度。与 svc 号混淆、[10] 桥接同理。
3. **dlopen/dlsym 仍被调用**:仅隐藏其**参数**并对**结果验真**;若需连调用点也抹除,走 Export Trie 手工遍历(IGResolve 预留方向,当前以 dlsym 为主路径)。
4. **原语是隐藏特征非更安全实现**:不做常量时间比较。
5. **is_debugged 只检测不处置**:返回三态(1/0/-1),是否限制由策略层决定;不含非公开反调试手段。
6. **真机接入与业务回归未做**:关键路径替换为 `ig_sys_*`/`ig_dlsym_verified` 后的功能正确性(讯飞语音、下载解包、AliyunPlayer、GCDWebServer)需真机验证。
## 5. 复现
```bash
cd defender
for f in anti_hook/IGAntiHook.c anti_frida/IGAntiInject.c IGDefender.c syscall/IGSyscall.c resolve/IGResolve.c; do
xcrun --sdk iphoneos clang -arch arm64 -miphoneos-version-min=15.0 -O2 -Wall -Wextra -I . -I include -c "$f" -o "/tmp/$(basename ${f%.c}).o"; done
xcrun --sdk iphoneos ar rcs /tmp/libIGDefender.a /tmp/*.o
# 宿主自测:scratchpad sctest.c(svc)、rtest.c(resolve)、ntest.c(拒用负例)、off.c(p_flag 偏移)
```
## 6. 下一步
1. **真机接入**:把关键校验/取数路径改用 `ig_sys_*` + `ig_dlsym_verified`,跑正常业务量化功能/性能影响。
2. **调用点进一步隐藏**:对最敏感路径以 Export Trie 遍历替换 dlsym 调用点。
3. 与 [11] 串联:启动链先 `ig_defender_scan`(观察模式),核心逻辑用本轮原语/直发/验真解析;策略层按 reason 组合限制功能(而非 exit)。
4. 优先级 3(控制流平坦化 / 字符串段加密 / 商用壳)为后续独立评估项,不在本轮。
+91
View File
@@ -0,0 +1,91 @@
# 13 · 基线固化与可复现验证
日期:2026-11-10。本轮完成基线、自动化测试与静态证据归档,没有修改原 readoor 工程或副本业务代码,也未执行真机测试或向外部检测平台送检。
## 1. 本轮结果
| 检查 | 结果 |
| --- | --- |
| 输入 | 根目录 `appstore.ipa`,v2.199.0 / build 2.199.0.3 / `com.ecnup.aSCLdl2` |
| 主可执行文件 | `readoor31OtherPay` |
| 输入 SHA-256 | `ddb89e30c2259b45d3f09dbc825e70c4e84c682a3c23510ceb3aa6f93d891771` |
| 自研直接分支扫描 | 43 个 Mach-O,31 个发生改写,878→0 |
| 逐指令校验 | 878 个目标分支保留 BL/B 类型,桥接指向原 GOT 槽;其余 `__text` 指令保持一致 |
| UUID / 结构 | 前后 UUID 一致,已记录每个文件及切片;LINKEDIT 偏移检查及 `otool -l` 解析通过 |
| 签名 | 嵌套 bundle / dylib 从内向外 ad-hoc 签名,逐个 `codesign --verify --strict` 通过 |
| 重打包验证 | 新 IPA 解包后重新扫描为 0,Mach-O 哈希与打包前一致 |
| 自动化测试 | 28 项通过,未跳过:静态库重定向 15 项、Mach-O 6 项、运行时宿主/交叉编译 7 项 |
| 原始输入 | 归档前后哈希一致 |
当前输入**不是原漏洞报告的同一个包**。报告为 v2.197.2 / `com.ecnup.azZVz02`,其对应 IPA 尚未确认取得。本轮只证明当前 v2.199.0 同版本前后比较成立,不得表述为原报告已通过。
核对最初复制时保存的原工程指纹:讯飞库和 `Podfile.lock` 一致,原工程 `project.pbxproj` 已有 SJTU OAuth 业务引用差异。本轮没有写入或回退原工程;差异及观测哈希记录在结果索引中。当前验证以冻结的 IPA 为准,不把持续开发中的原工程当作静止基线。
## 2. 复现入口
在工程根目录运行(macOS、Xcode、Python 3.11;无需安装 Python 第三方依赖):
```bash
python3 tools/macho_guard/verify_baseline.py appstore.ipa \
--output test-results/verification/new-run
```
输出目录必须不存在,避免覆盖既有证据。工具会复制输入、冻结相关源码、运行冻结源码的全部测试、解包扫描、仅改写命中文件、逐级签名、逐指令校验及重新打包复扫。遇到命令失败、加密输入、未覆盖架构、空间不足或不一致时中止,已创建目录内记录 `status=failed`,不能作为通过证据。
复现指相同源码和输入下得到一致的调用点统计及检查结论;ZIP 时间戳、签名和运行地址可能变化,不要求每次输出 IPA 逐字节一致。
## 3. 证据位置
本次有效归档:`test-results/verification/20261110-step1-final/`。先前 `20261110-appstore-step1/` 是初次运行,仅保留作为过程记录;引用本轮结论以 `step1-final` 为准。
| 文件 | 用途 |
| --- | --- |
| `manifest.json` | 输入版本/哈希、工具哈希、环境、统计及未完成的验收项 |
| `source-snapshot/`、`source-files.json` | 当次改写器、静态库工具、Defender、测试及 fixture 的源码快照和哈希;不依赖未提交的 Git 状态 |
| `baseline/input.ipa`、`baseline/unpacked/` | 同一个原始输入及解包内容 |
| `guarded/guarded.ipa`、`guarded/unpacked/` | 加固输出及打包前内容,供后续静态复测准备使用 |
| `before-binaries.json`、`after-binaries.json` | 每个 Mach-O 的 SHA-256、切片大小、UUID、段结构、各符号命中数 |
| `before-callsites.csv`、`after-callsites.csv` | 逐调用点地址、分支类型及符号;加固后为空清单(保留表头) |
| `rewrites.json` | 每个被改写文件的改写数及符号明细 |
| `before-files.json`、`after-files.json` | 完整 Payload 文件哈希清单,符号链接单独记录 |
| `repacked-binaries.json`、`repacked-callsites.csv` | 新 IPA 重新解包后的验证记录 |
| `commands.log` | 实际执行命令、输出及退出码,包括 28 项测试、签名和结构检查 |
| `evidence-hashes.json` | 全部归档文件的校验清单,不含自身 |
大文件位于 Git 忽略的 `test-results/`,已保存在本地,不会自动随源码提交。迁移或长期保存应复制整个有效归档目录。小型结果索引保存在 `docs/evidence/20261110-step1-summary.json`。
校验归档完整性(工程根目录):
```bash
python3 - <<'PY'
import hashlib, json, os
from pathlib import Path
root = Path('test-results/verification/20261110-step1-final')
for record in json.loads((root / 'evidence-hashes.json').read_text()):
path = root / record['path']
if 'symlink' in record:
assert path.is_symlink() and os.readlink(path) == record['symlink'], path
else:
h = hashlib.sha256()
with path.open('rb') as f:
for block in iter(lambda: f.read(1024 * 1024), b''):
h.update(block)
assert path.stat().st_size == record['size'] and h.hexdigest() == record['sha256'], path
print('归档校验通过')
PY
```
## 4. 新增的测试与拒绝条件
Mach-O 测试由 Apple 链接器生成 iOS arm64 样本,覆盖真实分支改写、原 GOT 地址保留、UUID、重复注入、输入覆盖、架构不支持、截断、加密、header 空间不足及 ZIP 路径逃逸。修正了 LINKEDIT 字段所在命令位于新插入命令前方时,不应统一将字段位置右移 72 字节的问题。
运行时测试只在独立宿主进程中运行:正常环境零告警、缺失符号上报 unavailable、本地函数提供方异常、两个环境变量条目分别上报、加载无害的特征名测试 dylib、真实 GOT 槽改指测试函数后命中 reason=102。另对三个 Defender 模块做 iphoneos/arm64 交叉编译。没有修改系统函数代码,也没有进行 inline Hook 真机验证。
## 5. 尚未完成的验收
1. V4.6.6 外部复测:自研扫描规则来自报告示例的推断,878→0 不等于厂商扫描清零。
2. 开发者身份、entitlements、Provisioning 下的真机安装与业务回归:当前 ad-hoc 结果只用于本地静态验证。
3. Defender 在 App 启动、回前台的实际调用与正常 SDK 误报检查,以及受控 inline Hook 正向验证。
4. 原报告对应包及同版本前后厂商复测对照。
后续进入第二步:在 `readoor-test` 的 `readoor31` 上核实接入并制作真机观察包,继续使用 ZipZap;不切回已知打包失败的旧 `readoor` target。
+123
View File
@@ -0,0 +1,123 @@
# 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 项真机诊断分开统计,不合并宣称整包验收通过。
@@ -0,0 +1,88 @@
# 15 · 观察包业务回归
日期:2026-11-10。用户授权使用提供的测试账号,打开首页任意资源;凭证不写入源码、文档或测试日志,不自动提交真实支付。
## 当前进度
2026-11-11 续测:设备恢复连接,独立观察包已安装并启动;用户完成协议确认、图片验证码及真实账号登录。首页 `[pdf]MW书籍测试读` 的详情及前后台恢复用例通过。首页 `【epub】会员免费书籍` 可进入 EPUB 内容(显示封面/正文和 `1/69`),前后台恢复和冷启动检查通过。业务回归结果为**部分通过**,受保护路径尚未验收。
PDF 试读进入旧阅读器并显示“已下载 100%”后发生 `NSRangeException`:`RBCoreCurlTurningViewController.pageViewController:viewControllerAfterViewController:` 访问索引 2,数组范围为 0…1。未改写同构建基线也复现相同异常和回调,说明该故障并非两处分支改写独有;不据此排除所有加固兼容风险。此次未修改旧阅读器业务代码。
对照基线使用同 Bundle ID/签名/源码构建,保留观察包登录和数据容器,仅撤销 ZipZap 两处分支改写;两包 `__text` 的差异恰为这两条指令所在 8 字节,见 `baseline-comparison-20261111.json`。两份崩溃报告为 `trial-crash-20261111.ips` 和 `pdf-baseline-crash-20261111.ips`,应用标识均已核对为观察包;摘要在 `pdf-ab-comparison-20261111.json`。对照后已恢复加固观察包。自动化用例启动或截图完成不代表阅读内容已成功渲染。
此前 `readoor31` Release 观察构建、45 项宿主/工具测试、独立 Runner 构建通过。观察包完成两处改写、开发签名及嵌套严格验证,IPA 内二进制哈希一致。2026-11-10 安装曾受 CoreDevice 4016/设备离线阻塞,原日志保留;2026-11-11 已解除。宿主/工具测试与业务测试不合并计算。
`security-final-20261111.jsonl` 共 14 条快照,覆盖本轮启动/前台事件(包含加固包与对照阶段),检测及不可用原因均为空;扫描耗时约 4.26–29.87 ms,中位数 14.21 ms。这只是单台设备的小样本,不是性能基准。四个 ZipZap 计数的最大值均为零,故当前业务没有证明命中其受保护文件输出。本轮未扩大保护范围,也未执行支付、异常网络/取消、实际 inline Hook 或厂商复测。
## 观察包
- Bundle ID:`cn.touchv.iosguard.observe.20261110`,显示名:`教育汇·观察`。
- 来源:工程内 `readoor-test` 副本,源码版本 `2.156.0 / 2.156.0.1`;原工程不修改。
- 使用真实登录及网络请求,不启用 `--UITesting` 或项目内假 token 注入。
- 独立数据容器和 Keychain,移除五组 URL scheme,避免与原 App 争用回调。
- 独立 Bundle ID 下的 Apple 登录、关联域、共享 Keychain、外部支付回调和绑定 Bundle ID 的第三方 SDK 授权需要另行验证。
- Swift 安全策略保持观察模式,C 调度入口仍会拒绝篡改、不可验证及解析重入。
## 可观测性
只有定义 `IG_OBSERVATION` 的构建包含只读原子计数:`write_attempted/write_dispatched/close_attempted/close_dispatched`。`dispatched` 表示已调用系统函数,不能解释为 I/O 成功。新增宿主测试验证系统错误仍计入 dispatched、校验拒绝不计入 dispatched,以及普通构建不导出观察接口。
专用 Bundle ID 在既有安全评估事件后写入 `Documents/IGObservation/security.jsonl`,包含事件、模式、扫描耗时、检测/不可用原因编号和调用计数,不包含用户资料、凭证、资源 URL 或原始地址。计数为进程内累计,冷启动重置。记录是事件快照;完成资源操作后需触发前后台评估再读取。
## 已确认的业务调用链
当前两个保护点为 ZipZap 的 `ZZFileChannelOutput.writeData:error:` 和 `close`。新版 PDF/单词书下载解压链为:
```text
RDWordBookHandler → RDPDFDownloadAPIService.downloadAndUnzip → SSZipArchive.unzipFile
```
源码:`readoor-test/readoor/3.0/Features/ReadView/PDF/Network/RDPDFDownloadAPIService.swift` 和 `readoor-test/readoor/3.0/Features/ReadView/MemorizeWords/Handler/RDWordBookHandler.swift`。旧版 `STSCourseCardLearnHandler.m` 的 ZipZap 调用从 NSData 读取首个条目,不能据此认为执行了受保护的文件输出。
本轮实际 EPUB 的源码解包链为 `BookView/EPUB/Core/Classes/newEpub/epub/EpubParser.extractEpub → STSFileManagerStorage.unzipFileAtPath`。`STSStorage.framework` 的导入和依赖均指向 `SSZipArchive.framework`;已保存 `stsstorage-unzip-import-20261111.txt`。这属于源码及二进制依赖证据,尚未逐调用点采集运行时命中。
包内 `SSZipArchive.framework/SSZipArchive` 为 `MH_DYLIB`,导入 `fopen/fread/fwrite/fclose`。当前定点工具要求入口已链接在同一 Mach-O,不能直接把跨镜像分支写到主程序里的调度入口。扩大保护前需补独立 Framework 内的入口/绑定方案及签名验证,或在可重建 SDK 中编入入口,再按固定 ABI 验证;不能只增加主程序规则并声称已覆盖此 SDK。
因此首页资源运行正常且计数为零时,只能记录业务链未命中 ZipZap 文件输出。下一轮应按实际资源类型确定 SSZipArchive/minizip 调用者、固定 ABI 和预期调用次数,建立基线,再定点扩大保护和对照回归。
## 工具与证据
- `tools/business_regression/prepare_observation_app.py`:校验通配开发 profile、证书和有效期;复制、改写、独立化、签名、打包和生成哈希。`--baseline` 仍核对 Link Map 和预期调用点,但丢弃分支改写,用于同构建对照。
- `tools/business_regression/create_ui_runner.rb`:生成独立 UI 测试工程,不修改业务工程。
- `tests/business_regression/IGBusinessRegressionTests.swift`:启动、首页资源、试读、EPUB、前后台、冷启动及 PDF 复现用例。当前截图遮盖输入框,文本树删除输入值;初次登录诊断原始 xcresult 已删除,只保留已脱敏附件。
- 证据目录:`test-results/step3/`;构建目录:`test-results/ObservationDerivedData/`。
- 安装包:`test-results/step3/observation-package/observation.ipa`;签名 App 在同目录 `Payload/readoor31.app`。
- 包内 `manifest.json`、`redirect-report.json`、`source-snapshot/`、`commands.log` 和 `evidence-hashes.json` 保留打包当时快照;其中业务 `not_run` 不追写,实际业务结果另见 `docs/evidence/20261111-step3-business-summary.json`。
- `build-observation.log`、`build-ui-runner.log`、`host-tests.log`;安装失败和设备详情日志保留连接问题证据。
观察构建在既有标志上增加 `OTHER_CFLAGS='$(inherited) -DIG_OBSERVATION=1'` 和 `OTHER_SWIFT_FLAGS='$(inherited) -D COCOAPODS -D TARGETTYPE_7 -D IG_OBSERVATION -Xcc -DIG_OBSERVATION=1'`,使用 Release、iphoneos 和同次 Link Map。打包脚本的身份/profile 参数来自本机合法开发签名配置,输出目录必须不存在。
有效 UI 结果包:`home-resource-20261111.xcresult`、`epub-guard-20261111.xcresult`、`cold-restart-20261111.xcresult`。`trial-resource-20261111.xcresult` 只证明试读入口截图完成,其后发生崩溃,不记为阅读通过。`pdf-baseline-20261111.xcresult` 为同构建对照的实际失败记录。每项对应日志和导出附件在同级目录,最终驱动源码及哈希在 `business-run-20261111/`。
用户 2026-11-11 明确暂缓 PDF 越界修复、完整业务回归及报告复测。本轮改用首页 `31单词书(稳操胜券)-勿动` 建立 SSZipArchive 运行时命中证据;ZipZap 原试点仍需能命中文件输出的业务样例。协议确认及验证码均由用户完成。
## 回滚与验收边界
本轮改动前文件及哈希在 `test-results/step3/before/`。只取消观察能力时移除观察编译宏即可;完整恢复时逐个恢复备份对应文件,保留其他改动。观察包可单独卸载。前两轮冻结证据不修改,原报告同版本和厂商 V4.6.6 复测仍待完成。
## 单词书解包观察(2026-11-11)
仅在 `IG_OBSERVATION` 编译时,在 `RDPDFDownloadAPIService.unzip` 紧邻真实 `SSZipArchive.unzipFile` 调用前后记录 `unzip_begin/unzip_end`;单词书正式目录命中记录 `wordbook_cache_hit`。写入独立观察包 `Documents/IGObservation/archive.jsonl`,以随机 call_id 配对,结果包含 success 和耗时,不记录路径、下载地址、用户标识或凭证。串行锁保护并发写入,记录失败不改变原业务返回值。普通构建不包含这些记录。
该记录证明 SDK 边界被调用及其返回结果,不能用于证明 SDK 内部 fopen/fwrite 已被保护。此轮代码、Release 构建和新签名包在 `test-results/step4-wordbook/`,不覆盖此前冻结证据。关闭观察宏即可移除此项能力。
### 单词书实测结果
`read-v2.xcresult` 与 `reentry.xcresult` 两项真机用例通过:从详情的“稳操胜券”课件卡片进入,单词书显示已学 0 词、未学 7502 词,前后台恢复、返回重进均正常。未点击学习/复习或完成学习任务。
`archive-final.jsonl` 记录 1 对真实 `unzip_begin/unzip_end`,SDK 返回 success=true,耗时 12015.24 ms。首次进入时 style/dict 已命中缓存;SDK 边界事件未携带资源类型,因此不将该次调用标成已确认的具体包类型,也不声称覆盖了样式、词库的首次解压。重进时 style/dict/sound 均命中缓存,没有新增解压。未清理用户缓存,未修改服务端资源配置。SDK 成功返回及后续缓存发布可观测,未逐文件校验解压内容。
两次新增前台安全快照均无检测/不可用项,扫描约 17.28/15.07 ms;ZipZap 四项计数均为零。本轮只增加观察能力,没有扩大 SDK 内部函数的保护。下一步需为动态 `SSZipArchive.framework` 制定并验证 Framework 内入口/绑定或可重建 SDK 的保护方案,再对同一单词书进行改写前后对照;不得把本次调用证据当作 fopen/fwrite 保护验收。
Release 构建、Runner 构建、两处既有分支改写、开发签名及严格验证通过,新包 599 个文件哈希核对通过。过程中的失败保留:`detail.xcresult` 被营销弹窗阻挡,`read.xcresult` 因假定存在“开始阅读”按钮失败;已据实际页面调整驱动。`detail-v2.xcresult` 只证明详情壳可达,其截图尚在骨架加载,不单独记为完整详情通过。
最终证据和驱动快照归档到 `test-results/step4-wordbook/business-run/`(39 个文件及哈希清单);摘要为 `docs/evidence/20261111-wordbook-ssziparchive-summary.json`。新包为 `test-results/step4-wordbook/observation-package/observation.ipa`,可执行文件 SHA256 为 `e43f8990acefd09754db275504a15359a87bc05ea2eb5044c3839c67dede731c`。PDF 修复、完整业务回归、报告复测继续按用户要求暂缓。
## 后续 SDK 保护试点
2026-11-11 已继续实现 SSZipArchive 动态绑定保护,新增保护 Framework,覆盖 fopen/fread/fwrite/fclose 四个导入。以相同 Release 主程序进行指定词书样式包解压对照,两包输出 9 文件 / 1,890,776 字节,聚合摘要一致;保护包四个入口实际命中 10 / 388 / 466 / 10 次,均放行且无拒绝。该结果不追写本页此前冻结的业务归档,独立记录见 [SSZipArchive 动态 Framework 保护试点](16_SSZIPARCHIVE_FRAMEWORK_GUARD_PILOT.md),证据在 `test-results/step5-ssziparchive/`。PDF 修复、完整回归和报告复测仍暂缓。
@@ -0,0 +1,63 @@
# SSZipArchive 动态 Framework 保护试点
日期:2026-11-11。范围:工程内 `readoor-test` 副本的独立观察包,以及已审核 SSZipArchive 的四个文件函数导入。PDF 越界修复、完整业务回归和检测报告复测继续暂缓。
## 实施机制
```text
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。原始日志保留,不将该失败尝试当成成功的定点清理。
## 当前验证
- `readoor31` Release 及独立 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/`,哈希清单不含自身。
@@ -0,0 +1,68 @@
# 17 · 真机 HOOK 正向验证(step11)
日期:2026-11-12。状态:**已完成,11/11 用例通过**。补齐 [11](11_RUNTIME_ANTIHOOK_MODULE.md) §5.3、[14](14_ZIPZAP_RUNTIME_DISPATCH_PILOT.md) §6、[16](16_SSZIPARCHIVE_FRAMEWORK_GUARD_PILOT.md) 验收边界中反复挂账的"受控真机正向验证":此前所有真机证据只有干净环境零误报,攻击形态能否命中从未在真机证明。同轮新增两个探针并接入聚合:**调试器跟踪**(reason=300,复用 docs/12 的 `ig_sys_is_debugged`)与 **ObjC 方法 IMP 基线**(reason=110,docs/05 P1 点名的 swizzle 检测空洞),随 `ig_defender_scan` 在真机逐例执行。
设备:iPhone 16 Plus(iPhone17,4),iOS 27.2,非越狱,开发签名(TouchLinked_dev 通配 profile,专用 Bundle ID `cn.touchv.iosguard.hookpilot.20261112`,测试后已卸载)。
## 1. 验证方式
独立诊断进程 `tests/fixtures/hook_device.m`(模式沿用 step2 `dispatch_device.m`),在**自身进程内**构造攻击形态后运行真实探针链。构建器 `tools/macho_guard/build_hook_device.py`,执行器 `tools/macho_guard/run_hook_device.py`(安装→两相位→卸载→证据哈希)。攻击构造(可写 GOT、装载模拟 dylib、特征线程名、方法替换)只存在于诊断源码,绝不编入业务库。
两相位:
- **相位 A(干净启动)**:10 个用例,覆盖 5 类攻击形态 + 基线 + 恢复检查。
- **相位 B(DYLD_INSERT_LIBRARIES 启动)**:宿主以 `devicectl -e` 注入环境变量启动,**dyld 在非越狱设备上真实装载** Documents 下的模拟 dylib——这是越狱外可行的真实注入路径(等同 Frida gadget 的加载形态)。
## 2. 用例与结果(`20261112-v1`,全部 PASS)
| 用例 | 攻击形态 | 期望 | 实测 |
| --- | --- | --- | --- |
| baseline_clean | 无(聚合含新调试器探针) | 0 DETECTED | PASS(零误报;直发 sysctl 真机 clear) |
| got_rebind | fishhook 同款:`vm_protect(VM_PROT_COPY)` 改写自身 `__got` 的 getpid 槽 → 本进程函数 | reason=102 | PASS,证据含槽址/当前值/提供方 |
| got_restore_clean | 恢复原始指针 | 0 DETECTED | PASS(恢复有效、无粘滞) |
| prologue_b_branch | 导出符号首指令 `b .+64`(经 dlsym→dladdr→vm_read_overwrite 完整链) | reason=100+101 | PASS |
| prologue_ldr_br | `ldr x16,#8; br x16` 蹦床 | reason=100+101 | PASS |
| frida_thread | 子线程 `pthread_setname_np("gum-js-loop")` | reason=203 | PASS |
| frida_thread_gone | join 后重扫(2s 轮询容忍内核回收延迟) | 0 DETECTED | PASS |
| injected_image | Documents 下 dlopen 特征名 `libfrida-sim.dylib` | reason=200 | PASS |
| foreign_image | Documents 下 dlopen 无特征名 `libiosutil-sim.dylib` | reason=201(弱信号) | PASS |
| objc_imp_baseline | 运行期类采集基线后 `class_replaceMethod` 换实现 | reason=110 | PASS |
| dyld_insert(相位 B) | `DYLD_INSERT_LIBRARIES` 指向 Documents dylib,dyld 真实装载 | reason=202(+200) | PASS,**202 与 200 双命中** |
探针行为澄清(本轮实证):命中注入特征名(200)的镜像**不再重复上报** Bundle 外(201);200 与 201 是互斥的两种形态,分别用两个用例验证。
## 3. 性能小样本
真机整包聚合扫描(anti_hook 12 符号 + ObjC 基线 + 注入 + 线程 + 调试器探针)5 次:avg 0.55 ms / min 0.53 ms。单机单次小样本,不推导总体性能结论;此前观察包业务内 17~30ms 的量级主要来自 Swift 策略层与观察日志开销,C 探针本身远低于该值。
## 3.5 同轮新增的探针模块
- `defender/anti_debug/IGAntiDebug.{h,c}`:把 docs/12 已实测的 `ig_sys_is_debugged()`(直发 sysctl 查 P_TRACED)接入 `ig_defender_scan` 聚合,reason=300(1→DETECTED / -1→UNAVAILABLE)。此前该能力存在但策略层无从消费。
- `defender/anti_hook/IGObjCBaseline.{h,c}`:ObjC 关键方法 IMP 基线探针,reason=110。策略层用 `ig_objc_baseline_capture()` 登记关键方法(类名+选择子,≤64 条),check 时 `method_getImplementation` 与基线比较:IMP 换人(swizzle/replace/exchange)或 IMP 不变但代码前缀变化(函数体改写)即 DETECTED;类/方法不可解析 UNAVAILABLE;未 capture 时 no-op。填补 docs/05 §4 P1 指出的"IMP 基线检测"空洞。
- 原因码补充:107 显式标注为 Swift 观察层 archive-dispatch 保留;新增 110(ObjC IMP)与 300(调试器跟踪)。
- 两个设备构建器(dispatch/hook)模块清单同步更新(+IGObjCBaseline/IGAntiDebug/IGSyscall,链接 +lobjc)。
宿主测试新增 3 项(`tests/test_defender_host.py`):调试器探针干净环境、ObjC 基线干净路径、ObjC 基线 replace 正向;全套件回归通过。
## 4. 复现
```bash
python3 tools/macho_guard/build_hook_device.py \
--profile <TouchLinked_dev.mobileprovision> --identity <SHA1> \
--bundle-id cn.touchv.iosguard.hookpilot.<date> \
--output test-results/step11-device-hook/build-<date>
python3 tools/macho_guard/run_hook_device.py \
--device <UDID> --app test-results/step11-device-hook/build-<date>/IGHookPilot.app \
--bundle-id cn.touchv.iosguard.hookpilot.<date> \
--output test-results/step11-device-hook/<date>-v1
```
输出目录必须不存在;证据:`device-verification.json`(用例/结论/边界)、`console-clean.log`、`console-insert.log`、`launch-*.json`、`install/uninstall.json`、`evidence-hashes.json`;构建侧 `build-*/manifest.json` 含源码快照哈希。宿主侧另有同一 fixture 的 9 用例冒烟(/tmp,未归档);既有 59 项宿主/工具测试重跑通过,无回归。
## 5. 边界(如实声明)
1. **inline-hook 仍非"真实系统函数 patch"**:非越狱无法改写共享缓存代码页。本用例针对受控导出符号的**真实代码字节**验证"解析→读取→分类"全链,序言分类逻辑与真实 patch 场景相同;对系统函数的实际 inline Hook 检测仍需越狱设备(后续可选)。
2. **特征可规避**:镜像名/线程名改写即绕过 200/203;本验证证明"命中抓得住",未命中不等于干净(组合判定原则不变)。
3. **诊断进程 ≠ 业务 App**:独立进程、无业务代码;业务 App 内的攻击面(ObjC 方法、业务函数)不受本轮覆盖——ObjC IMP/swizzle 检测仍是空洞,见 README 差距清单。
4. `frida_thread_gone` 依赖内核线程回收延迟(2s 轮询窗口);极端缓慢环境下可能仍残留,属环境噪声。
5. 相位 B 的 dylib 路径来自相位 A 回显(Documents 容器路径),两次运行间重装会变化,不可硬编码。
+165
View File
@@ -0,0 +1,165 @@
# 18 · readoor 接入 iOSGuard Defender 方案
> 目标:把 iOSGuard 的「检测 → 分级 → 数据依赖毒化」闭环接到 readoor 业务工程。
> 边界:**纯客户端**,不引入服务端;分发渠道=**App Store 上架**,故处置**只用数据污染 + 功能静默降级,不随机崩溃**。
> 本文件只在 iOSGuard 侧产出「可集成产物 + 接入步骤」,**不修改 readoor 代码**。真正落地到 readoor 时须走 readoor 的 Skill 流程 + xcodebuild。
---
## 0. TL;DR —— 接入只有「两处调用」
1. **启动链 / 回前台 / 关键操作前** 调一次策略扫描:
```swift
ig_policy_scan_and_mark(bundlePath, 0, observerSink, nil)
```
命中高置信越狱/Hook 组合时,它**不 exit、不弹窗**,只在内部把毒化态置脏。
2. **epub 解密前**,对密钥字节过一遍毒化掩码:
```swift
ig_poison_apply(keyIn, keyOut, keyLen) // 健康:原样;毒化:逐字节异或掩码
```
健康设备 `keyOut == keyIn`,解密正常;毒化设备 key 被打乱,`sfc_SimpleDeCrypt` 解出乱码,书读不了——**没有可 patch 的 `if` 分支**。
其余都是工程接线(静态库 + bridging header + Header Search Paths)。
---
## 1. 产物(iOSGuard 侧已就绪)
用构建脚本一键产出可集成件:
```sh
sh tools/build_defender_lib.sh /path/to/out
```
产物结构:
```
out/
├── lib/
│ └── libIGDefender.a # arm64 iphoneos 静态库(-O2),只采集 + 毒化,无网络、无 UI、无 exit
└── include/
├── IGGuard.h # 统一公共头(umbrella)—— bridging 只 import 这一个
├── IGDefender.h # IGStatus/IGReason/IGFinding/IGFindingSink + ig_defender_scan
├── poison/IGPoison.h # ig_poison_init / ig_poison_mark / ig_poison_apply
├── policy/IGPolicy.h # ig_policy_scan_and_mark / ig_policy_sink / IGPolicyState
└── … # 其余子模块头,保持相对目录供 umbrella 引用
```
脚本已校验:单一 `-Iout/include` 即可编译 `IGGuard.h`(自洽),且导出符号包含
`ig_policy_scan_and_mark / ig_poison_apply / ig_poison_init / ig_defender_scan`。
> 产物是**纯 C**,不依赖 Foundation/UIKit,无动态加载,无第三方。App Store 合规面只有:静态库里有直发 `svc`(反 libc hook)与越狱特征文件路径常量——均为被动只读探测,不触发拒审项(无私有 API 符号、无越狱必备 entitlement)。
---
## 2. 工程接线(Xcode / readoor31 target)
> 以下是 readoor 侧要做的配置,列出以便一次到位;**本仓不替 readoor 改**。
1. **放置产物**:把 `libIGDefender.a` 与 `include/` 纳入 readoor 工程(建议 `readoor/3.0/Base/Security/IGDefender/`)。
2. **Link**:target → Build Phases → Link Binary With Libraries 加入 `libIGDefender.a`;因含 ObjC runtime 读取,Other Linker Flags 补 `-lobjc`。
3. **Header Search Paths**:加 `$(SRCROOT)/…/IGDefender/include`(非 recursive 即可,umbrella 内部按相对目录引用)。
4. **Bridging Header**:在 readoor 既有 bridging header 里加一行
```objc
#import "IGGuard.h"
```
之后 Swift 侧即可直接调用 `ig_policy_scan_and_mark` / `ig_poison_apply` 等 C 符号。
5. **构建验证**(readoor 默认命令):
```sh
xcodebuild build -workspace readoor.xcworkspace -scheme readoor31 \
-sdk iphoneos -derivedDataPath /private/tmp/readoor-derived
```
---
## 3. 接入点一:处置触发(替换 `RDSecurityGuard.forceExit()`)
**现状**:`readoor/3.0/Base/Security/RDSecurityGuard.swift` 的 `evaluate(event:)` 在 highRisk 时走 `forceExit() → exit(0)`。
`exit/_exit/abort` 都是**单点、显式、可被 hook** 的控制流,Shadow/Liberty 一个断点就废掉。
**改法**:把 `exit(0)` 这条路换成策略扫描 + 毒化(**不 exit**)。在原来调用 `evaluate` 的事件点
(launch / foreground / beforeLogin / beforePayment / beforeVipPurchase / beforeActivation)改为:
```swift
// RDSecurityGuard 内部,原 forceExit() 调用点替换为:
let bundlePath = Bundle.main.bundlePath
_ = bundlePath.withCString { cBundle in
ig_policy_scan_and_mark(cBundle, 0) { finding, _ -> Int32 in
// observer:仅打点,不含敏感信息(不打 Token/手机号/用户ID/订单号)
// 可转发到 RDOSLogManager 记 reason/status 计数,用于灰度观测误报面
return 0
} as IGFindingSink, nil)
}
// 返回后不做任何可见动作:命中与否对 UI 完全透明。
// 真正的「拒服务」在接入点二随解密自然发生。
```
要点:
- **一次扫描即判**:`ig_policy_scan_and_mark` 内部 reset → `ig_defender_scan` → 按档位组合判定 → 命中则 `ig_poison_mark`。
- **检测与处置解耦**:这里**只置脏**,书打不开发生在接入点二,时空分离,攻击者难把「检测」和「后果」对上。
- **observer 打点合规**:遵守 readoor AGENTS — 日志不输出 Token / 手机号 / 用户 ID / 订单号 / 支付结果 / 完整请求参数,只记 `reason` 枚举与计数。
- **保留 Swift 既有探针**:`RDJailbreakDetector`(public API:canOpenURL / FileManager)可留作**观察打点**,但判定权交给 C 侧 svc 直发(绕过 bypass 对 libc/公开 API 的 hook)。即 Swift 层量化误报面,C 层定罪。
---
## 4. 接入点二:数据依赖毒化(epub 解密)
**现状**:`readoor/3.0/Features/ReadView/Epub/RDEncryptedEpubResourceProvider.swift`
`decrypt(path:key:)` 调 `StsSimpleCrypt.sfc_SimpleDeCrypt(path, pass: key)`;
`bookKey = doubled("startiasoft" + bookIdentifier)`,imageKey 走 MD5。
**改法**:在把 key 交给 `sfc_SimpleDeCrypt` **之前**,对 key 字节过 `ig_poison_apply`:
```swift
// decrypt(path:key:) 内,调用 sfc_SimpleDeCrypt 之前:
func poisonedKey(_ key: String) -> String {
var inBuf = Array(key.utf8)
var outBuf = [UInt8](repeating: 0, count: inBuf.count)
ig_poison_apply(&inBuf, &outBuf, inBuf.count)
return String(decoding: outBuf, as: UTF8.self) // 若 key 是二进制,改用 Data 承载,勿走 UTF8
}
// let realKey = poisonedKey(key); StsSimpleCrypt.sfc_SimpleDeCrypt(path, pass: realKey)
```
语义:
- **健康设备**:`ig_poison_mask() == 0` → `ig_poison_apply` 是**恒等变换**,`outBuf == inBuf`,解密与现状完全一致,零影响。
- **毒化设备**:mask ≠ 0 → key 每字节被 `(mask >> ((i&7)*8)) & 0xFF` 异或打乱 → `sfc_SimpleDeCrypt` 解出乱码 → 书页/图片无法渲染。
- **无分支可 patch**:这里没有 `if(越狱)`,毒化靠数据流(mask)天然传播;要绕得逆向整条密钥推导并还原 mask=0 的恒等性,成本从「分钟级断点」抬到「天级逆向」。
> 若 key 实际是二进制(非可打印字符串),**不要**经 `String(UTF8)` 往返(会丢字节)。改成对承载 key 的 `Data`/`[UInt8]` 原地 `ig_poison_apply`,再按 `sfc_SimpleDeCrypt` 需要的类型传入。
---
## 5. 误报底线(上线前提)
毒化**隐蔽且不可逆**:误伤非越狱正常用户=「书打不开」的差评 + 难排查退款。故策略层(`IGPolicy.c`)已内建底线,接入时**不要放宽**:
| 档位 | reason | 触发规则 |
|---|---|---|
| **STRONG**(单条即判) | 400 越狱文件 / 401 沙盒逃逸 / 102 GOT 重绑 / 101 inline hook / 200 注入镜像 / 300 调试器 | `strong_count ≥ 1` |
| **MEDIUM**(需组合) | 100 符号提供方 / 110 ObjC IMP / 203 frida 线程 | `≥2 个不同 MEDIUM`,或与任一 STRONG 同现 |
| **WEAK**(永不毒化) | 201 Bundle 外镜像 / 204 frida 端口 | 仅观察打点 |
- `IG_UNAVAILABLE`(架构/平台不支持、数据缺失)与 `IG_CLEAR` **一律忽略**,绝不当攻击。
- 110 ObjC IMP 合法 swizzling 会误报,故**不单条定罪**,归 MEDIUM。
- **灰度上线**:先让 §3 的 observer 只打点、**接入点二先不接**(或 `ig_poison_apply` 旁路),用线上 `reason` 分布确认「非越狱设备零 STRONG、MEDIUM 不成对」后,再开毒化。
---
## 6. 能力边界(务必对齐预期)
- **纯客户端无法根治 bypass**:Shadow/Liberty 等能把越狱检测 hook 成「干净」。本方案**不锚定「客户端准确判越狱」**,而是:① svc 直发抬高 hook 成本;② 数据污染比 exit 强一个量级;③ 检测-处置解耦 + 延迟分散后果,让「绕过一次」≠「永久绕过」。目标是把破解成本从分钟级抬到天级,不是不可破。
- **App Store 合规**:处置只有数据污染 + 静默降级,**不随机崩溃**,不触发拒审。
---
## 7. 后续硬化 TODO(接入后迭代,不阻塞首版)
1. 越狱路径字符串 `IG_ENC` 混淆(避免 `strings` 直接捞出 `/var/jb`、`Cydia` 等常量)。
2. `IGPoison` 三副本分散存储(TLS/heap,别全在 BSS 相邻)。
3. OLLVM/VMP 覆盖 `ig_poison_mark / ig_poison_mask / ig_poison_apply` 与策略分级表。
4. 毒化基线魔数运行期派生(别硬编码 `0xA5C3F10E7B2D4968`)。
5. 越狱探针真机正向验证:在越狱设备实测命中 400/401,且非越狱设备零 STRONG。
+98
View File
@@ -0,0 +1,98 @@
{
"schema_version": 1,
"status": "passed_local_checks",
"created_utc": "2026-11-10T07:29:55.370792+00:00",
"scope": "自研直接分支规则与静态结构;不代表 V4.6.6/真机验收",
"app": {
"CFBundleIdentifier": "com.ecnup.aSCLdl2",
"CFBundleShortVersionString": "2.199.0",
"CFBundleVersion": "2.199.0.3",
"CFBundleExecutable": "readoor31OtherPay"
},
"input": {
"path": "/Users/shenlei/Work/ReadBook/iOSGuard/appstore.ipa",
"size": 128271168,
"sha256": "ddb89e30c2259b45d3f09dbc825e70c4e84c682a3c23510ceb3aa6f93d891771"
},
"original_report": {
"version": "2.197.2",
"bundle_id": "com.ecnup.azZVz02",
"exact_report_binary_available": false,
"note": "当前输入单独建基线,不视为原漏洞报告二进制"
},
"environment": {
"platform": "macOS-26.7.1-arm64-arm-64bit",
"python": "3.11.3 (v3.11.3:f3909b8bc8, Apr 4 2023, 20:12:10) [Clang 13.0.0 (clang-1300.0.29.30)]",
"xcode": "Xcode 27.1\nBuild version 27A9275",
"clang": "Apple clang version 21.0.0 (clang-2100.3.34.2)\nTarget: arm64-apple-darwin25.6.0\nThread model: posix\nInstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin"
},
"tools": {
"tools/macho_guard/batch.py": "aa9cb201a32c35367ab2d7cefb02f1c51676b4d8fbf19eeeef110f472db51d59",
"tools/macho_guard/macho_guard.py": "cb33515f0a76686727450e99378a6a144aeaeaee8146713ff9c46a012940b108",
"tools/macho_guard/machox.py": "616dff961618cb52e9000b55dda21da75edaeaf1c2a2a822265273b1ef2d8522",
"tools/macho_guard/verify_baseline.py": "4fa9e85e8bc7a7860e69acf1a055a5eee7448091b525a65e9c6d6d7beb0179c1"
},
"automated_tests": "passed; 详见 commands.log",
"before_total": 878,
"after_total": 0,
"macho_files": 43,
"changed_macho_files": 31,
"instruction_and_bridge_validation": "passed",
"guarded_ipa": {
"path": "guarded/guarded.ipa",
"sha256": "74c878fb64008e56dbdc10cea470e34113ee5e84abb8e105e7a52d4919327cb6"
},
"vendor_retest": "not_run",
"device_regression": "not_run",
"signing": "ad-hoc,仅用于本地静态验证",
"archive": "test-results/verification/20261110-step1-final",
"before_symbol_counts": {
"_close": 138,
"_dlopen": 2,
"_dlsym": 312,
"_exit": 99,
"_fopen": 163,
"_fork": 1,
"_getpid": 34,
"_open": 42,
"_read": 24,
"_syscall": 2,
"_unlink": 22,
"_write": 39
},
"test_counts": {
"total": 28,
"static_sdk": 15,
"macho": 6,
"defender": 7,
"skipped": 0
},
"archive_integrity_verified": true,
"evidence_hash_index_sha256": "ab1ef4f8e4a3c87d97798c18fe4a57e0086124780a1eb1792349e4b6c5057f08",
"original_source_observation": {
"note": "本轮未写入原工程;历史指纹存在 pbxproj 业务引用差异,保留现状,不将原工程视为静止基线。当前验证以冻结 IPA 为准。",
"files": [
{
"path": "readoor.xcodeproj/project.pbxproj",
"initial_sha256": "686e9eaf12b4b533d6a8c6dac0ca0aaa3996ffa3080fad70ae04433b1c8caa08",
"observed_sha256": "b4a013c87bd0888c36fc0f7da8d73066a6010693d59c6525760f6879696a4c8d",
"matches_initial": false,
"mtime_utc": "2026-11-10T06:21:19.967065+00:00"
},
{
"path": "readoor/BookShelf/Classes/Factorys/XunFei/iflyMSC.framework/iflyMSC",
"initial_sha256": "b368fa4866d274da0c6e89607e9d5b95b4a59d49c183eb68c947ac2b50ff3c2c",
"observed_sha256": "b368fa4866d274da0c6e89607e9d5b95b4a59d49c183eb68c947ac2b50ff3c2c",
"matches_initial": true,
"mtime_utc": "2026-11-09T02:35:30.281591+00:00"
},
{
"path": "Podfile.lock",
"initial_sha256": "6f8c57990b2a277236145d2e84fb9634e3049f544da70346cbc7a536b0f929ec",
"observed_sha256": "6f8c57990b2a277236145d2e84fb9634e3049f544da70346cbc7a536b0f929ec",
"matches_initial": true,
"mtime_utc": "2026-11-09T02:39:06.704381+00:00"
}
]
}
}
@@ -0,0 +1,66 @@
{
"status": "passed_local_checks",
"app": {
"CFBundleIdentifier": "com.ecnup.aSCLdl2",
"CFBundleShortVersionString": "2.156.0",
"CFBundleVersion": "2.156.0.1",
"CFBundleExecutable": "readoor31"
},
"device_regression": "not_run",
"vendor_retest": "not_run",
"signing": "ad-hoc, static checks only",
"tests": "passed (详见 commands.log)",
"environment": "Xcode 27.1\nBuild version 27A9275",
"total_redirected": 2,
"before_total": 558,
"after_total": 556,
"input_sha256": "f730cb5f0a22fd20e5032c7cf808a195732a7d7107a5fd7498671c83c63d02f7",
"output_sha256": "3bf610eac5f5d6e3b21c80418afc9b3faa12dfc59e04a485b670dbc5e8f58bf9",
"ipa_sha256": "85ae4b064d8416a19f0cc60568cac151b3afc73dcc5fd30dabc91221424c22ef",
"static_tracking_limitations": [
"保留本地调度函数名,名称仍提示用途",
"目标函数名编码可由静态分析还原",
"解析器仍依赖 dlsym/dladdr;不代表调用关系完全不可恢复",
"其他调用者的系统导入/GOT 保留,本次只覆盖指定调用点"
],
"archive": "test-results/step2/zipzap-runtime-final-v3",
"test_counts": {
"automated": 44,
"isolated_device": 8,
"skipped": 0
},
"isolated_device": {
"status": "passed_isolated_diagnostic_only",
"archive": "test-results/step2/device-dispatch-v5",
"device": {
"model": "iPhone 16 Plus",
"os_version": "27.2"
},
"baseline_detected": 0,
"baseline_unavailable": 0,
"cleanup": "uninstalled diagnostic app; existing business apps untouched"
},
"business_app_regression": "not_run",
"actual_inline_hook": "not_run",
"archive_integrity_verified": true,
"step1_archive_integrity_verified": true,
"static_evidence_hash_index_sha256": "81645f9bb7f4e95c99a810569386a97de290346190016eafa90b659dc5632eb9",
"device_evidence_hash_index_sha256": "7045c25b3a284b67fa5b39813958b4b9f2056d7514da20a212f8aef798328e21",
"original_source_observation": [
{
"path": "readoor.xcodeproj/project.pbxproj",
"matches_step1_observation": true,
"observed_sha256": "b4a013c87bd0888c36fc0f7da8d73066a6010693d59c6525760f6879696a4c8d"
},
{
"path": "readoor/BookShelf/Classes/Factorys/XunFei/iflyMSC.framework/iflyMSC",
"matches_step1_observation": true,
"observed_sha256": "b368fa4866d274da0c6e89607e9d5b95b4a59d49c183eb68c947ac2b50ff3c2c"
},
{
"path": "Podfile.lock",
"matches_step1_observation": true,
"observed_sha256": "6f8c57990b2a277236145d2e84fb9634e3049f544da70346cbc7a536b0f929ec"
}
]
}
@@ -0,0 +1,17 @@
{
"date": "2026-11-10",
"stage": "observation_business_regression",
"release_build": "passed",
"host_tests": 45,
"host_tests_result": "passed",
"ui_runner_build": "passed",
"package_signature": "verified",
"package_hash_inventory_files": 594,
"business_regression": "not_run",
"blocker": "physical_device_offline_coredevice_4016",
"bundle_id": "cn.touchv.iosguard.observe.20261110",
"protected_zipzap_calls": 2,
"protection_expanded": false,
"actual_modern_unzip": "SSZipArchive",
"credentials_saved": false
}
@@ -0,0 +1,138 @@
{
"date": "2026-11-11",
"resource": "31单词书(稳操胜券)-勿动",
"bundle_id": "cn.touchv.iosguard.observe.20261110",
"source_version": "2.156.0",
"status": "framework_binding_pilot_and_same_build_wordbook_comparison_passed",
"protection_scope": [
"SSZipArchive: fopen",
"SSZipArchive: fread",
"SSZipArchive: fwrite",
"SSZipArchive: fclose"
],
"host_tool_tests": {
"total": 59,
"this_round": 14,
"passed": true,
"real_dyld_binding_and_got_tamper_test": "Apple Silicon macOS host; not iPhone attack validation"
},
"business_checks": {
"same_build_baseline_style_replay": "passed",
"guarded_style_replay": "passed",
"no_replay_normal_cache_and_reentry": "passed",
"foreground_recovery": "passed",
"learned_words": 0,
"unlearned_words": 7502
},
"comparison": {
"baseline_event": {
"archive_guard_loaded": false,
"call_id": "E69F522F-50ED-43F8-AE03-8898BF80EBB8",
"elapsed_ms": 38.530333345988765,
"event": "unzip_end",
"output_bytes": 1890776,
"output_files": 9,
"output_fingerprint_available": true,
"output_sha256": "7043dfcd54c6ce47154feb48b8ff2a19834c5f8cd4c28dabaa012fc96537ed79",
"sdk": "SSZipArchive",
"success": true,
"time": 1794363370.44353
},
"guard_event": {
"archive_guard_counters": {
"fclose_attempted": 10,
"fclose_dispatched": 10,
"fclose_rejected": 0,
"fopen_attempted": 10,
"fopen_dispatched": 10,
"fopen_rejected": 0,
"fread_attempted": 388,
"fread_dispatched": 388,
"fread_rejected": 0,
"fwrite_attempted": 466,
"fwrite_dispatched": 466,
"fwrite_rejected": 0
},
"archive_guard_loaded": true,
"archive_guard_status": 0,
"call_id": "E5F4CD08-4809-4FED-AF68-CF01D407E112",
"elapsed_ms": 43.01520832814276,
"event": "unzip_end",
"output_bytes": 1890776,
"output_files": 9,
"output_fingerprint_available": true,
"output_sha256": "7043dfcd54c6ce47154feb48b8ff2a19834c5f8cd4c28dabaa012fc96537ed79",
"sdk": "SSZipArchive",
"success": true,
"time": 1794363764.835278
},
"output_digest_equal": true,
"elapsed_delta_ms": 4.484874982153997,
"timing_scope": "单次单机样式解压记录区间,含开始事件观察开销,不含网络及自动化等待,非性能基准"
},
"normal_cache": {
"events": 9,
"cache_hit_types": [
"dict",
"sound",
"style"
],
"unzip_count": 0,
"guard_statuses": [
0
],
"counter_maxima": {
"fclose_attempted": 0,
"fclose_dispatched": 0,
"fclose_rejected": 0,
"fopen_attempted": 0,
"fopen_dispatched": 0,
"fopen_rejected": 0,
"fread_attempted": 0,
"fread_dispatched": 0,
"fread_rejected": 0,
"fwrite_attempted": 0,
"fwrite_dispatched": 0,
"fwrite_rejected": 0
}
},
"existing_defender_during_guard": {
"events": 5,
"detected_events": 0,
"unavailable_events": 0,
"zipzap_counter_maxima": {
"write_attempted": 0,
"write_dispatched": 0,
"close_attempted": 0,
"close_dispatched": 0
}
},
"original_vendor_sdk_unchanged": true,
"observation_container_incident": {
"target": "independent observation bundle only",
"style_backup_files": 9,
"reset_attempt_result": "CoreDevice7000/ActionError3",
"observed": "Documents reinitialized after install/reset sequence; exact trigger not isolated; full container restoration not established",
"subsequent_method": "no directory clearing; observation-only style replay",
"login_and_resource_after_incident": "wordbook UI passed with 0 learned / 7502 unlearned"
},
"automation_failure_record": "guard-v2-cache.xcresult: popup disappeared while XCTest waited; no resource entered; subsequent guard-v2-cache-v2.xcresult passed",
"uncovered": [
"iPhone 受控 GOT 篡改",
"实际系统代码 inline Hook",
"SDK 下载取消及失败传播",
"大包/长时间性能",
"arm64e/PAC 和其他 chained 格式",
"其他 SDK 或非四目标的 I/O",
"生产强制业务门禁",
"完整业务回归及原报告同版本复测"
],
"deferred_by_user": [
"PDF 越界修复",
"完整业务回归",
"报告复测"
],
"guard_package": "test-results/step5-ssziparchive/guard-v2-package",
"baseline_package": "test-results/step5-ssziparchive/baseline-v2-package",
"evidence_directory": "test-results/step5-ssziparchive/final-evidence"
}
@@ -0,0 +1,44 @@
{
"date": "2026-11-11",
"timezone": "Asia/Tokyo",
"status": "business_regression_partially_passed",
"bundle_id": "cn.touchv.iosguard.observe.20261110",
"source_version": "2.156.0",
"user_completed_real_login": true,
"fake_login": false,
"functional_checks": {
"home_resource_detail_and_foreground": "passed",
"epub_content_and_foreground": "passed",
"cold_restart": "passed"
},
"pdf_trial": "failed_existing_array_bounds_exception_reproduced_in_same_build_baseline",
"pdf_exception": "NSRangeException: index 2 beyond bounds [0 .. 1]",
"guard_restored_after_baseline": true,
"zipzap_protected_path_business_coverage": "not_hit",
"protection_expanded": false,
"observation": {
"events": 14,
"detected_event_count": 0,
"unavailable_event_count": 0,
"scan_ms_min": 4.2584583279676735,
"scan_ms_median": 14.205458341166377,
"scan_ms_max": 29.871833336073905,
"counter_maxima": {
"write_attempted": 0,
"write_dispatched": 0,
"close_attempted": 0,
"close_dispatched": 0
},
"scope": "单机小样本,含加固与基线阶段的启动/前台事件,非性能基准"
},
"uncovered": [
"ZipZap 文件输出实际业务命中",
"PDF 正常阅读/翻页",
"下载取消及失败路径",
"支付及第三方 Bundle ID 绑定能力",
"实际 inline Hook",
"原报告同版本厂商复测"
],
"credentials_in_driver_source": false,
"evidence_directory": "test-results/step3/business-run-20261111"
}
@@ -0,0 +1,65 @@
{
"date": "2026-11-11",
"resource": "31单词书(稳操胜券)-勿动",
"bundle_id": "cn.touchv.iosguard.observe.20261110",
"source_version": "2.156.0",
"status": "ssziparchive_boundary_invocation_and_wordbook_smoke_passed",
"checks": {
"home_to_detail": "passed",
"wordbook_ready": "passed",
"learned_words": 0,
"unlearned_words": 7502,
"background_foreground": "passed",
"reentry": "passed",
"reentry_cache_types": [
"style",
"dict",
"sound"
]
},
"archive": {
"begin_count": 1,
"end_count": 1,
"successful_count": 1,
"elapsed_ms": [
12015.23712501512
],
"initial_cached_types": [
"style",
"dict"
],
"fresh_style_dict_extraction": "not_covered",
"initial_unzip_resource_type": "not_recorded_at_sdk_boundary"
},
"security": {
"new_events": 2,
"detected_events": 0,
"unavailable_events": 0,
"counter_maxima": {
"write_attempted": 0,
"write_dispatched": 0,
"close_attempted": 0,
"close_dispatched": 0
}
},
"protection_expanded": false,
"sdk_internal_libc_protection_verified": false,
"deferred_by_user": [
"PDF 数组越界修复",
"完整业务回归",
"报告复测"
],
"driver_adjustments": [
"detail.xcresult: 首页营销弹窗导致不可点击",
"detail-v2.xcresult: 进入详情壳;截图尚在骨架加载",
"read.xcresult: 该商品无开始阅读按钮,入口为稳操胜券课件卡片",
"read-v2.xcresult: 课件卡片进入、就绪及前后台通过",
"reentry.xcresult: 返回重进、缓存及前后台通过"
],
"evidence_directory": "test-results/step4-wordbook/business-run",
"limitations": [
"SDK 调用成功是 SDK 返回值,未逐文件校验输出内容",
"未进入学习/复习或完成学习任务",
"未做故障注入及 SDK 内部 fopen/fwrite 调度加固"
]
}