Files
iOSGuard/docs/19_DISPOSITION_CHAIN_DEVICE_VERIFICATION.md
shenleiandClaude Opus 4.8 1094cc2760 test(anti_tamper): IGAntiTamper 真机正反双向验证达标(D9,iPhone 16 Plus 非越狱)
poison_device.m 加 D9a–d 四条环境无关不变量 + csops_status/501 两条观察,
复用 build/run_poison_device harness。实测(verdict PASS,不变量 9/9):
- 误报底线:expect_*=0 → 零 DETECTED,对应 finding UNAVAILABLE
- cryptid 真读主镜像:expect=1 → reason500=1(dev 包 cryptid==0),mh=0x104390000
- 整入口贯通:ig_anti_tamper_check(1,1) → 500 + 501
- csops 真机活性:rc=0 status=0x22003305 valid=1 adhoc=0 get_task_allow=1
  (坐实 csops 在 iOS arm64 活着,排除 501 假阴性)

残留缺口(只能在真 App Store/TestFlight 包验):cryptid==1 正向 CLEAR +
分发签名零误触——dev profile 无法复现 FairPlay 加密/分发签名。docs/18 §7.7、docs/19 §6。
证据 test-results/step12-device-poison/20261113-antitamper-R/(gitignore)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 12:14:37 +09:00

12 KiB
Raw Permalink 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 触发(真机复核分级)
D8 svc_access_live 自身沙盒 Documents 建真实可访问文件,喂 ig_anti_jb_check_paths 两组同:命中 400(证 svc 直发 access 在真机 iOS arm64 能命中,无需越狱即排除「探针静默失败」假阴性)
D9a at_cryptid_expect0_clean ig_tamper_scan_cryptid(mh, expect_encrypted=0) 两组同:零 DETECTED(非分发构建跳过=误报底线,dev 包不误触)
D9b at_cryptid_expect1_detects ig_tamper_scan_cryptid(mh, expect_encrypted=1) 两组同:命中 500(dev 包无 FairPlay 加密 cryptid==0;证探针真读到进程主镜像头,非空转)
D9c at_tamper_gated_off ig_anti_tamper_check(0,0) 整入口 两组同:零 DETECTED(两检查都 expect=0 → 全 UNAVAILABLE,误报底线贯整入口)
D9d at_tamper_on_detects ig_anti_tamper_check(1,1) 整入口 两组同:≥1 DETECTED 且含 500(整入口真机贯通;dev 包另命中 501 get-task-allow,见观察 csops_status)

D4–D7 与宿主自测同构,但要在真机二进制里再跑一遍,排除交叉编译/优化差异。D1–D3 是真机独有(依赖真实 svc + 真实文件系统)。

D8 的价值(无越狱设备时尤其关键):R 组 D2 的 400=0 单看无法区分「没有越狱文件」与「svc 直发在 iOS 上静默失败、永远返回 0」两种情况——后者是致命假阴性。D8 用自身沙盒内一个真实可访问的文件喂同一条 svc-access 路径,命中即证明检测机制在真机 iOS arm64 上是活的。它不能替代 J 组(证不了真实越狱文件/401 沙盒逃逸),但把「探针是否工作」这一层从 J 组依赖里剥离出来,在没有越狱设备时仍可闭合。


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 组达标(2026-11-13):iPhone 16 Plus(iPhone17,4,非越狱,TouchLinked_dev 通配 profile,专用 BID cn.touchv.iosguard.poisonpilot.20261113c,测后卸载)。run_poison_device.py --expect clean → verdict PASS,不变量 5/5。
    • D6 ctor_clean_start:mask=0x0(启动即健康)✓
    • D4 poison_identity ✓;D5 poison_mark_corrupt ✓
    • D7 policy_grades:weak=0 single_medium=0 two_medium=1 single_strong=1(真机分级一致)✓
    • D8 svc_access_live:accessible_file_hits=1(svc 直发 access 在真机 iOS arm64 实测能命中 400,排除 D2 假阴性)✓
    • D1 baseline_scan:triggered=0 mask=0x0(非越狱聚合扫描零毒化 — §4.1 核心反向门槛)✓
    • D2/D3:reason400=0 reason401=0,jailbroken=no ✓
    • 证据:test-results/step12-device-poison/20261113-R-final/(gitignore,不进库)。
  • IGAntiTamper 真机正反双向达标(2026-11-13):同机(iPhone 16 Plus,非越狱,专用 BID cn.touchv.iosguard.poisonpilot.antitamper,测后卸载)。run_poison_device.py --expect clean → verdict PASS,不变量 9/9(原 5 + 新 D9a–d 4)。
    • D9a/D9c(误报底线):expect_*=0 → 零 DETECTED,对应 finding 为 UNAVAILABLE(dev 包不误触)✓
    • D9b:hits=1 reason500=1 mh=0x104390000(cryptid 探针真读进程主镜像头,dev 包 cryptid==0 命中 500;证非空转)✓
    • D9d:hits=2 reason500=1 reason501=1(整入口贯通:cryptid 500 + csops get-task-allow 501)✓
    • csops_status 观察:rc=0 status=0x22003305 valid=1 adhoc=0 get_task_allow=1——坐实 csops 在真机 iOS arm64 活着(CS_VALID 置位、非 ad-hoc、dev 包带 get-task-allow),排除「csops 静默失败=501 假阴性」。
    • 证据:test-results/step12-device-poison/20261113-antitamper-R/(gitignore,不进库)。
    • 残留缺口(分发包侧,只能在真 App Store 包验):cryptid==1 的正向 CLEAR、分发签名下 501 零误触——dev profile 无法复现 FairPlay 加密/分发签名,待 TestFlight/App Store 构建侧补验。
  • J 组无法执行(环境天花板:无越狱设备)。残留缺口仅剩两项,均只能在越狱机证:① 真实越狱特征文件命中 400;② 沙盒逃逸 401。 已有替代证据把缺口收窄到最小:D8 已证 svc-access 检测机制在真机活跃(命中逻辑真机可工作),R 组已证反向零误报。即「机制能命中 + 非越狱不误报」在真机成立,唯独缺「真越狱环境里的端到端正向」——补一台越狱机 --expect jailbroken 即可闭合,harness 现成。
  • 达标后进入 docs/18 §5 灰度(observer 打点 → 开毒化)。