在 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>
19 KiB
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,HEADff0aee7。 - readoor:
/Users/shenlei/Work/ReadBook/readoor,HEADd640290a,存在用户未提交修改,分析基于当前工作区。 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、窃取数据或绕过支付权限的动态复现。保留机构原始评级用于整改管理,同时把“可见调用关系”“防护缺口”“已复现攻击”分别记录。
对报告修复建议的评估
- 函数指针 +
optnone:可以作为小范围调用隐藏试点,必须检查 Release 机器码和检测机构复测结果。不能直接据此宣称反 Hook 完成。 - 用
dlsym替换全部调用:本报告本身命中_dlsym,全局替换可能转移或增加命中;首期不采用这种通用处理。 - 把 libc 调用改为 SVC 裸系统调用:不作为 App Store 主线方案。报告示例涉及私有调用、固定系统调用号,且出现
PT_DENT_ATTACH拼写;不能作为可直接复制的工程实现。文件操作还需要保持错误码、取消、变参等语义。 - 统一包装函数:只在包装层内部再次直接调用目标函数,可能使扫描命中位置迁移;扫描全 App 时不保证消除命中。
- 注入一个 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 路径时,应明确记录阻塞项和替代路线,不能承诺仅注入防护库即可消除全部报告问题。