harden(poison): 断边原语 IGPoisonInline.h——毒化内联进解密 TU,删掉可 NOP 的调用边

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>
This commit is contained in:
shenlei
2026-11-13 11:25:30 +09:00
co-authored by Claude Opus 4.8
parent e3d2a48d56
commit 2e43ff6da2
8 changed files with 326 additions and 78 deletions
+81
View File
@@ -0,0 +1,81 @@
"""断边原语(docs/18 §7「断边」):IGPoisonInline.h 的 always_inline 核心。
两条验收:
1. 语义等价(host/macosx):内联 mask/apply 与 IGPoison.c 的 out-of-line 公共入口逐例一致,
推荐接入形态 ig_poison_mix_key_inline 健康恒等、毒化扰动。证「单一真源不漂移」。
2. 断边(iphoneos,gate 于 SDK):模拟解密 TU 调用 ig_poison_mix_key_inline,-O2 编译后
反汇编**不含任何 `bl ig_poison_*` 调用边**(原语已内联进调用者),对 ig_pstate 只是
data 引用而非 call——攻击者没有可 NOP 的调用边,毒化揉进 key schedule。
"""
from pathlib import Path
import os
import shutil
import subprocess
import sys
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[1]
@unittest.skipUnless(sys.platform == 'darwin' and shutil.which('xcrun'), '需要 Xcode/macOS')
class PoisonInlineEquivalenceTests(unittest.TestCase):
"""语义等价:内联核心 == 库入口(单一真源)。host 原生跑,不需设备。"""
def test_inline_equals_outofline(self):
env = dict(os.environ)
env.pop('DYLD_INSERT_LIBRARIES', None)
with tempfile.TemporaryDirectory() as d:
exe = Path(d) / 'poison-inline-host'
# 内联核心只依赖 IGPoison.c(定义 ig_pstate + init/mark),无其它 TU 依赖。
args = ['xcrun', '--sdk', 'macosx', 'clang', '-O2', '-Wall', '-Wextra',
'-I', str(ROOT / 'defender/include'), '-I', str(ROOT / 'defender'),
str(ROOT / 'tests/fixtures/poison_inline_host.c'),
str(ROOT / 'defender/poison/IGPoison.c'),
'-o', str(exe)]
b = subprocess.run(args, capture_output=True, text=True, env=env)
self.assertEqual(b.returncode, 0, b.stdout + b.stderr)
r = subprocess.run([str(exe)], capture_output=True, text=True, env=env)
print(r.stdout.strip(), flush=True)
self.assertEqual(r.returncode, 0, r.stdout + r.stderr)
self.assertIn('0 fail', r.stdout)
def have_ios_sdk():
if sys.platform != 'darwin' or not shutil.which('xcrun'):
return False
r = subprocess.run(['xcrun', '--sdk', 'iphoneos', '--show-sdk-path'],
capture_output=True, text=True)
return r.returncode == 0 and r.stdout.strip() != ''
@unittest.skipUnless(have_ios_sdk(), '需要 Xcode + iphoneos SDK')
class PoisonInlineEdgeDeletionTests(unittest.TestCase):
"""断边:接入方内联后反汇编无 `bl ig_poison_*` 调用边。"""
def test_no_call_edge_after_inline(self):
with tempfile.TemporaryDirectory() as d:
obj = Path(d) / 'caller.o'
b = subprocess.run(
['xcrun', '--sdk', 'iphoneos', 'clang', '-arch', 'arm64',
'-miphoneos-version-min=15.0', '-O2',
'-I', str(ROOT / 'defender'), '-I', str(ROOT / 'defender/include'),
'-c', str(ROOT / 'tests/fixtures/poison_inline_caller.c'), '-o', str(obj)],
capture_output=True, text=True)
self.assertEqual(b.returncode, 0, b.stdout + b.stderr)
dis = subprocess.run(['xcrun', '--sdk', 'iphoneos', 'otool', '-tV', str(obj)],
capture_output=True, text=True).stdout
# rd_derive_key 内不得有任何 bl 调用边(原语已 always_inline)。
calls = [ln.strip() for ln in dis.splitlines() if '\tbl\t' in ln]
self.assertEqual(calls, [], f'内联后仍残留调用边:{calls}')
# 且应以 data 引用(非 call)触达 ig_pstate:undefined 符号里有 _ig_pstate。
syms = subprocess.run(['xcrun', '--sdk', 'iphoneos', 'nm', str(obj)],
capture_output=True, text=True).stdout
self.assertIn('_ig_pstate', syms, '未见对 ig_pstate 的数据引用,内联读取可能未生效')
# 符号表里不应把 ig_poison_mask/apply 作为被调用符号引入(无调用边的佐证)。
self.assertNotIn('_ig_poison_mask', syms, '残留对 ig_poison_mask 的符号引用')
self.assertNotIn('_ig_poison_apply', syms, '残留对 ig_poison_apply 的符号引用')
if __name__ == '__main__':
unittest.main()