补齐 docs/19 的真机 harness,交叉编译通过(iphoneos arm64),待设备执行。 - tests/fixtures/poison_device.m:真机诊断进程。D4–D7 环境无关不变量 (apply恒等/mark坏key/构造期mask=0/策略分级)输出 IG_POISON_CASE 作套件门槛; D1–D3 环境相关(聚合扫描/越狱文件400/沙盒逃逸401)输出 OBS + IG_POISON_ENV 环境判定,供 R/J 组对照判定。只被动探测,不自造越狱文件,每例 ig_poison_init 复位。 - tools/macho_guard/build_poison_device.py:照 hook 版,模块含 poison/policy/ anti_jailbreak,专用 Bundle 前缀 poisonpilot、通配开发 profile 校验、源码快照哈希。 - tools/macho_guard/run_poison_device.py:单相位安装→启动→卸载→证据哈希; --expect clean|jailbroken 自动校验 R 组 jailbroken=no / J 组命中 400/401。 - docs/19 §2/§3/§6 更新为“已建、交叉编译通过、待真机执行”。 全套 63 项宿主/工具测试通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
8.2 KiB
19 · 处置链真机验证协议(poison / policy / 越狱)
承接 17(hook 探针真机正向已完成)与 18(接入方案)。 docs/17 只验了 anti_hook 探针能否命中;本轮补验新增的处置链——越狱探针(400/401)、策略分级、以及最关键的 mask→key 毒化闭环,并把非越狱真机反向零误报作为开毒化的硬门槛。 状态:宿主基线已绿(19/19,
tests/test_poison_policy.py);真机两组待跑(需设备 UDID + 开发签名)。
0. 为什么必须真机,且反向比正向重要
- 宿主(macOS)能验分级逻辑与 mask/apply 算术,但证不了真机上的两件事:① 越狱 svc 直发在 iOS arm64 的真实行为;②
__attribute__((constructor))+ BSS 三副本在真机启动早期的时序(毒化态初始化是否干净)。 - 反向(非越狱设备零毒化)是上线前提:毒化隐蔽且不可逆,误伤正常付费用户=「书打不开」的差评+退款+难排查。所以验收顺序是先反向达标,再谈正向。正向只证「抓得住」,反向证「不误伤」——后者才决定敢不敢在接入点二开毒化。
1. 两组设备
| 组 | 设备 | 目的 | 判定 |
|---|---|---|---|
| R(反向) | 非越狱真机(同 docs/17:iPhone,开发签名,专用 Bundle ID,测后卸载) | 证明干净环境零毒化 | strong_count==0 且 medium_distinct<2 且 ig_poison_mask()==0,全程无 400/401 |
| J(正向) | 越狱设备(rootful 或 rootless 均可,标注越狱方案与 bypass 是否安装) | 证明越狱特征抓得住 | 命中 400(特征文件)与/或 401(沙盒逃逸),ig_policy_scan_and_mark==1,ig_poison_mask()!=0 |
R 组无越狱设备也能先跑(它本就是非越狱);J 组需要一台越狱机。两组用同一个诊断进程,只是环境不同。
2. 诊断进程(复用 docs/17 harness 模式)
诊断进程 tests/fixtures/poison_device.m(已建,模式沿用 hook_device.m),在自身进程内按用例运行真实探针链,逐条 NSLog 证据 + 汇总。构建/执行器为 tools/macho_guard/build_poison_device.py / run_poison_device.py,复用 docs/17 的「安装→运行→卸载→证据哈希」骨架;已交叉编译通过(iphoneos arm64,符号全解析),待真机执行。
输出分两类(见下表):
IG_POISON_CASE:环境无关不变量(D4–D7),构成套件 PASS/FAIL 门槛,两组都必须过。IG_POISON_OBS/IG_POISON_ENV:环境相关观察(D1–D3 + 越狱判定),不写死 PASS/FAIL;由 runner 的--expect clean|jailbroken按 R/J 组校验(R 应jailbroken=no、J 应jailbroken=yes)。
关键:攻击/构造代码只存在于诊断源码,绝不编入业务库。 越狱特征文件的「存在性」在 J 组由设备本身提供(真有 /var/jb、Cydia 等),诊断进程只做被动探测,不自己造越狱文件。
用例表
| # | 用例 | 构造 | 期望(R 非越狱 / J 越狱) |
|---|---|---|---|
| D1 | baseline_clean | 直接 ig_policy_scan_and_mark(bundle,0,obs,_) |
R: 返回 0,mask==0,无 400/401 / J: 返回 1(命中越狱),mask!=0 |
| D2 | jb_file | 默认 ig_anti_jb_check 跑内置越狱特征表 |
R: 0 命中 / J: ≥1 条 400,证据含命中路径 |
| D3 | jb_sandbox | ig_anti_jb_check_paths(…, probe=/private/.ig_jb_probe) |
R: 0 命中(沙盒内创建失败)/ J: 401(能在沙盒外建文件) |
| D4 | poison_identity | 健康态 ig_poison_apply(key,out,n) |
两组同:mask==0 → out==key(恒等,证不误伤解密) |
| D5 | poison_mark_corrupt | 手动 ig_poison_mark(e) 后 apply |
两组同:mask!=0 → out!=key(证毒化真的坏 key) |
| D6 | ctor_clean_start | 进程启动后未 mark 时读 ig_poison_mask() |
两组同:==0(证构造期三副本初始化干净,无启动即毒化) |
| D7 | policy_grades | 喂合成 finding(弱/单 MEDIUM/双 MEDIUM/单 STRONG) | 两组同:弱&单 MEDIUM 不触发,双 MEDIUM&单 STRONG 触发(真机复核分级) |
D4–D7 与宿主自测同构,但要在真机二进制里再跑一遍,排除交叉编译/优化差异。D1–D3 是真机独有(依赖真实 svc + 真实文件系统)。
3. 复现命令(待 fixture 建好后对齐 docs/17)
# 构建(专用 Bundle ID,测后卸载)
python3 tools/macho_guard/build_poison_device.py \
--profile <TouchLinked_dev.mobileprovision> --identity <SHA1> \
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
--output test-results/step12-device-poison/build-<date>
# R 组(非越狱真机):--expect clean 自动校验 jailbroken=no
python3 tools/macho_guard/run_poison_device.py \
--device <UDID_非越狱> --expect clean \
--app test-results/step12-device-poison/build-<date>/IGPoisonPilot.app \
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
--output test-results/step12-device-poison/<date>-R
# J 组(越狱设备):--expect jailbroken 自动校验命中 400/401
python3 tools/macho_guard/run_poison_device.py \
--device <UDID_越狱> --expect jailbroken \
--app test-results/step12-device-poison/build-<date>/IGPoisonPilot.app \
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
--output test-results/step12-device-poison/<date>-J
runner 退出码:D4–D7 不变量全过 且 环境判定与 --expect 一致 → 0,否则 1。证据:
device-verification.json(verdict/不变量用例/观察/环境判定/边界)、console.log(逐条 finding)、
install/launch/uninstall.json、evidence-hashes.json;构建侧 manifest.json 含源码快照哈希。
证据产物(对齐 docs/17 口径):device-verification.json(用例/结论/边界)、console-*.log(逐条 finding)、evidence-hashes.json、构建侧 manifest.json(源码快照哈希)。
4. 验收门槛(硬性)
开接入点二毒化(docs/18 §4)的前提,全部满足方可:
- R 组反向:D1 返回 0、
mask==0、全程无 400/401;D6 启动即mask==0。——证非越狱设备零毒化。 - J 组正向:D2/D3 至少一条命中,D1 返回 1 且
mask!=0。——证越狱抓得住。 - 两组一致:D4(恒等)、D5(坏 key)、D6(启动干净)、D7(分级)在两组行为一致。
- 灰度:满足 1–3 后,先按 docs/18 §5 只开 observer 打点收线上
reason分布(确认真实用户群非越狱设备零 STRONG、MEDIUM 不成对),再开毒化。
任一条不过 → 不开毒化,回查探针/分级或环境噪声。
5. 边界(如实声明)
- bypass 可规避:Shadow/Liberty 把 svc 之上的 libc hook 掉对本探针无效(已下沉到 svc),但 rootless 越狱改越狱文件位置、或直接 hook svc 返回值仍可能绕过——J 组若装了 bypass 未命中,不代表探针失效,需分别记录「裸越狱命中率」与「带 bypass 命中率」两档。
- 诊断进程 ≠ 业务 App:真正的毒化在 readoor epub 解密路径(docs/18 §4),本轮只验探针+毒化原语,业务密钥派生的端到端效果需接入后在 readoor 验。
- mask 全 0 概率:毒化熵经
ig_spread保证非 0,但基线魔数当前明文驻留(硬化 TODO),J 组应顺带确认strings能否捞出0xA5C3F10E7B2D4968,为后续运行期派生留基线。 - 真机小样本不推导总体性能;如测扫描耗时,标注单机单次。
6. 当前进度
- 宿主闭环基线固化并绿灯:
tests/fixtures/poison_host.c+tests/test_poison_policy.py(19/19:poison 7 + policy 8 + jailbreak 4)。 poison_device.m+build_poison_device.py+run_poison_device.py(复用 docs/17 harness);交叉编译通过(iphoneos arm64),待真机执行。- R 组(非越狱真机)跑 D1–D7,
--expect clean,达标 §4.1。 - J 组(越狱设备)跑 D1–D7,
--expect jailbroken,达标 §4.2,分「裸越狱 / 带 bypass」两档记录。 - 达标后进入 docs/18 §5 灰度(observer 打点 → 开毒化)。