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

92 lines
5.0 KiB
Python

"""Mach-O thin arm64 结构分析/改写基础库(macho_guard)。
只处理单切片 arm64、未加密(cryptid 0)可执行文件。"""
import struct
LC_SEGMENT_64=0x19; LC_SYMTAB=0x2; LC_DYSYMTAB=0xb
LC_DYLD_INFO=0x22; LC_DYLD_INFO_ONLY=0x80000022
LC_FUNCTION_STARTS=0x26; LC_DATA_IN_CODE=0x29
LC_CODE_SIGNATURE=0x1d; LC_DYLD_CHAINED_FIXUPS=0x80000034; LC_DYLD_EXPORTS_TRIE=0x80000033
LC_SEGMENT_SPLIT_INFO=0x1e
class Macho:
def __init__(self, data: bytearray):
self.d=bytearray(data)
if len(self.d) < 32:
raise ValueError("Mach-O header 截断")
magic,=struct.unpack_from("<I",self.d,0)
if magic!=0xFEEDFACF:
raise ValueError(f"需要 thin mach-o 64: {magic:#x}")
(self.cputype,self.cpusub,self.filetype,self.ncmds,
self.sizeofcmds,self.flags)=struct.unpack_from("<iiIIII",self.d,4)
if self.cputype != 0x0100000c or (self.cpusub & 0xffffff) not in (0, 1):
raise ValueError("仅支持 arm64/arm64v8,暂不支持 arm64e 或其它架构")
if self.filetype not in (2, 6, 8):
raise ValueError("仅支持已链接 executable/dylib/bundle")
if self.sizeofcmds > len(self.d)-32 or self.ncmds > self.sizeofcmds//8:
raise ValueError("load command 区截断")
self.hdr_size=32
self._parse()
def _parse(self):
self.cmds=[]; self.segs={}; off=self.hdr_size
for _ in range(self.ncmds):
if off+8 > self.hdr_size+self.sizeofcmds:
raise ValueError("load command header 截断")
cmd,cmdsize=struct.unpack_from("<II",self.d,off)
if cmdsize < 8 or cmdsize % 8 or off+cmdsize > self.hdr_size+self.sizeofcmds:
raise ValueError("非法 load command 长度")
self.cmds.append((cmd,cmdsize,off))
if cmd==LC_SEGMENT_64:
if cmdsize < 72:
raise ValueError("segment command 截断")
segname=self.d[off+8:off+24].split(b"\0")[0].decode()
vmaddr,vmsize,fileoff,filesize=struct.unpack_from("<QQQQ",self.d,off+24)
maxprot,initprot,nsects,fl=struct.unpack_from("<iiII",self.d,off+56)
if 72+nsects*80 != cmdsize or fileoff+filesize > len(self.d):
raise ValueError("segment/section 越界")
if segname in self.segs:
raise ValueError("重复 segment")
self.segs[segname]=dict(off=off,vmaddr=vmaddr,vmsize=vmsize,
fileoff=fileoff,filesize=filesize,nsects=nsects,
maxprot=maxprot,initprot=initprot)
elif cmd==0x2c:
if cmdsize < 24 or struct.unpack_from("<I",self.d,off+16)[0] != 0:
raise ValueError("加密 Mach-O 不支持改写或扫描")
off+=cmdsize
if off != self.hdr_size+self.sizeofcmds:
raise ValueError("load command 总长不一致")
def linkedit_pointers(self):
"""返回所有指向 __LINKEDIT 的 (命令名, 字段偏移绝对值, 当前值) 列表。"""
res=[]
for cmd,cmdsize,off in self.cmds:
def add(fieldoff,label):
v,=struct.unpack_from("<I",self.d,off+fieldoff)
if v: res.append((label,off+fieldoff,v))
if cmd in (LC_DYLD_INFO,LC_DYLD_INFO_ONLY):
for i,lab in enumerate(["rebase","bind","weak_bind","lazy_bind","export"]):
add(8+i*8,"dyld_info."+lab) # each has off(4)+size(4)
elif cmd==LC_SYMTAB:
add(8,"symtab.symoff"); add(16,"symtab.stroff")
elif cmd==LC_DYSYMTAB:
for fo,lab in [(32,"toc"),(40,"modtab"),(48,"extrefsym"),
(56,"indirectsym"),(64,"extrel"),(72,"locrel")]:
add(fo,"dysymtab."+lab)
elif cmd in (LC_FUNCTION_STARTS,LC_DATA_IN_CODE,LC_CODE_SIGNATURE,
LC_DYLD_CHAINED_FIXUPS,LC_DYLD_EXPORTS_TRIE,LC_SEGMENT_SPLIT_INFO):
add(8,{LC_FUNCTION_STARTS:"function_starts",LC_DATA_IN_CODE:"data_in_code",
LC_CODE_SIGNATURE:"code_signature",LC_DYLD_CHAINED_FIXUPS:"chained_fixups",
LC_DYLD_EXPORTS_TRIE:"exports_trie",LC_SEGMENT_SPLIT_INFO:"split_info"}[cmd])
return res
if __name__=="__main__":
import sys
m=Macho(bytearray(open(sys.argv[1],"rb").read()))
print(f"cputype={m.cputype:#x} ncmds={m.ncmds} sizeofcmds={m.sizeofcmds}")
print("padding for new LC =", min(s['fileoff'] for s in m.segs.values() if s['fileoff']>0 and s['nsects']>0) - (m.hdr_size+m.sizeofcmds))
for name,s in m.segs.items():
print(f" {name:14} vmaddr={s['vmaddr']:#012x} vmsize={s['vmsize']:#x} fileoff={s['fileoff']:#x} filesize={s['filesize']:#x} prot={s['initprot']}")
print("--- __LINKEDIT 指针 ---")
le=m.segs["__LINKEDIT"]
for lab,fo,v in m.linkedit_pointers():
inside = le['fileoff']<=v<le['fileoff']+le['filesize']
print(f" {lab:24} @{fo:#x} = {v:#x} {'(in LINKEDIT)' if inside else '!!OUTSIDE'}")