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

166 lines
7.2 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.
"""批处理:遍历 .app 包内所有 Mach-O(thin / fat 单 arm64 切片),
对每个 arm64 切片运行自研直接分支规则(扫 __text 全部 bl/b → __stubs,
经间接符号表映射到 12 个命中符号),统计命中数与注入余量。
scan 模式只读不改;harden 模式见 macho_guard.harden_bundle。
"""
import struct, sys, os
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
SYMBOLS = ["_fopen","_dlopen","_dlsym","_write","_read","_open",
"_close","_exit","_fork","_syscall","_unlink","_getpid"]
WANT = set(SYMBOLS)
FAT_MAGIC = 0xBEBAFECA # fat_header magic, big-endian on disk (cafebabe 按大端读)
FAT_MAGIC_LE = 0xCAFEBABE
MH64 = 0xFEEDFACF
LC_SEGMENT_64=0x19; LC_SYMTAB=0x2; LC_DYSYMTAB=0xb
LC_ENCRYPTION_INFO_64=0x2C
def arm64_slices(data):
"""返回 [(slice_offset, slice_size)];thin 返回单个 (0,len),fat 挑 arm64(非 arm64e)。"""
magic,=struct.unpack_from(">I",data,0)
if magic==FAT_MAGIC_LE: # fat:字段大端
nfat,=struct.unpack_from(">I",data,4)
out=[]
for i in range(nfat):
cputype,cpusub,off,size,align=struct.unpack_from(">IIIII",data,8+i*20)
# CPU_TYPE_ARM64=0x0100000C;cpusub 低 24 位:0=ARM64_ALL,1=ARM64E(2)
if cputype==0x0100000C and (cpusub & 0x00FFFFFF) in (0,1):
out.append((off,size))
return out
m,=struct.unpack_from("<I",data,0)
if m==MH64:
cpu, sub=struct.unpack_from("<II",data,4)
return [(0,len(data))] if cpu==0x0100000c and (sub & 0xffffff) in (0,1) else []
return [] # 非 arm64 Mach-O
class Slice:
"""一个 thin arm64 Mach-O 切片的只读分析视图(偏移均相对 base)。"""
def __init__(self, data, base):
self.d=data; self.base=base
magic,=struct.unpack_from("<I",data,base)
assert magic==MH64
self.ncmds,=struct.unpack_from("<I",data,base+16)
self.text=self.stubs=self.symtab=self.dysym=None
self.cryptid=0; self.first_sect_foff=None; self.sizeofcmds=0
self.text_vmaddr=0
off=base+32
self.sizeofcmds,=struct.unpack_from("<I",data,base+20)
for _ in range(self.ncmds):
cmd,cmdsize=struct.unpack_from("<II",data,off)
if cmd==LC_SEGMENT_64:
segname=data[off+8:off+24].split(b"\0")[0].decode()
vmaddr,=struct.unpack_from("<Q",data,off+24)
nsects,=struct.unpack_from("<I",data,off+64)
if segname=="__TEXT": self.text_vmaddr=vmaddr
so=off+72
for _ in range(nsects):
sn=data[so:so+16].split(b"\0")[0].decode()
addr,size=struct.unpack_from("<QQ",data,so+32)
foff,=struct.unpack_from("<I",data,so+48)
r1,r2=struct.unpack_from("<II",data,so+68)
if foff>0 and (self.first_sect_foff is None or foff<self.first_sect_foff):
self.first_sect_foff=foff
if sn=="__text": self.text=(addr,size,foff)
if sn=="__stubs": self.stubs=(addr,size,foff,r1,r2)
so+=80
elif cmd==LC_SYMTAB: self.symtab=struct.unpack_from("<IIII",data,off+8)
elif cmd==LC_DYSYMTAB: self.dysym=struct.unpack_from("<"+"I"*18,data,off+8)
elif cmd==LC_ENCRYPTION_INFO_64: self.cryptid=struct.unpack_from("<I",data,off+16)[0]
off+=cmdsize
def foff(self, slice_rel):
"""切片内相对偏移 → 文件绝对偏移。"""
return self.base+slice_rel
def stub_symbol_map(self):
"""{stub_vmaddr: symbol_name} 仅限 WANT 中符号。"""
if not (self.stubs and self.symtab and self.dysym): return {}
symoff,nsyms,stroff,strsize=self.symtab
indoff=self.dysym[12]
saddr,ssize,sfoff,sr1,sr2=self.stubs
out={}
for i in range(ssize//sr2):
idx,=struct.unpack_from("<I",self.d,self.base+indoff+(sr1+i)*4)
strx,=struct.unpack_from("<I",self.d,self.base+symoff+idx*16)
end=self.d.index(b"\0",self.base+stroff+strx)
name=self.d[self.base+stroff+strx:end].decode()
if name in WANT: out[saddr+i*sr2]=name
return out
def scan(self):
"""Counter{符号:命中数}。__text 内所有 bl/b 目标落到 WANT stub 的计数。"""
from collections import Counter
cnt=Counter()
if not self.text: return cnt
stub_sym=self.stub_symbol_map()
if not stub_sym: return cnt
taddr,tsize,tfoff=self.text
for i in range(0,tsize,4):
w,=struct.unpack_from("<I",self.d,self.base+tfoff+i)
opc=w&0xFC000000
if opc in (0x94000000,0x14000000):
imm=w&0x3FFFFFF
if imm&(1<<25): imm-=1<<26
nm=stub_sym.get(taddr+i+imm*4)
if nm: cnt[nm]+=1
return cnt
def inject_headroom(self):
"""注入一条 72 字节 LC_SEGMENT_64 所需余量:首节 foff - (header+sizeofcmds)。"""
if self.first_sect_foff is None: return None
return self.first_sect_foff-(32+self.sizeofcmds)
def iter_macho_files(app_dir):
for root,_,files in os.walk(app_dir):
for fn in files:
p=os.path.join(root,fn)
if os.path.islink(p): continue
try:
with open(p,"rb") as f: head=f.read(8)
except Exception: continue
if len(head)<4: continue
m_le,=struct.unpack_from("<I",head,0)
m_be,=struct.unpack_from(">I",head,0)
if m_le==MH64 or m_be==FAT_MAGIC_LE:
yield p
def scan_bundle(app_dir):
rows=[] # (relpath, is_fat, total, cnt, headroom, cryptid)
for p in sorted(iter_macho_files(app_dir)):
data=open(p,"rb").read()
slices=arm64_slices(data)
is_fat = struct.unpack_from(">I",data,0)[0]==FAT_MAGIC_LE
for (soff,ssize) in slices:
s=Slice(data,soff)
cnt=s.scan()
rows.append((os.path.relpath(p,app_dir),is_fat,sum(cnt.values()),
dict(cnt),s.inject_headroom(),s.cryptid))
return rows
if __name__=="__main__":
app=sys.argv[1]
rows=scan_bundle(app)
hit=[r for r in rows if r[2]>0]
from collections import Counter
grand=Counter()
print(f"Mach-O 文件/切片总数: {len(rows)};命中(>0): {len(hit)}")
print(f"{'命中':>5} {'余量':>6} {'enc':>3} 文件")
for rel,fat,tot,cnt,room,crypt in sorted(rows,key=lambda r:-r[2]):
if tot==0: continue
for k,v in cnt.items(): grand[k]+=v
tag=" FAT" if fat else ""
print(f"{tot:>5} {str(room):>6} {crypt:>3} {rel}{tag}")
print(f"\n命中总计: {sum(grand.values())}")
for k,v in sorted(grand.items(),key=lambda x:-x[1]):
print(f" {k:10} {v}")
nz=[r for r in rows if r[2]>0 and (r[4] is None or r[4]<72)]
if nz:
print("\n注入余量不足(<72B)或未知的命中文件:")
for rel,fat,tot,cnt,room,crypt in nz: print(f" room={room} {rel}")
enc=[r for r in rows if r[2]>0 and r[5]!=0]
if enc:
print("\n加密(cryptid≠0)的命中文件:")
for rel,fat,tot,cnt,room,crypt in enc: print(f" cryptid={crypt} {rel}")