在 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>
126 lines
6.6 KiB
Python
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()
|