在 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>
303 lines
14 KiB
Python
303 lines
14 KiB
Python
#!/usr/bin/env python3
|
|
"""同一 IPA 加固前后证据归档。仅作本地规则/结构验证,不代表厂商复测或真机验收。"""
|
|
import argparse
|
|
import csv
|
|
from datetime import datetime, timezone
|
|
import hashlib
|
|
import json
|
|
import os
|
|
from pathlib import Path
|
|
import platform
|
|
import plistlib
|
|
import shutil
|
|
import stat
|
|
import struct
|
|
import subprocess
|
|
import sys
|
|
import zipfile
|
|
|
|
import batch
|
|
from machox import Macho
|
|
import macho_guard
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
|
|
|
|
def digest(path):
|
|
h = hashlib.sha256()
|
|
with open(path, 'rb') as f:
|
|
for block in iter(lambda: f.read(1024*1024), b''):
|
|
h.update(block)
|
|
return h.hexdigest()
|
|
|
|
|
|
def save(path, data):
|
|
path.write_text(json.dumps(data, ensure_ascii=False, indent=2)+'\n')
|
|
|
|
|
|
def validate_zip(path):
|
|
"""ditto 解包前检查路径与符号链接,避免归档逃逸;拒绝重复条目。"""
|
|
with zipfile.ZipFile(path) as z:
|
|
seen = set()
|
|
for info in z.infolist():
|
|
p = Path(info.filename)
|
|
if p.is_absolute() or '..' in p.parts or info.filename in seen:
|
|
raise ValueError(f'不安全或重复的 ZIP 路径: {info.filename}')
|
|
seen.add(info.filename)
|
|
if stat.S_ISLNK(info.external_attr >> 16):
|
|
target = z.read(info).decode()
|
|
resolved = os.path.normpath(str(p.parent / target))
|
|
if Path(target).is_absolute() or resolved == '..' or resolved.startswith('../'):
|
|
raise ValueError(f'ZIP 符号链接逃逸: {p}')
|
|
bad = z.testzip()
|
|
if bad:
|
|
raise ValueError(f'ZIP CRC 失败: {bad}')
|
|
|
|
|
|
def inventory(folder):
|
|
result = []
|
|
for path in sorted(folder.rglob('*')):
|
|
rel = str(path.relative_to(folder))
|
|
if path.is_symlink():
|
|
result.append(dict(path=rel, symlink=os.readlink(path)))
|
|
elif path.is_file():
|
|
result.append(dict(path=rel, size=path.stat().st_size, sha256=digest(path)))
|
|
return result
|
|
|
|
|
|
def inspect_binary(path):
|
|
data = path.read_bytes()
|
|
slices = batch.arm64_slices(data)
|
|
if not slices:
|
|
raise ValueError(f'发现未覆盖的 Mach-O 架构: {path}')
|
|
if data[:4] == b'\xca\xfe\xba\xbe' and struct.unpack_from('>I',data,4)[0] != len(slices):
|
|
raise ValueError(f'fat 包含未覆盖的架构,拒绝按全覆盖验收: {path}')
|
|
results, sites = [], []
|
|
for base, size in slices:
|
|
if base+size > len(data):
|
|
raise ValueError(f'fat 切片越界: {path}')
|
|
m = Macho(data[base:base+size])
|
|
le = m.segs['__LINKEDIT']
|
|
for label, _, offset in m.linkedit_pointers():
|
|
if not le['fileoff'] <= offset < le['fileoff']+le['filesize']:
|
|
raise ValueError(f'{path}: {label} 不在 __LINKEDIT')
|
|
view = batch.Slice(data[base:base+size], 0)
|
|
uuid = None
|
|
for cmd, cmdsize, off in m.cmds:
|
|
if cmd == 0x1b:
|
|
import uuid as uuid_module
|
|
uuid = str(uuid_module.UUID(bytes=bytes(m.d[off+8:off+24])))
|
|
cnt = view.scan()
|
|
results.append(dict(offset=base, size=size, uuid=uuid,
|
|
cputype=m.cputype, cpusubtype=m.cpusub,
|
|
cryptid=view.cryptid, counts=dict(cnt), total=sum(cnt.values()),
|
|
header_headroom=view.inject_headroom(),
|
|
segments=m.segs))
|
|
if view.text:
|
|
va, length, fileoff = view.text
|
|
stubs = view.stub_symbol_map()
|
|
for i in range(0, length, 4):
|
|
w, = struct.unpack_from('<I', m.d, fileoff+i)
|
|
op = w & 0xfc000000
|
|
if op not in (0x94000000, 0x14000000):
|
|
continue
|
|
imm = w & 0x3ffffff
|
|
if imm & (1 << 25):
|
|
imm -= 1 << 26
|
|
target = va+i+imm*4
|
|
if target in stubs:
|
|
sites.append(dict(slice_offset=base, site=hex(va+i),
|
|
target=hex(target), branch='bl' if op==0x94000000 else 'b',
|
|
symbol=stubs[target]))
|
|
return dict(sha256=digest(path), size=len(data), slices=results), sites
|
|
|
|
|
|
def verify_rewrite(original, guarded):
|
|
"""逐条检查 __text 差异,并反解桥接目的 GOT;不能只以复扫零命中验收。"""
|
|
before, after = original.read_bytes(), guarded.read_bytes()
|
|
old_slices, new_slices = batch.arm64_slices(before), batch.arm64_slices(after)
|
|
if len(old_slices) != len(new_slices):
|
|
raise ValueError('改写前后切片数量变化')
|
|
changes = 0
|
|
for (off, size), (noff, nsize) in zip(old_slices,new_slices):
|
|
old, new = before[off:off+size], after[noff:noff+nsize]
|
|
ov, nv = batch.Slice(old,0), batch.Slice(new,0)
|
|
om, nm = Macho(old), Macho(new)
|
|
if ov.text != nv.text:
|
|
raise ValueError('__text 映射发生变化')
|
|
stubs = ov.stub_symbol_map()
|
|
if not ov.text:
|
|
continue
|
|
slots = macho_guard.find_stub_got_slots(om) if stubs else {}
|
|
va, length, fileoff = ov.text
|
|
ig = nm.segs.get('__IGUARD')
|
|
for i in range(0,length,4):
|
|
a, = struct.unpack_from('<I',old,fileoff+i)
|
|
b, = struct.unpack_from('<I',new,fileoff+i)
|
|
op = a & 0xfc000000
|
|
def branch_target(w):
|
|
imm = w & 0x3ffffff
|
|
if imm & (1<<25): imm -= 1<<26
|
|
return va+i+imm*4
|
|
sym = stubs.get(branch_target(a)) if op in (0x94000000,0x14000000) else None
|
|
if not sym:
|
|
if a != b:
|
|
raise ValueError('非目标指令发生变化')
|
|
continue
|
|
if (b & 0xfc000000) != op or not ig:
|
|
raise ValueError('分支类型变化或缺少桥接段')
|
|
target = branch_target(b)
|
|
if not ig['vmaddr'] <= target <= ig['vmaddr']+ig['filesize']-12:
|
|
raise ValueError('调用目标未落入 __IGUARD')
|
|
boff = ig['fileoff']+target-ig['vmaddr']
|
|
w0,w1,w2 = struct.unpack_from('<III',new,boff)
|
|
if w0 & 0x9f00001f != 0x90000010 or w1 & 0xffc003ff != 0xf9400210 or w2 != 0xd61f0200:
|
|
raise ValueError('桥接不是 ADRP/LDR/BR x16')
|
|
imm = ((w0>>5)&0x7ffff)*4+((w0>>29)&3)
|
|
if imm & (1<<20): imm -= 1<<21
|
|
got = (target & ~0xfff)+(imm<<12)+((w1>>10)&0xfff)*8
|
|
if got != slots[sym]:
|
|
raise ValueError(f'桥接 GOT 目标错误: {sym}')
|
|
changes += 1
|
|
return changes
|
|
|
|
|
|
def scan(app, output, label):
|
|
binaries, sites = {}, []
|
|
for path in sorted(map(Path, batch.iter_macho_files(str(app)))):
|
|
rel = str(path.relative_to(app))
|
|
binaries[rel], found = inspect_binary(path)
|
|
sites.extend(dict(path=rel, **site) for site in found)
|
|
if not binaries:
|
|
raise ValueError('未发现支持的 Mach-O,拒绝将空扫描判为通过')
|
|
save(output / f'{label}-binaries.json', binaries)
|
|
with (output / f'{label}-callsites.csv').open('w') as f:
|
|
w = csv.DictWriter(f, fieldnames=['path','slice_offset','site','target','branch','symbol'])
|
|
w.writeheader()
|
|
w.writerows(sites)
|
|
return binaries, len(sites)
|
|
|
|
|
|
def run(ipa, output):
|
|
ipa, output = ipa.resolve(), output.resolve()
|
|
if output.exists():
|
|
raise ValueError('输出目录必须不存在,避免覆盖既有证据')
|
|
validate_zip(ipa)
|
|
output.mkdir(parents=True)
|
|
manifest = dict(schema_version=1, status='running',
|
|
created_utc=datetime.now(timezone.utc).isoformat(),
|
|
scope='自研直接分支规则与静态结构;不代表 V4.6.6/真机验收',
|
|
vendor_retest='not_run', device_regression='not_run',
|
|
signing='ad-hoc,仅用于本地静态验证',
|
|
input=dict(path=str(ipa), size=ipa.stat().st_size, sha256=digest(ipa)),
|
|
environment=dict(platform=platform.platform(), python=sys.version),
|
|
tools={str(p.relative_to(ROOT)):digest(p) for p in
|
|
sorted((ROOT/'tools/macho_guard').glob('*.py'))})
|
|
def command(args):
|
|
p = subprocess.run(list(map(str,args)), capture_output=True, text=True)
|
|
with (output/'commands.log').open('a') as log:
|
|
log.write(json.dumps(list(map(str,args)), ensure_ascii=False)+'\n')
|
|
log.write(p.stdout+p.stderr+f'\nexit={p.returncode}\n')
|
|
if p.returncode:
|
|
raise RuntimeError(f'命令失败({p.returncode}): {args[0]},详见 commands.log')
|
|
return p.stdout.strip()
|
|
try:
|
|
manifest['environment']['xcode'] = command(['xcodebuild','-version'])
|
|
manifest['environment']['clang'] = command(['xcrun','clang','--version'])
|
|
# 仓库未提交的实现也随证据冻结,避免只有 HEAD 无法还原当时源码。
|
|
snapshot = output/'source-snapshot'
|
|
for folder in ('tools/macho_guard','tools/static_sdk_redirect','tests','defender'):
|
|
for p in sorted((ROOT/folder).rglob('*')):
|
|
if p.is_file() and '__pycache__' not in p.parts and p.suffix in ('.py','.c','.h','.json'):
|
|
dest = snapshot/p.relative_to(ROOT)
|
|
dest.parent.mkdir(parents=True,exist_ok=True)
|
|
shutil.copy2(p,dest)
|
|
save(output/'source-files.json', inventory(snapshot))
|
|
# 对冻结源码运行全部测试;日志永久保存,失败中止。
|
|
command([sys.executable,'-m','unittest','discover','-s',snapshot/'tests','-v'])
|
|
manifest['automated_tests'] = 'passed; 详见 commands.log'
|
|
baseline = output/'baseline'
|
|
baseline.mkdir()
|
|
shutil.copy2(ipa, baseline/'input.ipa')
|
|
if digest(baseline/'input.ipa') != manifest['input']['sha256']:
|
|
raise ValueError('输入在复制过程中发生变化')
|
|
command(['ditto','-x','-k',baseline/'input.ipa',baseline/'unpacked'])
|
|
apps = list((baseline/'unpacked/Payload').glob('*.app'))
|
|
if len(apps) != 1:
|
|
raise ValueError('需要恰好一个顶层 .app')
|
|
app = apps[0]
|
|
with (app/'Info.plist').open('rb') as f:
|
|
info = plistlib.load(f)
|
|
manifest['app'] = {k:info.get(k) for k in
|
|
('CFBundleIdentifier','CFBundleShortVersionString','CFBundleVersion','CFBundleExecutable')}
|
|
manifest['original_report'] = dict(version='2.197.2', bundle_id='com.ecnup.azZVz02',
|
|
exact_report_binary_available=False,
|
|
note='当前输入单独建基线,不视为原漏洞报告二进制')
|
|
before, before_total = scan(app, output, 'before')
|
|
save(output/'before-files.json', inventory(baseline/'unpacked'))
|
|
guarded = output/'guarded'
|
|
guarded.mkdir()
|
|
command(['ditto', baseline/'unpacked', guarded/'unpacked'])
|
|
guarded_app = guarded/'unpacked/Payload'/app.name
|
|
rewrites = []
|
|
for rel, binary in before.items():
|
|
hits = sum(s['total'] for s in binary['slices'])
|
|
if not hits:
|
|
continue
|
|
for s in binary['slices']:
|
|
if s['header_headroom'] is None or s['header_headroom'] < 72:
|
|
raise ValueError(f'注入余量不足: {rel}')
|
|
result = macho_guard.harden_macho_file(str(guarded_app/rel))
|
|
if not result or result[0] != hits:
|
|
raise ValueError(f'改写计数不一致: {rel}')
|
|
rewrites.append(dict(path=rel, total=result[0], counts=result[1]))
|
|
save(output/'rewrites.json', rewrites)
|
|
# 对所有嵌套 bundle 和裸 dylib 从内向外签名;每次失败均中止。
|
|
targets = {p for p in guarded_app.rglob('*') if
|
|
not p.is_symlink() and (p.suffix in ('.framework','.app','.appex','.xpc','.dylib'))}
|
|
targets.add(guarded_app)
|
|
for target in sorted(targets, key=lambda p:(-len(p.parts),str(p))):
|
|
command(['codesign','--force','--sign','-',target])
|
|
for target in sorted(targets):
|
|
command(['codesign','--verify','--strict','--verbose=2',target])
|
|
after, after_total = scan(guarded_app, output, 'after')
|
|
if before.keys() != after.keys() or after_total != 0:
|
|
raise ValueError('Mach-O 清单变化或改写后仍有命中')
|
|
for rel in before:
|
|
command(['xcrun','otool','-l',guarded_app/rel])
|
|
expected = sum(s['total'] for s in before[rel]['slices'])
|
|
if verify_rewrite(app/rel,guarded_app/rel) != expected:
|
|
raise ValueError(f'逐指令改写校验数量不一致: {rel}')
|
|
for a,b in zip(before[rel]['slices'],after[rel]['slices']):
|
|
if a['uuid'] != b['uuid']:
|
|
raise ValueError(f'UUID 意外变化: {rel}')
|
|
save(output/'after-files.json', inventory(guarded/'unpacked'))
|
|
command(['ditto','-c','-k','--sequesterRsrc','--keepParent',guarded/'unpacked/Payload',guarded/'guarded.ipa'])
|
|
command(['ditto','-x','-k',guarded/'guarded.ipa',output/'repacked-check'])
|
|
repacked, total = scan(output/'repacked-check/Payload'/app.name, output, 'repacked')
|
|
if repacked != after or total:
|
|
raise ValueError('重新打包解包后扫描/二进制哈希不一致')
|
|
if digest(ipa) != manifest['input']['sha256']:
|
|
raise ValueError('原始输入哈希发生变化')
|
|
manifest.update(status='passed_local_checks', before_total=before_total, after_total=after_total,
|
|
macho_files=len(before), changed_macho_files=len(rewrites),
|
|
instruction_and_bridge_validation='passed',
|
|
guarded_ipa=dict(path='guarded/guarded.ipa',sha256=digest(guarded/'guarded.ipa')))
|
|
# 重解包副本验证后可删除,前后两个完整 Payload 与 IPA 留存。
|
|
shutil.rmtree(output/'repacked-check')
|
|
except Exception as exc:
|
|
manifest.update(status='failed', error=str(exc))
|
|
raise
|
|
finally:
|
|
save(output/'manifest.json', manifest)
|
|
save(output/'evidence-hashes.json', inventory(output))
|
|
print(json.dumps(manifest, ensure_ascii=False, indent=2))
|
|
|
|
|
|
if __name__ == '__main__':
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument('ipa', type=Path)
|
|
parser.add_argument('--output', type=Path, required=True)
|
|
args = parser.parse_args()
|
|
run(args.ipa, args.output)
|