在 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>
71 lines
4.0 KiB
Python
71 lines
4.0 KiB
Python
from pathlib import Path
|
|
import os
|
|
import subprocess
|
|
import sys
|
|
import tempfile
|
|
import unittest
|
|
|
|
ROOT=Path(__file__).resolve().parents[1]
|
|
SOURCES=['dispatch/IGDispatch.c','resolve/IGResolve.c','anti_hook/IGAntiHook.c']
|
|
|
|
@unittest.skipUnless(sys.platform=='darwin','需要 Apple 工具链')
|
|
class DispatchTests(unittest.TestCase):
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
cls.tmp=tempfile.TemporaryDirectory()
|
|
cls.exe=Path(cls.tmp.name)/'dispatch-test'
|
|
cls.env=dict(os.environ);cls.env.pop('DYLD_INSERT_LIBRARIES',None)
|
|
p=subprocess.run(['xcrun','--sdk','macosx','clang','-O2','-Wall','-Wextra','-Werror',
|
|
'-DIG_DISPATCH_TESTING','-I',str(ROOT/'defender'),'-I',str(ROOT/'defender/include'),
|
|
str(ROOT/'tests/fixtures/dispatch_host.c'),*(str(ROOT/'defender'/p) for p in SOURCES),
|
|
'-o',str(cls.exe)],capture_output=True,text=True,env=cls.env)
|
|
if p.returncode:raise RuntimeError(p.stderr)
|
|
@classmethod
|
|
def tearDownClass(cls):cls.tmp.cleanup()
|
|
def run_mode(self,mode):
|
|
p=subprocess.run([str(self.exe),mode],capture_output=True,text=True,env=self.env,timeout=30)
|
|
self.assertEqual(p.returncode,0,p.stdout+p.stderr)
|
|
def test_semantics(self):self.run_mode('semantics')
|
|
def test_short_write(self):self.run_mode('short-write')
|
|
def test_eintr(self):self.run_mode('eintr')
|
|
def test_concurrency(self):self.run_mode('threads')
|
|
def test_tamper_rejected(self):self.run_mode('tamper')
|
|
def test_reentry(self):self.run_mode('reentry')
|
|
def test_resolver_errors(self):self.run_mode('resolver')
|
|
def test_prologue_patterns(self):self.run_mode('prologue')
|
|
def test_observation_counters_and_release_exclusion(self):
|
|
exe=Path(self.tmp.name)/'observation'
|
|
r=subprocess.run(['xcrun','--sdk','macosx','clang','-O2','-Wall','-Wextra','-Werror',
|
|
'-DIG_DISPATCH_TESTING','-DIG_OBSERVATION',
|
|
'-I',str(ROOT/'defender'),'-I',str(ROOT/'defender/include'),
|
|
str(ROOT/'tests/fixtures/dispatch_host.c'),*(str(ROOT/'defender'/p) for p in SOURCES),
|
|
'-o',str(exe)],capture_output=True,text=True,env=self.env)
|
|
self.assertEqual(r.returncode,0,r.stderr)
|
|
r=subprocess.run([str(exe),'observation'],capture_output=True,text=True,env=self.env,timeout=30)
|
|
self.assertEqual(r.returncode,0,r.stdout+r.stderr)
|
|
r=subprocess.run(['xcrun','nm',str(self.exe)],capture_output=True,text=True,check=True)
|
|
self.assertNotIn('_ig_dispatch_observation',r.stdout)
|
|
def test_ios_compile(self):
|
|
for i,p in enumerate(SOURCES):
|
|
r=subprocess.run(['xcrun','--sdk','iphoneos','clang','-arch','arm64',
|
|
'-miphoneos-version-min=15.0','-O2','-I',str(ROOT/'defender/include'),
|
|
'-c',str(ROOT/'defender'/p),'-o',str(Path(self.tmp.name)/f'{i}.o')],
|
|
capture_output=True,text=True)
|
|
self.assertEqual(r.returncode,0,r.stderr)
|
|
def test_initialization_failure(self):
|
|
obj=Path(self.tmp.name)/'missing-resolver.o'
|
|
exe=Path(self.tmp.name)/'init-failure'
|
|
r=subprocess.run(['xcrun','--sdk','macosx','clang','-O2','-Ddlsym=ig_fixture_missing_resolve',
|
|
'-I',str(ROOT/'defender/include'),
|
|
'-c',str(ROOT/'defender/resolve/IGResolve.c'),'-o',str(obj)],capture_output=True,text=True)
|
|
self.assertEqual(r.returncode,0,r.stderr)
|
|
r=subprocess.run(['xcrun','--sdk','macosx','clang','-O2','-DIG_DISPATCH_TESTING','-DIG_EXPECT_INIT_FAILURE',
|
|
'-I',str(ROOT/'defender'),'-I',str(ROOT/'defender/include'),
|
|
str(ROOT/'tests/fixtures/dispatch_host.c'),str(ROOT/'defender/dispatch/IGDispatch.c'),
|
|
str(ROOT/'defender/anti_hook/IGAntiHook.c'),str(obj),'-o',str(exe)],capture_output=True,text=True)
|
|
self.assertEqual(r.returncode,0,r.stderr)
|
|
r=subprocess.run([str(exe),'init-failure'],capture_output=True,text=True,timeout=30)
|
|
self.assertEqual(r.returncode,0,r.stdout+r.stderr)
|
|
|
|
if __name__=='__main__':unittest.main()
|