Files
iOSGuard/tools/macho_guard/verify_baseline.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

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)