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

295 lines
13 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""macho_guard 注入器:向未加密 thin arm64 可执行文件注入 __IGUARD 桥接段。
桥接函数与系统 stub 字节同构(adrp x16,GOT@page; ldr x16,[x16,off]; br x16),
从同一 GOT 槽取址尾调用,但不登记进间接符号表——因此调用点改写为 bl IG_* 后,
静态扫描器无法再把调用点标记为对应系统符号。
本阶段(step 1)只注入段并校验结构;调用点改写在 rewrite 子命令中进行。
"""
import struct, sys, subprocess, os
from pathlib import Path
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from machox import Macho, LC_SEGMENT_64, LC_CODE_SIGNATURE
PAGE = 0x4000 # iOS arm64 16KB 页
# 报告命中的 12 个符号
SYMBOLS = ["_fopen","_dlopen","_dlsym","_write","_read","_open",
"_close","_exit","_fork","_syscall","_unlink","_getpid"]
def _text_mapping(m: Macho):
"""返回 (__TEXT vmaddr, __TEXT fileoff),用于 vmaddr→fileoff 换算。
主程序 __TEXT vmaddr=0x1_0000_0000/fileoff=0;framework/dylib vmaddr=0/fileoff=0。"""
t=m.segs["__TEXT"]
return t["vmaddr"], t["fileoff"]
def _first_section_fileoff(m: Macho):
"""首个非零 section 文件偏移=load command 区可用上界(主程序 0x4000)。"""
best=None
for cmd,cmdsize,off in m.cmds:
if cmd!=LC_SEGMENT_64: continue
nsects,=struct.unpack_from("<I",m.d,off+64); so=off+72
for _ in range(nsects):
foff,=struct.unpack_from("<I",m.d,so+48)
if foff>0 and (best is None or foff<best): best=foff
so+=80
return best
def enc_adrp(rd, page_delta):
"""adrp rd, #page_delta(已右移12的页差由调用方给未移的字节差)."""
imm = page_delta >> 12
immlo = imm & 3; immhi = (imm >> 2) & 0x7FFFF
return 0x90000000 | (immlo<<29) | (immhi<<5) | rd
def enc_ldr_uimm(rt, rn, byte_off):
"""ldr xt,[xn,#byte_off] 64位无符号偏移."""
assert byte_off % 8 == 0
imm12 = byte_off // 8
return 0xF9400000 | (imm12<<10) | (rn<<5) | rt
def enc_br(rn):
return 0xD61F0000 | (rn<<5)
def find_stub_got_slots(m: Macho):
"""解析间接符号表,得到 {符号名: GOT槽vmaddr}(通过 stub 反解)。"""
# 定位 __stubs、symtab、dysymtab
import machox as X
stubs=symtab=dysym=None
for cmd,cmdsize,off in m.cmds:
if cmd==LC_SEGMENT_64:
nsects,=struct.unpack_from("<I",m.d,off+64)
so=off+72
for _ in range(nsects):
sn=m.d[so:so+16].split(b"\0")[0].decode()
if sn=="__stubs":
addr,size=struct.unpack_from("<QQ",m.d,so+32)
r1,r2=struct.unpack_from("<II",m.d,so+68)
stubs=(addr,size,r1,r2)
so+=80
elif cmd==X.LC_SYMTAB: symtab=struct.unpack_from("<IIII",m.d,off+8)
elif cmd==X.LC_DYSYMTAB: dysym=struct.unpack_from("<"+"I"*18,m.d,off+8)
symoff,nsyms,stroff,strsize=symtab
indoff=dysym[12]
saddr,ssize,sr1,sr2=stubs
tvm,tfo=_text_mapping(m) # vmaddr→fileoff: fo = va - tvm + tfo
out={}
for i in range(ssize//sr2):
idx,=struct.unpack_from("<I",m.d,indoff+(sr1+i)*4)
strx,=struct.unpack_from("<I",m.d,symoff+idx*16)
name=m.d[stroff+strx:m.d.index(b"\0",stroff+strx)].decode()
if name in SYMBOLS:
stub_va=saddr+i*sr2; fo=stub_va-tvm+tfo
w0,w1=struct.unpack_from("<II",m.d,fo)
immlo=(w0>>29)&3; immhi=(w0>>5)&0x7FFFF
imm=(immhi<<2)|immlo
if imm&(1<<20): imm-=1<<21
page=(stub_va & ~0xFFF)+(imm<<12)
imm12=(w1>>10)&0xFFF
out[name]=page+imm12*8
return out
def build_bridge(got_slots, ig_vmaddr):
"""生成桥接段字节与 {符号:IG函数vmaddr}。每函数 3 指令 12 字节。"""
code=bytearray(); addrs={}
order=[s for s in SYMBOLS if s in got_slots]
for i,sym in enumerate(order):
fn_va=ig_vmaddr+i*12
slot=got_slots[sym]
page_delta=(slot & ~0xFFF)-(fn_va & ~0xFFF)
off=slot & 0xFFF
code+=struct.pack("<III",enc_adrp(16,page_delta),
enc_ldr_uimm(16,16,off),enc_br(16))
addrs[sym]=fn_va
return bytes(code),addrs
def inject(path, out_path):
if os.path.realpath(path)==os.path.realpath(out_path):
raise ValueError("注入输出不得覆盖输入")
m=Macho(Path(path).read_bytes())
if "__IGUARD" in m.segs:
raise ValueError("已存在 __IGUARD,拒绝重复注入")
le=m.segs["__LINKEDIT"]
ig_fileoff=le["fileoff"]; ig_vmaddr=le["vmaddr"]
got=find_stub_got_slots(m)
missing=[s for s in SYMBOLS if s not in got]
bridge,addrs=build_bridge(got,ig_vmaddr)
seg_filesize=PAGE # 一页足够
hdr_region=_first_section_fileoff(m) # load command 区上界(主程序 0x4000,framework 各异)
assert ig_fileoff>hdr_region, "插入点须在 header 区之后"
# 1) 段数据:桥接 + 补零到一页
segdata=bytearray(bridge)+b"\0"*(seg_filesize-len(bridge))
# 2) 文件插入:在 __LINKEDIT fileoff 处插入一页
d=m.d
body=bytearray(d)
body[ig_fileoff:ig_fileoff]=segdata # 插入
# 3) 构造 __IGUARD 段命令(0 section, RX)
segcmd=struct.pack("<II16sQQQQiiII",LC_SEGMENT_64,72,b"__IGUARD",
ig_vmaddr,PAGE,ig_fileoff,seg_filesize,5,5,0,0)
# 4) 在 __LINKEDIT 命令前插入该段命令,保持 header 区总长不变
le_cmdoff=m.segs["__LINKEDIT"]["off"]
# header 区(0..hdr_region)未受段数据插入影响(插入点 ig_fileoff>hdr_region),直接在其中插命令
hdr=bytearray(body[:hdr_region])
newhdr=hdr[:le_cmdoff]+segcmd+hdr[le_cmdoff:m.hdr_size+m.sizeofcmds]
pad=hdr_region-len(newhdr)
assert pad>=0, f"load command 空间不足: 需要 {len(newhdr)} > {hdr_region}"
newhdr+=b"\0"*pad
body[:hdr_region]=newhdr
# 5) 修 header ncmds/sizeofcmds
struct.pack_into("<II",body,16,m.ncmds+1,m.sizeofcmds+72)
# 6) 修 __LINKEDIT 段命令:命令已右移 72 字节
le_newoff=le_cmdoff+72
struct.pack_into("<Q",body,le_newoff+24,le["vmaddr"]+PAGE) # vmaddr
struct.pack_into("<Q",body,le_newoff+40,le["fileoff"]+PAGE) # fileoff
# 7) 修所有指向 __LINKEDIT 的偏移 += PAGE(命令偏移也右移 72)
for lab,fo,v in m.linkedit_pointers():
struct.pack_into("<I",body,fo+(72 if fo>=le_cmdoff else 0),v+PAGE)
Path(out_path).write_bytes(body)
return addrs, missing, ig_vmaddr
def rewrite_callsites(path, out_path, bridge_addrs):
"""把 __text 里所有 bl/b -> 命中符号 stub 的调用点改写为 bl/b -> IG_*。
返回 {符号: 改写数}。调用点文件偏移在 ig 插入点之前,不受注入影响。"""
m=Macho(Path(path).read_bytes())
got=find_stub_got_slots(m) # 复用:也给出每个符号的 stub
# 需要 stub_va: 重新建 符号->stub_va
import machox as X
stubs=symtab=dysym=text=None
for cmd,cmdsize,off in m.cmds:
if cmd==LC_SEGMENT_64:
nsects,=struct.unpack_from("<I",m.d,off+64); so=off+72
for _ in range(nsects):
sn=m.d[so:so+16].split(b"\0")[0].decode()
addr,size=struct.unpack_from("<QQ",m.d,so+32)
foff,=struct.unpack_from("<I",m.d,so+48)
r1,r2=struct.unpack_from("<II",m.d,so+68)
if sn=="__stubs": stubs=(addr,size,foff,r1,r2)
if sn=="__text": text=(addr,size,foff)
so+=80
elif cmd==X.LC_SYMTAB: symtab=struct.unpack_from("<IIII",m.d,off+8)
elif cmd==X.LC_DYSYMTAB: dysym=struct.unpack_from("<"+"I"*18,m.d,off+8)
symoff,nsyms,stroff,strsize=symtab; indoff=dysym[12]
saddr,ssize,sfoff,sr1,sr2=stubs
stub_sym={}
for i in range(ssize//sr2):
idx,=struct.unpack_from("<I",m.d,indoff+(sr1+i)*4)
strx,=struct.unpack_from("<I",m.d,symoff+idx*16)
name=m.d[stroff+strx:m.d.index(b"\0",stroff+strx)].decode()
if name in bridge_addrs: stub_sym[saddr+i*sr2]=name
taddr,tsize,tfoff=text
d=bytearray(Path(path).read_bytes())
from collections import Counter
cnt=Counter()
for i in range(0,tsize,4):
w,=struct.unpack_from("<I",d,tfoff+i)
opc=w&0xFC000000
if opc in (0x94000000,0x14000000):
imm=w&0x3FFFFFF
if imm&(1<<25): imm-=1<<26
tgt=taddr+i+imm*4
sym=stub_sym.get(tgt)
if sym:
site=taddr+i; dest=bridge_addrs[sym]; delta=dest-site
assert -(1<<27)<=delta<(1<<27) and delta%4==0, f"越界 {site:#x}->{dest:#x}"
neww=opc | ((delta>>2)&0x3FFFFFF)
struct.pack_into("<I",d,tfoff+i,neww)
cnt[sym]+=1
Path(out_path).write_bytes(d)
return dict(cnt)
def codesign_adhoc(path):
r=subprocess.run(["codesign","-f","-s","-",path],capture_output=True,text=True)
return r.returncode,r.stderr.strip()
# ---- 批处理:fat 感知的单文件处理 + 整包遍历 ----
import tempfile, shutil
def harden_thin(src, dst):
"""thin arm64:注入 __IGUARD + 改写调用点(不签名)。返回 (改写计数dict, 桥接数, missing)。"""
addrs,missing,igva=inject(src,dst)
cnt=rewrite_callsites(dst,dst,addrs)
return cnt, len(addrs), missing, igva
def _fat_arm64_arch(path):
"""fat 容器里 arm64 切片的 lipo arch 名(arm64 或 arm64 的子型)。返回首个匹配。"""
r=subprocess.run(["lipo","-archs",path],capture_output=True,text=True)
archs=r.stdout.split()
for a in archs:
if a=="arm64": return a
for a in archs:
if a.startswith("arm64") and a!="arm64e": return a
return None
def harden_macho_file(path, verbose=True):
"""就地加固一个 Mach-O 文件(thin 或含单 arm64 切片的 fat)。签名在上层统一做。
返回 (改写总数, 细目dict) 或 None(无命中/跳过)。"""
data=Path(path).read_bytes()
is_fat = struct.unpack_from(">I",data,0)[0]==0xCAFEBABE
if is_fat:
arch=_fat_arm64_arch(path)
if not arch: return None
with tempfile.TemporaryDirectory() as td:
thin=os.path.join(td,"thin"); hard=os.path.join(td,"hard")
subprocess.run(["lipo",path,"-thin",arch,"-output",thin],check=True)
# 加密检查
mm=Macho(Path(thin).read_bytes())
cnt,nbr,missing,igva=harden_thin(thin,hard)
if sum(cnt.values())==0: return None
# 替换回 fat
subprocess.run(["lipo",path,"-replace",arch,hard,"-output",path],check=True)
return sum(cnt.values()), dict(cnt)
else:
with tempfile.TemporaryDirectory() as td:
hard=os.path.join(td,"hard")
cnt,nbr,missing,igva=harden_thin(path,hard)
if sum(cnt.values())==0: return None
shutil.copymode(path,hard); shutil.move(hard,path)
return sum(cnt.values()), dict(cnt)
def _sign_targets(app_dir):
"""返回自底向上的签名目标:各 .framework/.app 包 + 主可执行文件。"""
fws=[]
fwdir=os.path.join(app_dir,"Frameworks")
if os.path.isdir(fwdir):
for n in sorted(os.listdir(fwdir)):
p=os.path.join(fwdir,n)
if p.endswith((".framework",".dylib")): fws.append(p)
return fws
def harden_bundle(app_dir, resign=True):
"""遍历 .app 内全部 Mach-O,逐个加固有命中者;可选统一重签。"""
import batch
results=[] # (relpath, total, cnt)
for p in sorted(batch.iter_macho_files(app_dir)):
r=harden_macho_file(p)
if r:
results.append((os.path.relpath(p,app_dir),r[0],r[1]))
print(f" [改写] {r[0]:>4} 处 {os.path.relpath(p,app_dir)}")
if resign:
# 先签 Frameworks(含被改写的),再签主 app
for fw in _sign_targets(app_dir):
subprocess.run(["codesign","-f","-s","-",fw],capture_output=True)
rc,err=codesign_adhoc(app_dir) # 签主 app bundle
print(f" [重签] 主 app exit={rc} {err}")
return results
if __name__=="__main__":
mode=sys.argv[1]
if mode=="inject":
src,dst=sys.argv[2],sys.argv[3]
addrs,missing,igva=inject(src,dst)
print(f"注入完成 -> {dst} __IGUARD={igva:#x} 桥接 {len(addrs)} 个")
if missing: print("缺失:",missing)
elif mode=="harden":
src,dst=sys.argv[2],sys.argv[3]
addrs,missing,igva=inject(src,dst)
print(f"[1/3] 注入 __IGUARD @{igva:#x},桥接 {len(addrs)} 个" + (f" 缺失={missing}" if missing else ""))
cnt=rewrite_callsites(dst,dst,addrs)
print(f"[2/3] 改写调用点 共 {sum(cnt.values())} 处: "+", ".join(f"{k}={v}" for k,v in sorted(cnt.items(),key=lambda x:-x[1])))
rc,err=codesign_adhoc(dst)
print(f"[3/3] ad-hoc 重签 exit={rc} {err}")
elif mode=="harden-bundle":
app=sys.argv[2]
print(f"遍历加固 .app: {app}")
res=harden_bundle(app, resign=(len(sys.argv)<4 or sys.argv[3]!="--no-sign"))
print(f"共加固 {len(res)} 个 Mach-O,改写 {sum(t for _,t,_ in res)} 处")