#!/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('>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)