在 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>
115 lines
7.3 KiB
Python
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)
|