test(defender): 固化处置链宿主基线 + 真机验证协议(docs/19),修越狱聚合回归
P0 验真:真机验证前先把「检测→分级→数据毒化」闭环做成可复现宿主绿灯。 新增: - tests/fixtures/poison_host.c + tests/test_poison_policy.py:poison/policy/ anti_jailbreak 闭环自测 19/19(poison 恒等+坏key+不可逆、policy 分级+去重+ mask一致、jailbreak 反向零误报+400+401),集成进 unittest 套件。 - docs/19_DISPOSITION_CHAIN_DEVICE_VERIFICATION.md:真机验证协议——R(非越狱)/ J(越狱)两组、D1–D7 用例、验收门槛(反向零毒化为开毒化前提)、边界与进度。 修复(接越狱探针进 ig_defender_scan 聚合器时埋下的回归): - test_defender_host.py SOURCES 漏 anti_jailbreak/IGAntiJailbreak.c → 链接缺符号。 - defender_host.c:reasons[] 由 256 扩到 512(400/401 越界漏计);clean 断言排除 越狱文件命中(macOS 自带 Unix userland,按 iOS 标准宿主本身即“越狱”,非真实误报)。 全套 63 项宿主/工具测试通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
599e1da5ce
commit
c4c9a6925a
@@ -0,0 +1,103 @@
|
||||
# 19 · 处置链真机验证协议(poison / policy / 越狱)
|
||||
|
||||
> 承接 [17](17_DEVICE_HOOK_POSITIVE_VERIFICATION.md)(hook 探针真机正向已完成)与 [18](18_READOOR_DEFENDER_INTEGRATION.md)(接入方案)。
|
||||
> 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 模式)
|
||||
|
||||
新增 fixture `tests/fixtures/poison_device.m`(**待建**,模式沿用 `hook_device.m`),在自身进程内按用例运行**真实探针链**,逐条 `NSLog` 证据 + 汇总 PASS/FAIL。构建/执行器复用 `tools/macho_guard/build_*_device.py` / `run_*_device.py` 的「安装→运行→卸载→证据哈希」骨架。
|
||||
|
||||
**关键:攻击/构造代码只存在于诊断源码,绝不编入业务库。** 越狱特征文件的「存在性」在 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)
|
||||
|
||||
```bash
|
||||
# 构建(专用 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 组(非越狱真机)
|
||||
python3 tools/macho_guard/run_poison_device.py \
|
||||
--device <UDID_非越狱> --app .../IGPoisonPilot.app \
|
||||
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
|
||||
--output test-results/step12-device-poison/<date>-R
|
||||
|
||||
# J 组(越狱设备)
|
||||
python3 tools/macho_guard/run_poison_device.py \
|
||||
--device <UDID_越狱> --app .../IGPoisonPilot.app \
|
||||
--bundle-id cn.touchv.iosguard.poisonpilot.<date> \
|
||||
--output test-results/step12-device-poison/<date>-J
|
||||
```
|
||||
|
||||
证据产物(对齐 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. 当前进度
|
||||
|
||||
- [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」两档记录。
|
||||
- [ ] 达标后进入 docs/18 §5 灰度(observer 打点 → 开毒化)。
|
||||
Reference in New Issue
Block a user