Files
iOSGuard/docs/05_READOOR_SECURITY_REMEDIATION_PLAN.md
T
shenleiandClaude Opus 4.8 599e1da5ce feat(defender): 可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环)
在 iOSGuard 侧产出可集成产物与接入文档,不修改 readoor 代码。

- defender/: anti_hook/anti_frida/anti_debug/anti_jailbreak 探针 + syscall 直发、
  policy 分级层、poison 数据依赖毒化、dispatch/resolve/call_bridge 等子模块
- poison: 三副本冗余、无分支掩码;健康恒等、毒化破坏 key(替代 if-exit 处置)
- policy: STRONG/MEDIUM/WEAK 分级,守误报底线,仅 DETECTED 参与、组合命中才毒化
- anti_jailbreak: IGSyscall 直发 svc 检测越狱文件(400)/沙盒逃逸(401),绕 libc hook
- tools/build_defender_lib.sh: 一键交叉编译打包 libIGDefender.a(arm64) + umbrella 头
- docs/18_READOOR_DEFENDER_INTEGRATION.md: 精确到文件/bridging/替换点/代码片段
- docs/05-17 + evidence + tests + macho_guard/static_sdk_redirect 工具链

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-12 22:16:47 +09:00

19 KiB
Raw Blame History

readoor 漏洞报告分析与 iOSGuard 加固实施方案

日期:2026-11-10。状态:分析与实施设计,尚未实施修复、接入或完成检测机构复测。

后续进展:已实现独立的 静态 SDK fopen 重定向 PoC,并验证讯飞 SDK 副本的符号改写与可重定位链接。通用重定向工具与 readoor31 ZipZap 构建试点 已完成;整改方向结论(检测器判定标准、链接后 Mach-O 改写器选型、升级阶梯)见 09。下文保留最初分析记录;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 业务代码。

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):

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 路径时,应明确记录阻塞项和替代路线,不能承诺仅注入防护库即可消除全部报告问题。