Files
iOSGuard/tests/test_archive_guard.py
T
shenleiandClaude Opus 4.8 599e1da5ce feat(defender): 可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环)
在 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>
2026-11-12 22:16:47 +09:00

126 lines
6.6 KiB
Python

import hashlib
from pathlib import Path
import os
import platform
import struct
import subprocess
import sys
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT/'tools/macho_guard'))
from redirect_framework_imports import rewrite, DEPENDENCY
from machox import Macho, LC_DYLD_CHAINED_FIXUPS
SDK = ROOT/'readoor-test/readoor/BookShelf/Classes/Factorys/SSZipArchive/SSZipArchive.framework/SSZipArchive'
SHA = '485c0c95b4701a4e51625e16b6c2a9781c1a8a6f6c9b9cbe392709ecfc95191a'
@unittest.skipUnless(SDK.exists(), '需要已审核 SDK 副本')
class FrameworkRewriteTests(unittest.TestCase):
def setUp(self): self.data = SDK.read_bytes()
def rejected(self, data):
with self.assertRaises((ValueError, struct.error)):
rewrite(data, hashlib.sha256(data).hexdigest())
def test_real_sdk(self):
data, report = rewrite(self.data, SHA)
self.assertEqual(len(data), len(self.data))
self.assertEqual(len(report['changes']), 8)
self.assertTrue(report['machine_code_unchanged'])
self.assertIn(DEPENDENCY.encode(), data[:32768])
m = Macho(data)
self.assertEqual(m.ncmds, Macho(self.data).ncmds+1)
self.assertEqual(data[32768:212992], self.data[32768:212992])
def test_wrong_hash(self):
with self.assertRaises(ValueError): rewrite(self.data, '0'*64)
def test_repeat_rejected(self):
data, _ = rewrite(self.data, SHA); self.rejected(data)
def test_no_padding(self):
data = bytearray(self.data); data[32+Macho(data).sizeofcmds] = 1; self.rejected(data)
def test_unsupported_import_format(self):
data = bytearray(self.data); m = Macho(data)
off = next(o for c,_,o in m.cmds if c == LC_DYLD_CHAINED_FIXUPS)
fixoff = struct.unpack_from('<I',data,off+8)[0]
struct.pack_into('<I',data,fixoff+20,3); self.rejected(data)
def test_wrong_provider_and_weak(self):
m = Macho(self.data); off = next(o for c,_,o in m.cmds if c == LC_DYLD_CHAINED_FIXUPS)
fixoff = struct.unpack_from('<I',self.data,off+8)[0]
imports = struct.unpack_from('<I',self.data,fixoff+8)[0]
for mask in (0x100, 1):
with self.subTest(mask=mask):
data = bytearray(self.data); pos = fixoff+imports+43*4
word = struct.unpack_from('<I',data,pos)[0]
struct.pack_into('<I',data,pos,word^mask); self.rejected(data)
def test_truncated(self): self.rejected(self.data[:3000])
@unittest.skipUnless(sys.platform == 'darwin', '需要 Apple 工具链')
class ArchiveABITests(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.tmp = tempfile.TemporaryDirectory(); cls.exe = Path(cls.tmp.name)/'archive-host'
cls.env = dict(os.environ); cls.env.pop('DYLD_INSERT_LIBRARIES',None)
cls.sources = [str(ROOT/'defender'/s) for s in
('dispatch/IGArchiveGuard.c','resolve/IGResolve.c','anti_hook/IGAntiHook.c')]
command = ['xcrun','--sdk','macosx','clang','-O2','-Wall','-Wextra','-Werror',
'-DIG_ARCHIVE_TESTING','-DIG_OBSERVATION','-I',str(ROOT/'defender'),
'-I',str(ROOT/'defender/include'),str(ROOT/'tests/fixtures/archive_host.c'),
*cls.sources,'-o',str(cls.exe)]
r = subprocess.run(command,capture_output=True,text=True,env=cls.env)
if r.returncode: raise RuntimeError(r.stderr)
@classmethod
def tearDownClass(cls): cls.tmp.cleanup()
def run_mode(self,mode):
r = subprocess.run([self.exe,mode],capture_output=True,text=True,env=self.env,timeout=30)
self.assertEqual(r.returncode,0,r.stdout+r.stderr)
def test_stdio_semantics(self): self.run_mode('semantics')
def test_concurrent_initialization(self): self.run_mode('threads')
def test_tamper_refuses_before_call(self): self.run_mode('tamper')
def test_reentry(self): self.run_mode('reentry')
def test_read_write_close_reject(self): self.run_mode('rejection')
def test_release_has_no_test_or_observation_api(self):
output = Path(self.tmp.name)/'release.dylib'
r = subprocess.run(['xcrun','--sdk','iphoneos','clang','-arch','arm64',
'-miphoneos-version-min=15.0','-O2','-fvisibility=hidden','-dynamiclib',
'-I',str(ROOT/'defender'),'-I',str(ROOT/'defender/include'),*self.sources,
'-o',str(output)],capture_output=True,text=True)
self.assertEqual(r.returncode,0,r.stderr)
nm = subprocess.run(['xcrun','nm','-g',output],capture_output=True,text=True,check=True).stdout
self.assertNotIn('ig_archive_test_',nm); self.assertNotIn('_ig_archive_counter',nm)
@unittest.skipUnless(sys.platform == 'darwin' and platform.machine() == 'arm64', '需要 Apple Silicon')
class ArchiveBindingIntegrationTests(unittest.TestCase):
def test_real_dyld_binding_and_got_tamper(self):
with tempfile.TemporaryDirectory() as folder:
root = Path(folder)
guard = root/'IGArchiveGuard.framework/IGArchiveGuard'
sdk = root/'SSZipArchive.framework/SSZipArchive'
guard.parent.mkdir(); sdk.parent.mkdir()
common = ['xcrun','--sdk','macosx','clang','-arch','arm64','-mmacosx-version-min=13.0','-O2']
env = dict(os.environ); env.pop('DYLD_INSERT_LIBRARIES',None)
def command(args):
r = subprocess.run(args,capture_output=True,text=True,env=env,timeout=40)
self.assertEqual(r.returncode,0,r.stdout+r.stderr)
return r
command(common+['-dynamiclib','-DIG_OBSERVATION','-fvisibility=hidden',
'-I',str(ROOT/'defender'),'-I',str(ROOT/'defender/include'),
*(str(ROOT/'defender'/s) for s in
('dispatch/IGArchiveGuard.c','resolve/IGResolve.c','anti_hook/IGAntiHook.c')),
'-Wl,-install_name,'+DEPENDENCY,'-o',str(guard)])
command(common+['-dynamiclib',str(ROOT/'tests/fixtures/archive_sdk.c'),
'-Wl,-install_name,@rpath/SSZipArchive.framework/SSZipArchive',
'-Wl,-headerpad,0x4000','-Wl,-rpath,@loader_path/..','-o',str(sdk)])
data = sdk.read_bytes(); changed, _ = rewrite(data,hashlib.sha256(data).hexdigest())
sdk.write_bytes(changed)
command(['codesign','--force','--sign','-',str(guard)])
command(['codesign','--force','--sign','-',str(sdk)])
exe = root/'binding-test'
command(common+[str(ROOT/'tests/fixtures/archive_binding_host.c'),'-o',str(exe)])
result = command([str(exe),str(sdk),str(root/'stdio.bin')])
self.assertIn('均通过',result.stdout)
if __name__ == '__main__': unittest.main()