Files
iOSGuard/docs/13_REPRODUCIBLE_BASELINE.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

6.3 KiB
Raw Blame History

13 · 基线固化与可复现验证

日期:2026-11-10。本轮完成基线、自动化测试与静态证据归档,没有修改原 readoor 工程或副本业务代码,也未执行真机测试或向外部检测平台送检。

1. 本轮结果

检查 结果
输入 根目录 appstore.ipa,v2.199.0 / build 2.199.0.3 / com.ecnup.aSCLdl2
主可执行文件 readoor31OtherPay
输入 SHA-256 ddb89e30c2259b45d3f09dbc825e70c4e84c682a3c23510ceb3aa6f93d891771
自研直接分支扫描 43 个 Mach-O,31 个发生改写,878→0
逐指令校验 878 个目标分支保留 BL/B 类型,桥接指向原 GOT 槽;其余 __text 指令保持一致
UUID / 结构 前后 UUID 一致,已记录每个文件及切片;LINKEDIT 偏移检查及 otool -l 解析通过
签名 嵌套 bundle / dylib 从内向外 ad-hoc 签名,逐个 codesign --verify --strict 通过
重打包验证 新 IPA 解包后重新扫描为 0,Mach-O 哈希与打包前一致
自动化测试 28 项通过,未跳过:静态库重定向 15 项、Mach-O 6 项、运行时宿主/交叉编译 7 项
原始输入 归档前后哈希一致

当前输入不是原漏洞报告的同一个包。报告为 v2.197.2 / com.ecnup.azZVz02,其对应 IPA 尚未确认取得。本轮只证明当前 v2.199.0 同版本前后比较成立,不得表述为原报告已通过。

核对最初复制时保存的原工程指纹:讯飞库和 Podfile.lock 一致,原工程 project.pbxproj 已有 SJTU OAuth 业务引用差异。本轮没有写入或回退原工程;差异及观测哈希记录在结果索引中。当前验证以冻结的 IPA 为准,不把持续开发中的原工程当作静止基线。

2. 复现入口

在工程根目录运行(macOS、Xcode、Python 3.11;无需安装 Python 第三方依赖):

python3 tools/macho_guard/verify_baseline.py appstore.ipa \
  --output test-results/verification/new-run

输出目录必须不存在,避免覆盖既有证据。工具会复制输入、冻结相关源码、运行冻结源码的全部测试、解包扫描、仅改写命中文件、逐级签名、逐指令校验及重新打包复扫。遇到命令失败、加密输入、未覆盖架构、空间不足或不一致时中止,已创建目录内记录 status=failed,不能作为通过证据。

复现指相同源码和输入下得到一致的调用点统计及检查结论;ZIP 时间戳、签名和运行地址可能变化,不要求每次输出 IPA 逐字节一致。

3. 证据位置

本次有效归档:test-results/verification/20261110-step1-final/。先前 20261110-appstore-step1/ 是初次运行,仅保留作为过程记录;引用本轮结论以 step1-final 为准。

文件 用途
manifest.json 输入版本/哈希、工具哈希、环境、统计及未完成的验收项
source-snapshot/、source-files.json 当次改写器、静态库工具、Defender、测试及 fixture 的源码快照和哈希;不依赖未提交的 Git 状态
baseline/input.ipa、baseline/unpacked/ 同一个原始输入及解包内容
guarded/guarded.ipa、guarded/unpacked/ 加固输出及打包前内容,供后续静态复测准备使用
before-binaries.json、after-binaries.json 每个 Mach-O 的 SHA-256、切片大小、UUID、段结构、各符号命中数
before-callsites.csv、after-callsites.csv 逐调用点地址、分支类型及符号;加固后为空清单(保留表头)
rewrites.json 每个被改写文件的改写数及符号明细
before-files.json、after-files.json 完整 Payload 文件哈希清单,符号链接单独记录
repacked-binaries.json、repacked-callsites.csv 新 IPA 重新解包后的验证记录
commands.log 实际执行命令、输出及退出码,包括 28 项测试、签名和结构检查
evidence-hashes.json 全部归档文件的校验清单,不含自身

大文件位于 Git 忽略的 test-results/,已保存在本地,不会自动随源码提交。迁移或长期保存应复制整个有效归档目录。小型结果索引保存在 docs/evidence/20261110-step1-summary.json。

校验归档完整性(工程根目录):

python3 - <<'PY'
import hashlib, json, os
from pathlib import Path
root = Path('test-results/verification/20261110-step1-final')
for record in json.loads((root / 'evidence-hashes.json').read_text()):
    path = root / record['path']
    if 'symlink' in record:
        assert path.is_symlink() and os.readlink(path) == record['symlink'], path
    else:
        h = hashlib.sha256()
        with path.open('rb') as f:
            for block in iter(lambda: f.read(1024 * 1024), b''):
                h.update(block)
        assert path.stat().st_size == record['size'] and h.hexdigest() == record['sha256'], path
print('归档校验通过')
PY

4. 新增的测试与拒绝条件

Mach-O 测试由 Apple 链接器生成 iOS arm64 样本,覆盖真实分支改写、原 GOT 地址保留、UUID、重复注入、输入覆盖、架构不支持、截断、加密、header 空间不足及 ZIP 路径逃逸。修正了 LINKEDIT 字段所在命令位于新插入命令前方时,不应统一将字段位置右移 72 字节的问题。

运行时测试只在独立宿主进程中运行:正常环境零告警、缺失符号上报 unavailable、本地函数提供方异常、两个环境变量条目分别上报、加载无害的特征名测试 dylib、真实 GOT 槽改指测试函数后命中 reason=102。另对三个 Defender 模块做 iphoneos/arm64 交叉编译。没有修改系统函数代码,也没有进行 inline Hook 真机验证。

5. 尚未完成的验收

  1. V4.6.6 外部复测:自研扫描规则来自报告示例的推断,878→0 不等于厂商扫描清零。
  2. 开发者身份、entitlements、Provisioning 下的真机安装与业务回归:当前 ad-hoc 结果只用于本地静态验证。
  3. Defender 在 App 启动、回前台的实际调用与正常 SDK 误报检查,以及受控 inline Hook 正向验证。
  4. 原报告对应包及同版本前后厂商复测对照。

后续进入第二步:在 readoor-test 的 readoor31 上核实接入并制作真机观察包,继续使用 ZipZap;不切回已知打包失败的旧 readoor target。