Files
iOSGuard/docs/19_DISPOSITION_CHAIN_DEVICE_VERIFICATION.md
T
shenleiandClaude Opus 4.8 3503a24bd4 test(defender): 处置链真机验证诊断进程 + 构建/执行器(step12)
补齐 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>
2026-11-12 22:43:03 +09:00

8.2 KiB
Raw Blame History

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)的前提,全部满足方可:

  1. R 组反向:D1 返回 0、mask==0、全程无 400/401;D6 启动即 mask==0。——证非越狱设备零毒化。
  2. J 组正向:D2/D3 至少一条命中,D1 返回 1 且 mask!=0。——证越狱抓得住。
  3. 两组一致:D4(恒等)、D5(坏 key)、D6(启动干净)、D7(分级)在两组行为一致。
  4. 灰度:满足 1–3 后,先按 docs/18 §5 只开 observer 打点收线上 reason 分布(确认真实用户群非越狱设备零 STRONG、MEDIUM 不成对),再开毒化。

任一条不过 → 不开毒化,回查探针/分级或环境噪声。


5. 边界(如实声明)

  1. bypass 可规避:Shadow/Liberty 把 svc 之上的 libc hook 掉对本探针无效(已下沉到 svc),但 rootless 越狱改越狱文件位置、或直接 hook svc 返回值仍可能绕过——J 组若装了 bypass 未命中,不代表探针失效,需分别记录「裸越狱命中率」与「带 bypass 命中率」两档。
  2. 诊断进程 ≠ 业务 App:真正的毒化在 readoor epub 解密路径(docs/18 §4),本轮只验探针+毒化原语,业务密钥派生的端到端效果需接入后在 readoor 验。
  3. mask 全 0 概率:毒化熵经 ig_spread 保证非 0,但基线魔数当前明文驻留(硬化 TODO),J 组应顺带确认 strings 能否捞出 0xA5C3F10E7B2D4968,为后续运行期派生留基线。
  4. 真机小样本不推导总体性能;如测扫描耗时,标注单机单次。

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 打点 → 开毒化)。