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>
This commit is contained in:
shenlei
2026-11-12 22:43:03 +09:00
co-authored by Claude Opus 4.8
parent c4c9a6925a
commit 3503a24bd4
4 changed files with 446 additions and 8 deletions
@@ -26,7 +26,11 @@
## 2. 诊断进程(复用 docs/17 harness 模式)
新增 fixture `tests/fixtures/poison_device.m`(**待建**,模式沿用 `hook_device.m`),在自身进程内按用例运行**真实探针链**,逐条 `NSLog` 证据 + 汇总 PASS/FAIL。构建/执行器复用 `tools/macho_guard/build_*_device.py` / `run_*_device.py` 的「安装→运行→卸载→证据哈希」骨架。
诊断进程 `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 等),诊断进程只做被动探测,不自己造越狱文件。
@@ -55,19 +59,25 @@ python3 tools/macho_guard/build_poison_device.py \
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
--output test-results/step12-device-poison/build-<date>
# R 组(非越狱真机)
# R 组(非越狱真机):--expect clean 自动校验 jailbroken=no
python3 tools/macho_guard/run_poison_device.py \
--device <UDID_非越狱> --app .../IGPoisonPilot.app \
--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 组(越狱设备)
# J 组(越狱设备):--expect jailbroken 自动校验命中 400/401
python3 tools/macho_guard/run_poison_device.py \
--device <UDID_越狱> --app .../IGPoisonPilot.app \
--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`(源码快照哈希)。
---
@@ -97,7 +107,7 @@ python3 tools/macho_guard/run_poison_device.py \
## 6. 当前进度
- [x] 宿主闭环基线固化并绿灯:`tests/fixtures/poison_host.c` + `tests/test_poison_policy.py`(19/19:poison 7 + policy 8 + jailbreak 4)。
- [ ] `poison_device.m` + `build/run_poison_device.py`(复用 docs/17 harness)。
- [ ] R 组(非越狱真机)跑 D1–D7,达标 §4.1。
- [ ] J 组(越狱设备)跑 D1–D7,达标 §4.2,分「裸越狱 / 带 bypass」两档记录。
- [x] `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 打点 → 开毒化)。