在 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>
295 lines
13 KiB
Python
295 lines
13 KiB
Python
"""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)} 处")
|