在 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>
166 lines
7.2 KiB
Python
166 lines
7.2 KiB
Python
"""批处理:遍历 .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}")
|