feat(defender): 运行时防护库 + readoor 接入(检测→分级→数据毒化)+ §7 硬化与二进制完整性探针 #1

Open
4v5u09Z5a4Yuc wants to merge 11 commits from feat/defender-integration into main
Owner

iOSGuard 运行时防护:可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环),含本轮抗静态分析硬化与二进制完整性探针。

核心

  • 可集成静态库(defender/):探针/处置分离,纯 C 无 ObjC/Swift 依赖;聚合入口 ig_defender_scan。探针只采证经 sink 上报、不自行 exit,判级交 policy。
  • 处置=数据依赖毒化(非 if(jb)exit()):检测污染多副本健康值→喂进 epub 解密 key 派生;健康→key 不变→正常解密,毒化→乱码。收敛、无随机崩溃,适配 App Store 上架。
  • 真机验证:非越狱 iPhone 16 Plus 反向零毒化达标(docs/19);step11 真机 HOOK 11/11 正向命中(docs/17)。

本轮硬化(§7)

  • 符号隐藏 + 完整 strip;越狱/注入路径串 XOR 混淆(运行期解码擦除);毒化副本改匿名数组分散(修命名段挂牌泄漏,对抗自验揪出);基线魔数运行期派生。
  • 断边原语 IGPoisonInline.h:毒化 always_inline 进解密 TU,-O2 后零 bl ig_poison_* 调用边,消除可 NOP 的调用点。
  • 二进制完整性探针 IGAntiTamper(新增):cryptid(reason 500)+ csops 代码签名(reason 501),正面反制「脱壳解密→patch→重签」破解链;按构建上下文开关(dev/诊断 UNAVAILABLE)严防误报,不并入聚合入口以免破坏现有调用方。

验证

  • 宿主全量 73 测试通过;iphoneos arm64 交叉编译通过。
  • 误报底线:非越狱设备零 STRONG、anti_tamper dev 构建零 DETECTED。

待续(不阻塞本 PR)

  • readoor 解密 TU 真正挂 ig_poison_mix_key_inline(需 readoor 工程 + xcodebuild)。
  • 设备 wedge 恢复后:按钮级回归、csops + 真实主镜像 cryptid 正向验证。
  • §7.3 OLLVM/VMP(需额外工具链)、§7.5 越狱设备正向验证(无设备)。

🤖 Generated with Claude Code

iOSGuard 运行时防护:可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环),含本轮抗静态分析硬化与二进制完整性探针。 ## 核心 - **可集成静态库**(defender/):探针/处置分离,纯 C 无 ObjC/Swift 依赖;聚合入口 `ig_defender_scan`。探针只采证经 sink 上报、不自行 exit,判级交 policy。 - **处置=数据依赖毒化**(非 `if(jb)exit()`):检测污染多副本健康值→喂进 epub 解密 key 派生;健康→key 不变→正常解密,毒化→乱码。收敛、无随机崩溃,适配 App Store 上架。 - **真机验证**:非越狱 iPhone 16 Plus 反向零毒化达标(docs/19);step11 真机 HOOK 11/11 正向命中(docs/17)。 ## 本轮硬化(§7) - 符号隐藏 + 完整 strip;越狱/注入路径串 XOR 混淆(运行期解码擦除);毒化副本改匿名数组分散(修命名段挂牌泄漏,对抗自验揪出);基线魔数运行期派生。 - **断边原语** `IGPoisonInline.h`:毒化 always_inline 进解密 TU,-O2 后零 `bl ig_poison_*` 调用边,消除可 NOP 的调用点。 - **二进制完整性探针 `IGAntiTamper`**(新增):cryptid(reason 500)+ csops 代码签名(reason 501),正面反制「脱壳解密→patch→重签」破解链;按构建上下文开关(dev/诊断 UNAVAILABLE)严防误报,不并入聚合入口以免破坏现有调用方。 ## 验证 - 宿主全量 73 测试通过;iphoneos arm64 交叉编译通过。 - 误报底线:非越狱设备零 STRONG、anti_tamper dev 构建零 DETECTED。 ## 待续(不阻塞本 PR) - readoor 解密 TU 真正挂 `ig_poison_mix_key_inline`(需 readoor 工程 + xcodebuild)。 - 设备 wedge 恢复后:按钮级回归、csops + 真实主镜像 cryptid 正向验证。 - §7.3 OLLVM/VMP(需额外工具链)、§7.5 越狱设备正向验证(无设备)。 🤖 Generated with [Claude Code](https://claude.com/claude-code)
4v5u09Z5a4Yuc added 10 commits 2026-11-13 10:58:51 +08:00
在 iOSGuard 侧产出可集成产物与接入文档,不修改 readoor 代码。

- defender/: anti_hook/anti_frida/anti_debug/anti_jailbreak 探针 + syscall 直发、
  policy 分级层、poison 数据依赖毒化、dispatch/resolve/call_bridge 等子模块
- poison: 三副本冗余、无分支掩码;健康恒等、毒化破坏 key(替代 if-exit 处置)
- policy: STRONG/MEDIUM/WEAK 分级,守误报底线,仅 DETECTED 参与、组合命中才毒化
- anti_jailbreak: IGSyscall 直发 svc 检测越狱文件(400)/沙盒逃逸(401),绕 libc hook
- tools/build_defender_lib.sh: 一键交叉编译打包 libIGDefender.a(arm64) + umbrella 头
- docs/18_READOOR_DEFENDER_INTEGRATION.md: 精确到文件/bridging/替换点/代码片段
- docs/05-17 + evidence + tests + macho_guard/static_sdk_redirect 工具链

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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>
补齐 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>
在连接的 iPhone 16 Plus(iPhone17,4,非越狱)实跑处置链真机验证:
run_poison_device.py --expect clean → verdict PASS。
- D4–D7 不变量 4/4:构造期 mask=0x0、apply 恒等、mark 坏 key、分级一致。
- D1 baseline_scan triggered=0 mask=0x0:非越狱聚合扫描零毒化(§4.1 核心反向门槛)。
- D2/D3 越狱探针 400=0 401=0,jailbroken=no。
证据存 test-results/step12-device-poison/20261113-R/(gitignore,不进库)。

J 组待跑:当前无越狱设备在线;harness 现成,补一台越狱机即可证正向命中 400/401。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
无越狱设备下 J 组真实越狱文件命中无法证;但 R 组 D2 的 400=0 单看无法区分
「无越狱文件」与「svc 直发在 iOS 静默失败恒返 0」的致命假阴性。

- poison_device.m 加 D8 svc_access_live:自身沙盒建真实可访问文件喂
  ig_anti_jb_check_paths,命中即证 svc #0x80 access(2) 在真机 iOS arm64 能工作。
- iPhone 16 Plus(非越狱)实测:verdict PASS,不变量 5/5,D8 accessible_file_hits=1。
  坐实 D2 的 0 命中是真阴性(无越狱文件)而非探针坏;聚合扫描 mask=0x0 零毒化。
- docs/19 §2 补 D8 用例与价值说明,§6 记 R 组达标、J 组环境天花板与残留缺口收窄。

至此无越狱设备下的最大可得验证完成:机制真机可命中 + 非越狱零误报。
残留仅「真越狱环境端到端正向(400真文件/401沙盒逃逸)」,补越狱机即闭合。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
开毒化前的线上体检:实验室真机证了不误报,但线上几十万台各机型/系统,
先只打点、不毒化,用真实用户群量误报率,达标再开接入点二。

- A.1 C→Swift 桥接要点:@convention(c) 闭包不能捕获,状态经 observer_ctx
  (Unmanaged 指针)传入;只读 status/reason 打点,不碰 subject/evidence 字符串
  (省桥接 + 合规不输出路径)。
- A.2 RDDefenderObserver.swift 骨架:按 reason 聚合 DETECTED 计数,statLine
  只含 reason 枚举与计数(不含 Token/手机号/用户ID/订单号/路径)。
- A.3 接 RDSecurityGuard.evaluate:灰度期与现逻辑并行加一行 observeWithDefender,
  铁律——不调 ig_poison_apply、不 exit、不改业务;triggered 只进日志。
- A.4 判读与退出条件:STRONG 非越狱出现率≈0、MEDIUM 不成对、triggered 占比可解释
  三项达标 → 按 §4 开毒化。§5 加指向附录的交叉引用。

基于 readoor 现版 evaluate(event:) 与 RDOSLogManager.logStat/logInfo 实签名;
不碰 readoor 工程,落地须走其 Skill 流程 + xcodebuild。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
针对「纯客户端抗静态分析」的最高性价比项落地,守在 tests/test_static_hardening.py(6 条,gate 于 iphoneos SDK):

- 符号隐藏 + strip(§7.0 新增):IGVisibility.h 定 IG_INTERNAL=hidden,全库
  -fvisibility=hidden;仅四入口 ig_defender_scan/ig_poison_init/ig_poison_apply/
  ig_policy_scan_and_mark 标 IG_PUBLIC 保持导出,其余 ig_* 变 private external,
  链接后 strip -x 彻底消失——攻击者 nm 不再能按名定位 ig_poison_mark/mask 去 NOP。
- §7.1 串混淆:gen_jb_paths.py(唯一真源)生成 IGJailbreakPaths.inc /
  IGInjectSignatures.inc(XOR keystream,两表不共享 key),运行期解码进栈、用完擦除;
  decode 内 volatile key 屏障阻止 -O2 把常量折叠回 __const 明文。strings 已捞不到
  /var/jb、Cydia、substrate、gum-js-loop 等。--check 守 .inc 与清单同步。
- §7.2 副本分散:g_h0/h1/h2 置于不相邻命名段 __DATA,__ig_p0/p1/p2,加 __ig_pd 诱饵
  (mask 不读);刻意不用 TLS(会破坏跨线程毒化一致性)。
- §7.4 基线派生:删硬编码 0xA5C3F10E7B2D4968,改 ig_poison_baseline() 由拆分种子经
  volatile 屏障派生;otool -tV 已无旧魔数立即数。
- §7.3 OLLVM/VMP:仅留 build 的 IG_OBFUSCATOR hook,stock clang 无能力,需另备工具链(未完成)。
- §7.5 越狱设备正向验证仍阻塞(无设备)。

构建/快照同步:build_defender_lib.sh 加 -fvisibility=hidden + gen --check + IG_OBFUSCATOR
hook;build_poison_device.py 快照纳入 *.inc。全量 69 测试通过;poison_device.m 全模块
iphoneos 交叉编译通过(arm64)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
对「链接+strip 的宿主」做攻击者视角自验(nm/otool -l/-tV/strings),揪出上一版
§7.2 的反效果设计:三副本用自定义命名段 __DATA,__ig_p0/p1/p2/pd,而命名段原样留在
Mach-O load command、strip 也抹不掉——otool -l | grep __ig_p 一把定位毒化副本位置,
比匿名 BSS 更糟(等于在 header 上挂牌)。

修法:三真副本+诱饵散进一个匿名数组 g_state[12] 的非相邻下标(IG_LANE={2,7,11}、
IG_DECOY=5,其余陪衬槽),全进匿名 __bss/__data;每槽存 baseline^lane_k(i) 使各槽值
互不相同,消除「数组里几个相同的字=一组健康值」的静态 tell;mask 只读三真副本。
mask 语义不变(健康→0,毒化→非0,无分支),毒化语义测试全过。

回归守卫:tests/test_static_hardening.py 新增 test_no_telegraphing_sections,
守 .a 不再出现 __ig_/__poison 等泄漏性命名段。

另记录自验第二发现(已写进 docs/18 §7.0):四个 public 入口名 _ig_poison_* 的字样
本身泄露用途,strip -x 抹不掉,须 readoor Release 用完整 strip(style=all) 或接入层包中性名。

设备 poison_device.m 全模块 iphoneos 交叉编译 arm64 通过;全量 70 测试通过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
docs/18 §7「断边」:符号隐藏只抹掉节点名字,调用图的边 bl ig_poison_apply/mask 仍在、
可被攻击者 NOP 或把被调函数 stub 成恒等。本提交提供能内联进接入方解密 TU 的 always_inline 核心。

- defender/poison/IGPoisonInline.h(单一真源):把「读健康值→推掩码→扰动密钥」做成
  always_inline。接入方在解密 TU #include 后调用 ig_poison_mix_key_inline(key,n),编译器
  把这段揉进解密函数自身——反汇编里没有 bl ig_poison_* 调用边可 NOP,毒化藏进 key schedule
  (比后置改输出更难摘)。推荐形态:扰动 key 派生(健康→key 不变→正常解密;毒化→乱码)。
- 跨 TU 唯一共享的是数据 ig_pstate[](中性名、hidden、strip 后无符号名),是 data 重定位
  非调用边。
- IGPoison.c 重构为复用该头的 core(baseline/lane_k/spread/mask/apply 只此一处定义),
  库 out-of-line 入口与接入方内联路径语义等价、永不漂移;g_state 改名 ig_pstate 并提升为
  hidden 全局供跨 TU 内联直读。IGVisibility.h 加 IG_ALWAYS_INLINE。

验证(tests/test_poison_inline.py,+2):
- test_inline_equals_outofline(host/macosx):内联 mask/apply == 库入口,mix_key 健康恒等、
  毒化扰动,逐例 0 fail。
- test_no_call_edge_after_inline(iphoneos,gate SDK):模拟解密 TU rd_derive_key 调用
  mix_key,-O2 反汇编断言零 bl、仅对 ig_pstate 的 data 引用,无 ig_poison_mask/apply 符号引用。

全量 72 测试通过;poison_device.m 全模块 iphoneos 交叉编译 arm64 通过。docs/18 §7 补 7.6 接入形态。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
补 anti_hook 只盯固定函数之外的空洞,正面反制 App Store 标准破解链
(脱壳解密→patch→重签):
- FairPlay cryptid(reason=500):cryptid==0 或 LC_ENCRYPTION_INFO 被剥除=脱壳/重打包
- 代码签名 csops CS_OPS_STATUS(reason=501):CS_VALID 失效/ad-hoc 重签/分发包带 get-task-allow

误报底线:两条均按 expect_encrypted/expect_distribution 构建上下文开关,
dev/诊断/TestFlight 传 0→UNAVAILABLE,绝不在非分发构建误报。作为独立探针
由 Swift 策略层/observer 带构建上下文单独调用,不并入 ig_defender_scan(不破坏现有签名)。

回归:tests/test_anti_tamper.py 合成 Mach-O 头跑 cryptid 核心五例(加密正常/脱壳/
剥除/非分发跳过/NULL);模块接入 poison_host 与 device 链接列表。全量 73 过,
iphoneos arm64 交叉编译通过。csops+真实主镜像验证待设备。docs/18 §7.7。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4v5u09Z5a4Yuc added 1 commit 2026-11-13 11:15:02 +08:00
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>
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/defender-integration:feat/defender-integration
git checkout feat/defender-integration
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: 4v5u09Z5a4Yuc/iOSGuard#1