Files
iOSGuard/docs/06_STATIC_SDK_FOPEN_POC.md
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

6.8 KiB
Raw Permalink Blame History

静态 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。

  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 中执行,脚本失败即停止。

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 中。