21 KiB
21 KiB
iOSGuard:企业级 iOS 加固与安全防护系统完整实现方案
方案定位与设计目标
本项目(代号 iOSGuard)融合 小蟹加固(Crab iOS) 的“App Store 审核对抗、差异化混淆、dSYM 崩溃还原”与 网易易盾(NetEase YiDun) 的“Mach-O 深度加固、原生代码虚拟化 (VMP)、全维度主动防御、无源码 IPA 二进制处理与跨平台重签名”能力,构建一套工业级双模加固平台:
- 双加固入口:
- 源码级加固(Compiler Pipeline):对接 Xcode,通过 LLVM Pass 实施深度混淆与代码虚拟化。
- 无源码 IPA 加固(Binary Pipeline):直接上传打好的
.ipa包,由 Mach-O 重构引擎进行二进制级加固与自动重签名。
- 零运行时破坏:通过双符号表与 DWARF 重构技术,完全兼容 Bugly / Crashlytics / Sentry 等线上崩溃收集;通过智能反射桥接保证 KVC/JSON 反序列化零闪退。
- App Store 提审合规:不依赖 JIT 动态内存分配,完全满足苹果 AMFI 代码签名、W^X 内存防护以及 App Review Guidelines 审核要求。
一、 系统总体架构与工作流
flowchart TD
subgraph Input["1. 输入层 (Input)"]
In1["源码工程 (Xcode / Flutter / Unity / Cocos)"]
In2["已打包无源码 IPA (Binary Input)"]
In3["开发者证书与描述文件 (.p12 / .mobileprovision)"]
end
subgraph Pipeline["2. 加固调度核心流水线 (Guard Orchestrator)"]
P1["工程解析与 xcconfig / Build Phase 自动化注入"]
P2["IPA 解包与 Mach-O 静态解构器"]
P3["加固策略配置路由器 (Rules & Exclusions Engine)"]
end
subgraph Engines["3. 核心加固与对抗引擎"]
direction TB
E1["Mach-O 二进制重构器\n(Header扩容 / 段平移 / LC_LOAD_DYLIB 注入)"]
E2["Class-Dump 彻底抹除\n(__objc_methname 清空 / 动态重映射)"]
E3["代码虚拟化 (VMP) 引擎\n(ARM64 抽离 / 自定义字节码 / 解释器)"]
E4["LLVM 编译混淆 Pass\n(控制流平坦化 / 虚假分支 / 字符串加密)"]
E5["主动防御内核 (Defender Core)\n(SVC内联反调试 / 反Hook / 反Frida / 越狱感知)"]
E6["资源与游戏资产保护\n(PNG Hash扰动 / 深度透明解密 / Unity IL2CPP)"]
end
subgraph RestoreAndSign["4. 恢复与重签发布引擎"]
R1["双符号表与 dSYM 崩溃逆向还原 (DWARF 重写)"]
R2["跨平台重签名流水线 (Linux zsign / macOS codesign, DER 支持)"]
R3["IPA 4.3 相似度静态预检 (SSDEEP / 符号比对 / 风险报告)"]
end
subgraph Output["5. 交付产物 (Output)"]
Out1["加固且重签名后 IPA (可直接提审 / 分发)"]
Out2["还原后 dSYM 文件 (上传崩溃分析平台)"]
Out3["加固与安全审计报告 (PDF / HTML)"]
end
Input --> Pipeline
Pipeline --> Engines
Engines --> RestoreAndSign
RestoreAndSign --> Output
二、 八大核心子系统详细实现方案
1. Mach-O 深度重构与二进制引擎 (Mach-O Rewriter)
- 模块目标:在不依赖源码的前提下,解析并重写 IPA 主 Mach-O 及动态库,插入防护逻辑。
- 关键算法与技术点:
- Header 扩容与段平移算法:
- 读取
mach_header_64,计算sizeofcmds。 - 检测
load_commands结束位置与首个 Section(通常为__TEXT,__text)之间的空白填充(Padding)。 - 若 Padding $\ge sizeof(dylib_command)$,直接原地追加
LC_LOAD_DYLIB指令,并递增ncmds和sizeofcmds。 - 若 Padding 不足,触发全局平移(Segment Shift):将首个 Section 起始偏移向后推移一个页面对齐大小(ARM64 为
0x4000/ 16KB),递归修复所有后续 Segment/Section 的fileoff、offset,以及重定位表、导出树(Export Trie)与符号表偏移。
- 读取
- 新增私有防护段 (
__PROTECT):- 写入一个全新的
LC_SEGMENT_64,段名为__PROTECT,权限设为VM_PROT_READ。 - 确保其
fileoff与vmaddr严格满足0x4000(16KB)对齐。 - 用于存放抽取出的加密代码、加密 Objective-C 元数据及白盒秘钥表。
- 写入一个全新的
- 修复
LC_CODE_SIGNATURE边界:- 修改前先抹除旧签名指令,加固完成后将
LC_CODE_SIGNATURE重新定位至文件尾部。
- 修改前先抹除旧签名指令,加固完成后将
- Header 扩容与段平移算法:
2. Class-Dump 彻底防御与动态重映射 (Metadata Protector)
- 模块目标:让
class-dump、dscli、IDA、Hopper 无法导出任何业务类名、属性名和方法名。 - 加固实现链路:
- 静态扫描与元数据序列化:
- 定位
__DATA,__objc_classlist段,遍历每个objc_class结构体,沿着指针提取class_ro_t:const char *name(类名)method_list_t *baseMethods(方法列表:包含SEL name,const char *types,IMP imp)ivar_list_t *ivars、property_list_t *baseProperties、protocol_list_t *baseProtocols
- 扫描
__TEXT,__objc_methname、__TEXT,__objc_classname。 - 将这些数据序列化为私有二进制格式,使用 ChaCha20-Poly1305 加密存入
__PROTECT段。
- 定位
- Mach-O 元数据清洗与置空:
- 将
__TEXT,__objc_methname节内的所有 ASCII 字符串重置为\0或覆盖为伪造的无害字符(如系统库常见名称)。 - 将
class_ro_t的baseMethods指针置为NULL,或指向一个仅包含假初始化方法的假列表。
- 将
- 运行时受控动态还原 (Dynamic Relocation):
- 守护库
libDefender.dylib注册在 Mach-O 的LC_LOAD_DYLIB列表最顶部,拥有最优先加载权。 - 在
+load执行前的__mod_init_func(C++ 全局构造器阶段):- 从
__PROTECT内存段解密元数据; - 遍历类对象,调用 Objective-C 底层 API(如
class_addMethod)或直接在内存中修正class_rw_t的方法切片(Method Slice); - 建立内存映射快速索引表,确保
objc_msgSend消息分发完全正常。
- 从
- 守护库
- 静态扫描与元数据序列化:
3. 原生代码虚拟化 (VMP) 引擎 (Code Virtualization)
- 模块目标:对抗 IDA/Ghidra 反编译,将关键 ARM64 机器码逻辑编译或抽取为自定义私有字节码,通过内嵌解释器执行。
- 架构设计:
原始 ARM64 函数逻辑 ===> [ VMP Compiler ] ===> 私有字节码 (Bytecode Stream) + [ VM 解释器状态机 (C/汇编) ] - 核心组件设计:
- 私有指令集设计 (Custom IR / ISA):
- 设计约 30~45 条紧凑指令:
VM_NOP,VM_LOAD,VM_STORE,VM_ADD,VM_SUB,VM_XOR,VM_CMP,VM_JMP,VM_JZ,VM_CALL,VM_RET等。 - 操作码(Opcode)每次构建随机重映射(例如构建 A 中
0x1A代表加法,构建 B 中0x7F代表加法)。
- 设计约 30~45 条紧凑指令:
- 上下文栈帧与寄存器映射 (Context Simulation):
- 定义
VMContext结构体,模拟通用寄存器(X0~X30)、栈指针(SP)、状态标志寄存器(NZCV)。 - 当进入加固函数时,跳板代码(Trampoline)将真实 CPU 寄存器压入栈,并将其值拷贝至
VMContext。
- 定义
- 纯解释型分发器(不破坏 W^X 合规红线):
- 严禁调用
mprotect(PROT_EXEC)。 - 采用 Direct-Threaded Code(直接线程代码 / 间接跳转表) 循环:
void VM_Execute(VMContext *ctx, const uint8_t *bytecode) { static const void *dispatch_table[] = { &&do_nop, &&do_load, &&do_add, ... }; #define DISPATCH() goto *dispatch_table[*pc++] // ... 寄存器状态机流转 ... }
- 严禁调用
- 私有指令集设计 (Custom IR / ISA):
4. 全维度内核级主动防御对抗矩阵 (Defender Core)
- 模块目标:以静态库或注入动态库形式驻留进程,全面压制逆向与动态分析工具。
- 五大防御维度实现细节:
主动防御矩阵 (Defender Core)
├── 1. 内核级反调试 (Anti-Debug)
│ ├── 内联汇编 SVC 0x80 调用 ptrace(PT_DENY_ATTACH, 0, 0, 0)
│ ├── sysctl 轮询检查 kinfo_proc.kp_proc.p_flag 包含 P_TRACED
│ ├── 硬件断点探测:thread_get_state 获取 ARM_DEBUG_STATE64,比对 bvr/bcr 寄存器
│ └── Mach 异常端口劫持:task_set_exception_ports 抢占 EXC_BREAKPOINT / EXC_BAD_ACCESS
├── 2. 反 Hook 与反 Frida (Anti-Hook & Anti-Frida)
│ ├── 扫描加载模块:_dyld_get_image_name 校验是否存在 frida-agent, CydiaSubstrate, Dobby
│ ├── 检测默认端口 (27042) 与探测本地 loopback 反向 socket 连接
│ ├── 线程检测:遍历 task_threads,检测线程名为 "gum-js-loop"、"gmain"
│ ├── 函数头 Inline Hook 探测:校验关键函数(open, ptrace, exit)前 16 字节是否包含 "LDR PC, [PC, #0]" 或 "BR X16"
│ └── GOT 表边界检测:校验 __la_symbol_ptr / __got 内函数指针是否位于合法 Dyld Shared Cache 内存空间
├── 3. 越狱与沙盒感知 (Anti-Jailbreak)
│ ├── 特征路径扫描:/Applications/Cydia.app, /bin/sh, /usr/sbin/sshd, /var/jb 等
│ ├── 沙盒逃逸写入探测:尝试向 /private/jailbreak_test 写入文件
│ ├── 环境变量检查:getenv("DYLD_INSERT_LIBRARIES")
│ └── 内核限制探测:调用 fork(),未越狱沙盒环境必返回 -1 (errno=EPERM)
├── 4. 内存完整性保护 (Anti-Patch)
│ ├── 运行时读取 Mach-O 的 __TEXT,__text 内存页
│ └── 计算 SHA256 模糊哈希并与静态基线比对,防止内存被动态打补丁 (Memory Patch)
└── 5. 白盒密码学 (Whitebox Cryptography)
└── 实现白盒 AES-128 / SM4 算法,将密钥彻底融合至预计算查找表 (LUT),防止内存 Dump Key
5. 双符号表体系与 dSYM 崩溃逆向还原 (Dual-Symbol & Crash Restorer)
- 痛点:加固导致线上崩溃日志(Sentry / Bugly / Crashlytics)堆栈全为无意义字符(如
_a8f9bc71()),严重影响线上问题排查。 - 实现方案:
- 构建双向映射数据库 (
mapping.sqlite/mapping.json):- 记录格式:
{ MD5(Raw_Signature): { raw_name: "LoginManager", obfuscated_name: "a7c2d8", type: "class", file: "LoginManager.m" } }。
- 记录格式:
- DWARF 调试文件反向重写引擎 (dSYM Restorer):
- 解析 Release 构建生成的原始
App.app.dSYM中的 Mach-O(DWARF 结构)。 - 解析
.debug_info节中的编译单元(Compilation Units)和调试信息条目(DIE)。 - 解析
.debug_str(字符串池)与.debug_line(行号状态机)。 - 建立 DWARF 字符串重映射管道,将里面的混淆名批量替换回
raw_name。 - 产出无缝还原后的
Restored_App.app.dSYM,直接上传至 Bugly/Sentry。
- 解析 Release 构建生成的原始
- 构建双向映射数据库 (
6. 资源与游戏资产保护 (Assets & Game Protection)
- 静态免加密文件 Hash 扰动:
- 针对 PNG:向 PNG 插入合规私有 chunk(如
tEXt注入随机 UUID),MD5 彻底改变,渲染完全正常。 - 针对 MP3/MP4/PDF:文件末尾追加随机长度的填充字节(Padding)。
- 针对 PNG:向 PNG 插入合规私有 chunk(如
- 深度资源透明加密与虚拟文件系统 Hook:
- 加密算法:ChaCha20-Poly1305。
- Hook 拦截层:
- 底层 C API(POSIX):
open、fopen、stat、lstat、read、fread(基于fishhook)。 - Cocoa 框架层:
[NSData dataWithContentsOfFile:]、[UIImage imageNamed:]、[NSBundle pathForResource:ofType:](基于 Method Swizzling)。
- 底层 C API(POSIX):
- 拦截后在内存中执行无落盘解密(In-Memory Decryption),外部工具解压 IPA 只能看到乱码文件。
- Unity 与 Cocos 专项防护:
- Unity IL2CPP:加密
global-metadata.dat,Hookil2cpp::vm::MetadataCache::Initialize()动态解密;对Classes/Native的 C++ 符号深度平坦化。 - Cocos:对
src目录下的 LuaJIT 字节码或 JS 脚本添加自定义文件头混淆,Hook 引擎底层FileUtils::getDataFromFile。
- Unity IL2CPP:加密
7. 跨平台自动化重签名流水线 (Cross-Platform Signer Engine)
- 模块目标:支持在 macOS(本地终端) 与 Linux/Docker(SaaS 云端服务器) 两种环境下全自动完成加固后 IPA 的重签名。
- 签名核心算法实现流程 (严格顺序):
sequenceDiagram autonumber participant Runner as 签名调度器 participant Prov as Mobileprovision 与 Entitlements 协调 participant Dylibs as Frameworks/PlugIns (内部组件) participant Res as CodeResources 资源清单 participant MachO as 主可执行文件 Header 与 CodeDirectory participant CMS as OpenSSL 签名核 Runner->>Prov: 解析 embedded.mobileprovision 提取授权范围 Runner->>Prov: 协调生成目标所需 Entitlements (XML + DER 编码) Runner->>Dylibs: 先行签名内部 Frameworks/*.dylib 与 *.framework Runner->>Dylibs: 先行签名 PlugIns/*.appex (独立 Entitlements 与 BundleID) Runner->>Res: 扫描 Bundle 全部文件生成 _CodeSignature/CodeResources Runner->>MachO: 预先计算 SuperBlob 大小,在 Header 预设 LC_CODE_SIGNATURE (dataoff=codeLimit, datasize=blob_size) Runner->>MachO: 将 CodeResources 的 SHA256 填入 CodeDirectory Slot -3 (极关键) Runner->>MachO: 将 Info.plist、Entitlements 哈希填入 Slot -1, -2, -5, -7 Runner->>MachO: 按 16KB 页面计算 0..codeLimit 范围内的代码页 SHA256 填入 Slot 0..N Runner->>CMS: 传入完整的 CodeDirectory 序列化字节数据,由 OpenSSL 生成 PKCS#7 签名 Runner->>MachO: 组装 SuperBlob (包含 0, 2, 5, 7, 0x10000 槽位) 回写至 dataoff 偏移 Runner->>Runner: 重新打包为 Payload 结构并压缩为 .ipa - 跨平台工具选型:
- macOS 环境:直接调用系统
codesign -f -s ... --entitlements ... --generate-entitlement-der。 - Linux / Docker 环境:集成自研 C++ 签名模块(基于
zsign内核改造),使用 OpenSSL 3.0 解析.p12证书私钥,手动构建完整的 AppleSuperBlob二进制数据结构。
- macOS 环境:直接调用系统
8. IPA 相似度预检中心 (App Store 4.3 预检器)
- 模块目标:在提审前评估加固包与母包(或老版本)的相似度,规避 App Store 4.3 / 2.3.1 拒审。
- 算法度量指标:
- 代码段模糊哈希(SSDEEP / TLSH):提取主 Mach-O
__TEXT,__text段,计算基于上下文触发分段哈希(CTPH),比对机器码序列相似度。 - 符号表 Jaccard 相似系数:计算两包之间导出的类名、方法名集合交并比:$J(A, B) = \frac{|A \cap B|}{|A \cup B|}$。
- 资源感知哈希(pHash & SSIM):对所有图片计算感知哈希与结构相似性,检测图片指纹重合度。
- 内部风控基准评分:内部相似度
< 35\%判定为低相似度;35\% \sim 50\%建议调换混淆特征库;> 50\%建议内部阻断提审。(注:苹果 4.3 条款为人工审查与机审结合的行为政策,指标仅作内部风控参考,不构成绝对过审保证)。
- 代码段模糊哈希(SSDEEP / TLSH):提取主 Mach-O
三、 工程代码组织与目录结构 (Repository Layout)
iOSGuard/
├── bin/ # 编译输出的可执行文件 (cli, zsign-mod)
├── core/ # 核心 C/C++ / Rust 跨平台加固引擎
│ ├── macho/ # Mach-O 解析与重构器
│ │ ├── macho_parser.cpp # Header, Load Commands, Section 解析
│ │ ├── macho_rewriter.cpp # Header扩容、段平移、LC_LOAD_DYLIB 注入
│ │ └── macho_align.cpp # 0x4000 页面对齐校准
│ ├── metadata/ # Objective-C 元数据清洗与加密
│ │ ├── objc_extractor.cpp # 抽取 __objc_classlist, class_ro_t
│ │ └── objc_scrambler.cpp # 符号置空与加密段生成
│ ├── vmp/ # 原生代码虚拟化引擎
│ │ ├── vmp_compiler.cpp # 汇编 -> 私有字节码翻译器
│ │ ├── vmp_isa.h # 私有指令集定义
│ │ └── vm_interpreter.c # 运行时解释器状态机
│ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展)
│ ├── codesign_engine.cpp# CodeDirectory, SuperBlob, CMS 构建
│ ├── der_encoder.cpp # DER-encoded Entitlements 编码器
│ └── resource_signer.cpp# _CodeSignature/CodeResources 生成器
├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
│ ├── anti_debug/ # 内联 SVC 汇编、硬件断点轮询
│ ├── anti_hook/ # Inline Hook 校验、Dyld GOT 范围比对
│ ├── anti_frida/ # 端口探测、线程扫描、动态库匹配
│ ├── anti_jailbreak/ # 沙盒感知、fork 检测、关键路径
│ ├── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
│ └── dynamic_loader/ # 元数据内存解密与动态注册 (+load 前执行)
├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode)
│ ├── Flattening.cpp # 控制流平坦化 Pass
│ ├── BogusControlFlow.cpp # 虚假控制流 Pass
│ ├── StringEncryption.cpp # 常量字符串加密 Pass
│ └── CallStackObfuscate.cpp # 调用栈蹦床代理 Pass
├── tools/ # 辅助工具链
│ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
│ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
│ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入
├── cli/ # 命令行交互工具 (Go / Python 实现)
└── web/ # SaaS 云端管理后台 (前端 Vue / 后端 Go)
四、 实施路线图与阶段性交付物
flowchart LR
M1["里程碑 1 (MVP)\nPadding充足下注入\n+ macOS 原生签名闭环"] --> M2["里程碑 2\n段平移与Fixup修复\n+ ObjC 动态元数据恢复"]
M2 --> M3["里程碑 3\nLLVM 编译混淆\n+ dSYM 崩溃符号化还原"]
M3 --> M4["里程碑 4\n代码虚拟化 (VMP)\n+ 游戏资产保护"]
M4 --> M5["里程碑 5\n4.3 预检分析器\n+ 商业平台化"]
| 阶段 | 周期 | 研发重点与技术验证 | 关键交付产物 |
|---|---|---|---|
| M1: 极简闭环验证 (MVP 收敛范围) | 3~4 周 | 1. 目标载体:自有简单 arm64 测试 App(UIKit/SwiftUI); 2. 注入约束:仅在 Header Padding 充足条件下验证 LC_LOAD_DYLIB 原地注入(空间不足直接拒绝,不盲目平移);3. 依赖与路径:物理嵌入 libDefender.dylib 至 Payload/App.app/Frameworks/,解析并验证 @rpath 依赖链;4. 签名验证:使用 macOS 原生 codesign(带 --generate-entitlement-der);5. 真机闭环:验证真机安装、冷启动通过、 libDefender 基础合规反调试生效、制造崩溃并跑通 dSYM 符号化还原。 |
1. 自建 arm64 测试工程 2. libDefender.dylib 最小原型3. 原地注入脚本与重签流水线 4. 真机冷启与崩溃还原验证报告 |
| M2: Mach-O 进阶加固与重定位修复 | 5 周 | 1. 攻克全局段平移(Segment Shift)与 LC_DYLD_CHAINED_FIXUPS 重定位链表重构;2. 实施 Objective-C 元数据精细化抽取与 ASLR 动态还原; 3. 验证 Linux 端 zsign 无 Mac 依赖签名闭环。 |
1. 支持段平移的 macho_rewriter2. 保持语义的 objc_scrambler3. Linux Docker 自动化签名工具 |
| M3: LLVM 编译管线与 dSYM 深度还原 | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass; 2. 完善 DWARF 重写工具,确保 UUID 严格匹配。 |
1. Xcode 自定义 LLVM Toolchain / Plugin 2. dsym_restorer 崩溃堆栈还原器 |
| M4: 原生代码虚拟化 (VMP) 与游戏加固 | 6 周 | 1. 完善基于 ARM64 的私有解释型虚拟机 (VMP),补充边界安全检查与异常退出; 2. 实现 Unity global-metadata.dat 加密与 Cocos 脚本内存流解密。 |
1. 包含安全防御的 vmp_compiler 与 vm_interpreter2. Unity / Cocos 游戏专用加固套件 |
| M5: 4.3 审核预检与商业化平台 | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的内部风控评分算法; 2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 |
1. ipa_diff 相似度检测中心2. 完整的商业级加固发布包 |