在 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>
92 lines
6.3 KiB
Markdown
92 lines
6.3 KiB
Markdown
# 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 第三方依赖):
|
||
|
||
```bash
|
||
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`。
|
||
|
||
校验归档完整性(工程根目录):
|
||
|
||
```bash
|
||
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。
|