Files
iOSGuard/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
T

289 lines
21 KiB
Markdown
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.
# iOSGuard:企业级 iOS 加固与安全防护系统完整实现方案
---
## 方案定位与设计目标
本项目(代号 **iOSGuard**)融合 **小蟹加固(Crab iOS)** 的“App Store 审核对抗、差异化混淆、dSYM 崩溃还原”与 **网易易盾(NetEase YiDun)** 的“Mach-O 深度加固、原生代码虚拟化 (VMP)、全维度主动防御、无源码 IPA 二进制处理与跨平台重签名”能力,构建一套工业级双模加固平台:
1. **双加固入口**:
* **源码级加固(Compiler Pipeline)**:对接 Xcode,通过 LLVM Pass 实施深度混淆与代码虚拟化。
* **无源码 IPA 加固(Binary Pipeline)**:直接上传打好的 `.ipa` 包,由 Mach-O 重构引擎进行二进制级加固与自动重签名。
2. **零运行时破坏**:通过双符号表与 DWARF 重构技术,完全兼容 Bugly / Crashlytics / Sentry 等线上崩溃收集;通过智能反射桥接保证 KVC/JSON 反序列化零闪退。
3. **App Store 提审合规**:不依赖 JIT 动态内存分配,完全满足苹果 AMFI 代码签名、W^X 内存防护以及 App Review Guidelines 审核要求。
---
## 一、 系统总体架构与工作流
```mermaid
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 及动态库,插入防护逻辑。
* **关键算法与技术点**:
1. **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)与符号表偏移。
2. **新增私有防护段 (`__PROTECT`)**:
* 写入一个全新的 `LC_SEGMENT_64`,段名为 `__PROTECT`,权限设为 `VM_PROT_READ`。
* 确保其 `fileoff` 与 `vmaddr` 严格满足 `0x4000`(16KB)对齐。
* 用于存放抽取出的加密代码、加密 Objective-C 元数据及白盒秘钥表。
3. **修复 `LC_CODE_SIGNATURE` 边界**:
* 修改前先抹除旧签名指令,加固完成后将 `LC_CODE_SIGNATURE` 重新定位至文件尾部。
### 2. Class-Dump 彻底防御与动态重映射 (Metadata Protector)
* **模块目标**:让 `class-dump`、`dscli`、IDA、Hopper 无法导出任何业务类名、属性名和方法名。
* **加固实现链路**:
1. **静态扫描与元数据序列化**:
* 定位 `__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` 段。
2. **Mach-O 元数据清洗与置空**:
* 将 `__TEXT,__objc_methname` 节内的所有 ASCII 字符串重置为 `\0` 或覆盖为伪造的无害字符(如系统库常见名称)。
* 将 `class_ro_t` 的 `baseMethods` 指针置为 `NULL`,或指向一个仅包含假初始化方法的假列表。
3. **运行时受控动态还原 (Dynamic Relocation)**:
* 守护库 `libDefender.dylib` 注册在 Mach-O 的 `LC_LOAD_DYLIB` 列表最顶部,拥有最优先加载权。
* 在 `+load` 执行前的 `__mod_init_func`(C++ 全局构造器阶段):
1. 从 `__PROTECT` 内存段解密元数据;
2. 遍历类对象,调用 Objective-C 底层 API(如 `class_addMethod`)或直接在内存中修正 `class_rw_t` 的方法切片(Method Slice);
3. 建立内存映射快速索引表,确保 `objc_msgSend` 消息分发完全正常。
### 3. 原生代码虚拟化 (VMP) 引擎 (Code Virtualization)
* **模块目标**:对抗 IDA/Ghidra 反编译,将关键 ARM64 机器码逻辑编译或抽取为自定义私有字节码,通过内嵌解释器执行。
* **架构设计**:
```
原始 ARM64 函数逻辑 ===> [ VMP Compiler ] ===> 私有字节码 (Bytecode Stream)
+
[ VM 解释器状态机 (C/汇编) ]
```
* **核心组件设计**:
1. **私有指令集设计 (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` 代表加法)。
2. **上下文栈帧与寄存器映射 (Context Simulation)**:
* 定义 `VMContext` 结构体,模拟通用寄存器(`X0`~`X30`)、栈指针(`SP`)、状态标志寄存器(`NZCV`)。
* 当进入加固函数时,跳板代码(Trampoline)将真实 CPU 寄存器压入栈,并将其值拷贝至 `VMContext`。
3. **纯解释型分发器(不破坏 W^X 合规红线)**:
* 严禁调用 `mprotect(PROT_EXEC)`。
* 采用 **Direct-Threaded Code(直接线程代码 / 间接跳转表)** 循环:
```c
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++]
// ... 寄存器状态机流转 ...
}
```
### 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()`),严重影响线上问题排查。
* **实现方案**:
1. **构建双向映射数据库 (`mapping.sqlite` / `mapping.json`)**:
* 记录格式:`{ MD5(Raw_Signature): { raw_name: "LoginManager", obfuscated_name: "a7c2d8", type: "class", file: "LoginManager.m" } }`。
2. **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。
### 6. 资源与游戏资产保护 (Assets & Game Protection)
1. **静态免加密文件 Hash 扰动**:
* 针对 PNG:向 PNG 插入合规私有 chunk(如 `tEXt` 注入随机 UUID),MD5 彻底改变,渲染完全正常。
* 针对 MP3/MP4/PDF:文件末尾追加随机长度的填充字节(Padding)。
2. **深度资源透明加密与虚拟文件系统 Hook**:
* 加密算法:ChaCha20-Poly1305。
* Hook 拦截层:
* 底层 C API(POSIX):`open`、`fopen`、`stat`、`lstat`、`read`、`fread`(基于 `fishhook`)。
* Cocoa 框架层:`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`、`[NSBundle pathForResource:ofType:]`(基于 Method Swizzling)。
* 拦截后在内存中执行无落盘解密(In-Memory Decryption),外部工具解压 IPA 只能看到乱码文件。
3. **Unity 与 Cocos 专项防护**:
* **Unity IL2CPP**:加密 `global-metadata.dat`,Hook `il2cpp::vm::MetadataCache::Initialize()` 动态解密;对 `Classes/Native` 的 C++ 符号深度平坦化。
* **Cocos**:对 `src` 目录下的 LuaJIT 字节码或 JS 脚本添加自定义文件头混淆,Hook 引擎底层 `FileUtils::getDataFromFile`。
### 7. 跨平台自动化重签名流水线 (Cross-Platform Signer Engine)
* **模块目标**:支持在 **macOS(本地终端)** 与 **Linux/Docker(SaaS 云端服务器)** 两种环境下全自动完成加固后 IPA 的重签名。
* **签名核心算法实现流程 (严格顺序)**:
```mermaid
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` 证书私钥,手动构建完整的 Apple `SuperBlob` 二进制数据结构。
### 8. IPA 相似度预检中心 (App Store 4.3 预检器)
* **模块目标**:在提审前评估加固包与母包(或老版本)的相似度,规避 App Store 4.3 / 2.3.1 拒审。
* **算法度量指标**:
1. **代码段模糊哈希(SSDEEP / TLSH)**:提取主 Mach-O `__TEXT,__text` 段,计算基于上下文触发分段哈希(CTPH),比对机器码序列相似度。
2. **符号表 Jaccard 相似系数**:计算两包之间导出的类名、方法名集合交并比:$J(A, B) = \frac{|A \cap B|}{|A \cup B|}$。
3. **资源感知哈希(pHash & SSIM)**:对所有图片计算感知哈希与结构相似性,检测图片指纹重合度。
4. **内部风控基准评分**:内部相似度 $< 35\%$ 判定为低相似度;$35\% \sim 50\%$ 建议调换混淆特征库;$> 50\%$ 建议内部阻断提审。(注:苹果 4.3 条款为人工审查与机审结合的行为政策,指标仅作内部风控参考,不构成绝对过审保证)。
---
## 三、 工程代码组织与目录结构 (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)
```
---
## 四、 实施路线图与阶段性交付物
```mermaid
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);<br>2. **注入约束**:仅在 Header Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入(空间不足直接拒绝,不盲目平移);<br>3. **依赖与路径**:物理嵌入 `libDefender.dylib` 至 `Payload/App.app/Frameworks/`,解析并验证 `@rpath` 依赖链;<br>4. **签名验证**:使用 macOS 原生 `codesign`(带 `--generate-entitlement-der`);<br>5. **真机闭环**:验证真机安装、冷启动通过、`libDefender` 基础合规反调试生效、制造崩溃并跑通 dSYM 符号化还原。 | 1. 自建 arm64 测试工程<br>2. `libDefender.dylib` 最小原型<br>3. 原地注入脚本与重签流水线<br>4. 真机冷启与崩溃还原验证报告 |
| **M2: Mach-O 进阶加固与重定位修复** | 5 周 | 1. 攻克全局段平移(Segment Shift)与 `LC_DYLD_CHAINED_FIXUPS` 重定位链表重构;<br>2. 实施 Objective-C 元数据精细化抽取与 ASLR 动态还原;<br>3. 验证 Linux 端 `zsign` 无 Mac 依赖签名闭环。 | 1. 支持段平移的 `macho_rewriter`<br>2. 保持语义的 `objc_scrambler`<br>3. Linux Docker 自动化签名工具 |
| **M3: LLVM 编译管线与 dSYM 深度还原** | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass;<br>2. 完善 DWARF 重写工具,确保 UUID 严格匹配。 | 1. Xcode 自定义 LLVM Toolchain / Plugin<br>2. `dsym_restorer` 崩溃堆栈还原器 |
| **M4: 原生代码虚拟化 (VMP) 与游戏加固** | 6 周 | 1. 完善基于 ARM64 的私有解释型虚拟机 (VMP),补充边界安全检查与异常退出;<br>2. 实现 Unity `global-metadata.dat` 加密与 Cocos 脚本内存流解密。 | 1. 包含安全防御的 `vmp_compiler` 与 `vm_interpreter`<br>2. Unity / Cocos 游戏专用加固套件 |
| **M5: 4.3 审核预检与商业化平台** | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的内部风控评分算法;<br>2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 | 1. `ipa_diff` 相似度检测中心<br>2. 完整的商业级加固发布包 |