在 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>
11 KiB
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/单词书下载解压链为:
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 保护试点,证据在 test-results/step5-ssziparchive/。PDF 修复、完整回归和报告复测仍暂缓。