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

115 lines
7.3 KiB
Python

#!/usr/bin/env python3
"""ZipZap 两函数的构建后转接、增强追踪、签名和证据固化;无真机/厂商通过声明。"""
import argparse
import json
from pathlib import Path
import plistlib
import shutil
import subprocess
import sys
from redirect_to_runtime import patch,trace_calls,sha
from verify_baseline import inventory,save,scan
ROOT=Path(__file__).resolve().parents[2]
def run(app,linkmap,build_log,dispatch_object,output):
app,linkmap,output=app.resolve(),linkmap.resolve(),output.resolve()
if output.exists():raise ValueError('输出目录必须不存在')
with (app/'Info.plist').open('rb') as f:info=plistlib.load(f)
output.mkdir(parents=True)
result=dict(status='running',app={k:info.get(k) for k in
('CFBundleIdentifier','CFBundleShortVersionString','CFBundleVersion','CFBundleExecutable')},
device_regression='not_run',vendor_retest='not_run',signing='ad-hoc, static checks only')
def command(args):
r=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'+r.stdout+r.stderr+f'\nexit={r.returncode}\n')
if r.returncode:raise RuntimeError(f'{args[0]} 失败,详见 commands.log')
return r.stdout
try:
# 冻结本次执行所需源码及 App 策略测试输入,保留原工程已有工作。
snapshot=output/'source-snapshot'
for folder in ('defender','tools/macho_guard','tools/static_sdk_redirect','tests'):
for src in (ROOT/folder).rglob('*'):
if src.is_file() and src.suffix in ('.c','.h','.m','.py','.json') and '__pycache__' not in src.parts:
dest=snapshot/src.relative_to(ROOT);dest.parent.mkdir(parents=True,exist_ok=True);shutil.copy2(src,dest)
sources=[ROOT/'readoor-test/readoor.xcodeproj/project.pbxproj',
*list((ROOT/'readoor-test/readoor/3.0/Base/Security').rglob('*.swift')),
*list((ROOT/'readoor-test/readoor/3.0/Base/Security/IGDefender').rglob('*.c')),
*list((ROOT/'readoor-test/readoor/3.0/Base/Security/IGDefender').rglob('*.h')),
ROOT/'readoor-test/scripts/add_igdefender.rb',
ROOT/'readoor-test/readoor/3.0/Features/PurchaseOrOrder/Controllers/RDOrderViewController.swift']
for src in sources:
dest=snapshot/src.relative_to(ROOT);dest.parent.mkdir(parents=True,exist_ok=True);shutil.copy2(src,dest)
save(output/'source-files.json',inventory(snapshot))
command([sys.executable,'-m','unittest','discover','-s',snapshot/'tests','-v'])
result['tests']='passed (详见 commands.log)'
result['environment']=command(['xcodebuild','-version']).strip()
shutil.copy2(build_log,output/'build-release.log');shutil.copy2(linkmap,output/'link.map')
shutil.copy2(dispatch_object,output/'IGDispatch.o')
imports=command(['xcrun','nm','-u',output/'IGDispatch.o'])
(output/'IGDispatch-imports.txt').write_text(imports)
if {'_write','_close','_memcmp'} & set(imports.split()):
raise ValueError('调度对象仍直接导入受保护目标或前缀比较函数')
baseline=output/'baseline/Payload'/app.name
guarded=output/'guarded/Payload'/app.name
command(['ditto',app,baseline]);command(['ditto',app,guarded])
executable=info['CFBundleExecutable'];original=baseline/executable;binary=guarded/executable
profile=json.loads((ROOT/'tools/macho_guard/profiles/zipzap.json').read_text())
roots=[r['caller'] for r in profile['rules']]
new_binary=output/'patched-binary'
report=patch(original,new_binary,linkmap,profile)
report['trace_before']=trace_calls(original,linkmap,roots)
report['trace_after']=trace_calls(new_binary,linkmap,roots)
# 新调度可以间接调用,不能仍沿直接桩或经典 GOT 桥接到原 write/close。
remaining=[r for r in report['trace_after'] if r.get('symbol') in ('_write','_close')]
if remaining:raise ValueError('试点路径仍存在可恢复的原目标直接/GOT 桥接')
if not any(r['kind']=='indirect_unresolved' for r in report['trace_after']):
raise ValueError('未观察到预期的运行时间接调用')
shutil.move(new_binary,binary)
before,bt=scan(baseline,output,'before')
targets={p for p in guarded.rglob('*') if not p.is_symlink() and p.suffix in ('.framework','.app','.appex','.xpc','.dylib')}
targets.add(guarded)
for p in sorted(targets,key=lambda p:(-len(p.parts),str(p))):command(['codesign','--force','--sign','-',p])
for p in sorted(targets):command(['codesign','--verify','--strict','--verbose=2',p])
after,at=scan(guarded,output,'after')
if bt-at!=report['total']:raise ValueError('整包直接调用减少数与试点不一致')
if before.keys()!=after.keys():raise ValueError('二进制清单变化')
if [s['uuid'] for s in before[executable]['slices']]!=[s['uuid'] for s in after[executable]['slices']]:
raise ValueError('UUID 变化')
command(['xcrun','otool','-l',binary])
for symbol in ('IG_dispatch_write','IG_dispatch_close','ig_resolve_verified'):
text=command(['xcrun','llvm-objdump','--no-show-raw-insn',
'--disassemble-symbols=_'+symbol,binary])
(output/(symbol+'.asm')).write_text(text)
symbols=command(['xcrun','nm',binary])
if 'ig_dispatch_test_' in symbols:raise ValueError('发布产物残留测试接口')
report['signed_output_sha256']=sha(binary)
save(output/'redirect-report.json',report)
save(output/'before-files.json',inventory(baseline.parent.parent))
save(output/'after-files.json',inventory(guarded.parent.parent))
command(['ditto','-c','-k','--sequesterRsrc','--keepParent',guarded.parent,output/'guarded.ipa'])
command(['ditto','-x','-k',output/'guarded.ipa',output/'repack'])
repacked,total=scan(output/'repack/Payload'/app.name,output,'repacked')
if repacked!=after or total!=at:raise ValueError('重打包验证失败')
shutil.rmtree(output/'repack')
if sha(app/executable)!=report['input_sha256']:raise ValueError('输入构建产物意外变化')
result.update(status='passed_local_checks',total_redirected=report['total'],before_total=bt,
after_total=at,input_sha256=report['input_sha256'],
output_sha256=report['signed_output_sha256'],ipa_sha256=sha(output/'guarded.ipa'),
static_tracking_limitations=report['residual_tracking'])
except Exception as exc:
result.update(status='failed',error=str(exc));raise
finally:save(output/'manifest.json',result)
save(output/'evidence-hashes.json',inventory(output))
print(json.dumps(result,ensure_ascii=False,indent=2))
if __name__=='__main__':
p=argparse.ArgumentParser(description=__doc__)
p.add_argument('--app',type=Path,required=True);p.add_argument('--link-map',type=Path,required=True)
p.add_argument('--build-log',type=Path,required=True);p.add_argument('--output',type=Path,required=True)
p.add_argument('--dispatch-object',type=Path,required=True)
a=p.parse_args();run(a.app,a.link_map,a.build_log,a.dispatch_object,a.output)