在 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>
6.8 KiB
静态 SDK fopen 重定向 PoC
日期:2026-11-10。用途:验证无 SDK 源码时的调用转发链路;不代表已经具备完整反 Hook 能力或通过报告复测。
后续扩展:核心实现现已移至 redirect_symbols.py,支持 JSON 多符号映射,桥接扩展至 7 个固定签名函数。本文记录初始 fopen 验证;原 redirect_fopen.py 命令保留兼容,最新用法和范围见 通用重定向工具。
1. 已实现的调用链
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。
- 接受 BSD ar 静态归档,或从 fat 文件提取 arm64 静态归档。
- 检查成员为 little-endian ARM64
MH_OBJECT,遍历LC_SYMTAB。 - 仅将普通外部未定义符号
_fopen的字符串索引改为新增的_IG_fopen名称。保留其他符号索引、section、机器码和重定位数据;更新字符串表长度。 - 重新组装归档,用
ranlib重建索引。输出 JSON 记录成员及输入/输出 SHA-256。 - 写入新文件;拒绝原地覆盖、覆盖已有输出、目标符号冲突或重复处理。任何成员不支持则整个操作失败。
只支持已验证的有限布局:字符串表在对象末尾,允许不超过 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 中执行,脚本失败即停止。
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。真正接入需要单独的目标配置或隔离分支,遵守该仓库开发流程:
- 保留原 iflyMSC 头文件与必要资源,将 arm64 真机配置的链接输入切换为改写归档。
- 将
IGFileBridge.c/.h加入相同 target;桥接文件不参与符号改写,不定义同名系统fopen。 - 同一 target 不同时链接原始 iflyMSC 二进制和改写归档;检查
-framework iflyMSC、Link Binary With Libraries、其他静态依赖及-ObjC/-force_load实际设置,避免重复定义或误链接原版本。 - 检查生成的 Link Map,确认实际选中的归档,以及
_IG_fopen正好由桥接实现提供。仅依赖源码中“已配置”不算接入成功。 - 构建实际 ECNUP Release,回归讯飞录音、语音合成、文件保存及错误恢复,并比较加固前后性能。
- 送同引擎复测。若扫描仍识别包装层的系统引用,应记录失败并调整路线,不能把静态库内
_fopen数量变成零当作整个 App 风险已关闭。
首轮只验证 fopen。syscall 的变参/调用号、exit 的不返回语义均需要独立设计,不能套用当前实现。GOT、IMP、Inline Hook 的实际防护也不包含在本 PoC 中。