152 lines
10 KiB
Markdown
152 lines
10 KiB
Markdown
# iOS 混淆加固工具(iOSGuard)技术全景与实现路线图
|
||
|
||
本路线图对标 **小蟹 iOS 混淆 (Crab iOS)** 核心架构与功能体系,针对 iOS 应用的 **App Store 过审差异化(应对 4.3 / 2.3.1 审查)** 和 **应用代码安全加固(防逆向 / 防 Dump / 防重打包)** 需求,制定从 0 到 1 的工程实现方案。
|
||
|
||
---
|
||
|
||
## 一、 系统架构全景
|
||
|
||
Crab iOS 并非单纯的源码文本替换工具,而是一套**“LLVM IR 级编译加固 + 源码预处理 + 运行时动态桥接 (COSDK) + 资产透明加密 + dSYM 逆向还原 + IPA 差异度度量”**的复合系统。
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
subgraph Input["输入工程"]
|
||
A1["Objective-C / Swift / C / C++ 源码"]
|
||
A2["Unity (IL2CPP) / Flutter (Dart) / Cocos"]
|
||
A3["资源文件 (.png / .storyboard / .bundle / .xcassets)"]
|
||
A4["静态依赖 (.a / static .framework / .xcframework)"]
|
||
end
|
||
|
||
subgraph PreProcess["源码与工程预处理层 (AST & Project Rewriter)"]
|
||
B1["PBXProject / xcconfig 自动化注入"]
|
||
B2["符号提取与静态分析 (AST Parsing)"]
|
||
B3["源码代码膨胀 (Junk Code / 假调用)"]
|
||
B4["Dart / Unity IL2CPP 前置特征擦除"]
|
||
end
|
||
|
||
subgraph CompilerPass["LLVM 编译级加固引擎 (Compiler Toolchain / Clang Plugin)"]
|
||
C1["字符串常量动态加密 Pass"]
|
||
C2["控制流平坦化 (Control Flow Flattening)"]
|
||
C3["虚假控制流 (Bogus Control Flow) 与指令替换"]
|
||
C4["Objective-C Selector / Method 加密 Pass"]
|
||
C5["防 Class-Dump 结构抹除"]
|
||
end
|
||
|
||
subgraph RuntimeBridge["运行时支撑框架 (COSDK)"]
|
||
D1["C API 拦截 (Fishhook: open, stat, access)"]
|
||
D2["ObjC Runtime 反射桥接 (NSClassFromString / sel_registerName)"]
|
||
D3["内存透明资源解密 (In-Memory Asset Decryption)"]
|
||
D4["随机特征签名隔离 (Per-Build Unique Fingerprint)"]
|
||
end
|
||
|
||
subgraph BinaryPostProcess["产物后处理与双符号表还原"]
|
||
E1["Mach-O 二进制混淆 (Section 混淆 / 符号 Strip)"]
|
||
E2["资源哈希混淆 (破坏文件哈希 / 元数据注入)"]
|
||
E3["双符号表数据库构建 (Mapping DB)"]
|
||
E4["dSYM 反向还原引擎 (适配 Bugly / Crashlytics / Sentry)"]
|
||
end
|
||
|
||
subgraph Analysis["质量与过审检测中心"]
|
||
F1["IPA 对比与特征相似度评估 (SSDEEP / AST Diff / 4.3 预检)"]
|
||
F2["Xcode Debug 联调辅助与符号映射支持"]
|
||
end
|
||
|
||
Input --> PreProcess
|
||
PreProcess --> CompilerPass
|
||
CompilerPass --> RuntimeBridge
|
||
CompilerPass --> BinaryPostProcess
|
||
RuntimeBridge --> BinaryPostProcess
|
||
BinaryPostProcess --> Analysis
|
||
```
|
||
|
||
---
|
||
|
||
## 二、 核心子系统关键技术方案
|
||
|
||
### 1. 语言与符号混淆子系统 (AST & LLVM)
|
||
* **符号重命名策略**:
|
||
* 支持类名 (Class)、分类名 (Category)、协议 (Protocol)、属性 (Property)、实例变量 (Ivar)、方法名/选择器 (Selector)、全局函数、结构体、枚举。
|
||
* **符号库隔离策略 (Symbol Profiles)**:维护不同的随机伪随机种子库与词典库,确保同一份源码使用不同策略编译出的符号特征完全隔离。
|
||
* **黑白名单排除机制**:支持系统 API 继承链自动穿透分析(如继承自 `UITableViewCell`、遵从 `NSCoding` 协议的类成员必须排除)、支持 KVC/JSON 反序列化(`YYModel` / `MJExtension`)通用规则排除。
|
||
* **常量与字符串加密 (LLVM IR Pass)**:
|
||
* 在 LLVM IR 阶段匹配全局字符串(`ConstantDataSequential`),将其替换为加密数组,并在每个函数入口或 `.init_array` / `+load` 动态解密,防止 IDA / Hopper 静态分析直接搜索到敏感 URL、Key 或特征字。
|
||
* **调用栈混淆与代码膨胀**:
|
||
* 插入多层蹦床代理函数(Trampoline Calls)、不透明谓词(Opaque Predicates)与无害控制流分支。
|
||
* 混淆调用栈(Call Stack),破坏调用拓扑,使得 Apple 静态代码相似度对比(AST 树结构比对)无法匹配。
|
||
|
||
### 2. 运行时拦截与支撑库 (COSDK)
|
||
* **动态反射修复**:
|
||
* 当符号被重命名后,运行时的动态反射调用(如 `NSClassFromString(@"UserViewController")`、`NSSelectorFromString(@"clickLogin:")`)默认会返回 `nil`。
|
||
* COSDK 注入动态映射表,使用 `fishhook` 拦截 C 运行时及 Method Swizzling 拦截 ObjC Runtime API:
|
||
* `objc_getClass` / `NSClassFromString`
|
||
* `NSStringFromClass` / `NSStringFromSelector`
|
||
* `sel_registerName` / `NSSelectorFromString`
|
||
* `class_getInstanceMethod` / `class_getMethodImplementation`
|
||
* 拦截后自动执行“原始符号 ↔ 混淆符号”的双向查表转换,保证业务反射逻辑完全正常。
|
||
* **SDK 每次打包特征隔离**:
|
||
* 运行时支撑库(COSDK)每次构建时动态随机命名库文件名、重构内部函数符号、生成随机校验密钥,防止 Apple 将加固 SDK 本身标记为“马甲包公共特征”。
|
||
|
||
### 3. 资源文件混淆与透明解密
|
||
* **资源名混淆与代码关联重写**:
|
||
* 提取 `.png`、`.jpg`、`.webp`、`.plist`、`.json`、`.sks` 等资源,生成混淆文件名(如 `a8f9b2c.png`)。
|
||
* 自动化遍历扫描与改写:
|
||
* 代码中的硬编码字符串 `[UIImage imageNamed:@"old_icon"]`。
|
||
* `.storyboard`、`.xib`、`.xcassets` 的引用关系。
|
||
* **文件哈希混淆 (Hash Distortion)**:
|
||
* 针对免加密的静态图片资源,修改 PNG 的自定义无用 Chunk(如增加 `tEXt` 随机注释)或尾部无害填充字节,确保文件 MD5/SHA256 改变,但图像显示完全一致。
|
||
* **深度资源加密与虚拟文件系统 Hook**:
|
||
* 资源采用高强度流加密(如 ChaCha20/AES-CTR)加密存放在 Bundle 中。
|
||
* 运行时在底层拦截 POSIX 文件 API:`open`、`fopen`、`stat`、`lstat`、`access` 以及 Cocoa 层 `[NSBundle pathForResource:ofType:]`、`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`,在内存流中即时解密,外部工具无法解压直接提取。
|
||
|
||
### 4. 双符号表策略与 dSYM 崩溃还原 (Crash Restoration)
|
||
* **痛点**:源码符号被混淆后,上架 App 产生的崩溃日志通过 Bugly、Firebase Crashlytics、Sentry 解析出来的全是一串乱码(如 `a8b9c()`),严重阻碍生产运维。
|
||
* **解决技术路径**:
|
||
1. 编译混淆时输出全局符号双向映射映射表:`mapping.json / mapping.db`(记录 `OriginalSymbol -> ObfuscatedSymbol` 及其签名、文件名)。
|
||
2. 生成两份 dSYM 文件:
|
||
* **混淆 dSYM**:匹配 App Store 提审的 Mach-O,用于苹果机审或基础定位。
|
||
* **还原工具 / 还原后的 dSYM**:读取原始 DWARF 调试节,利用 `llvm-dwarfdump` / 自研 DWARF 重构器,遍历 `.debug_info`、`.debug_str`,将里面的混淆符号批量替换回原始符号。
|
||
3. 还原后的 dSYM 可直接上传至 Bugly / Sentry,实现线上崩溃栈无感还原。
|
||
|
||
### 5. 跨跨端框架专项适配 (Flutter / Unity / Cocos)
|
||
* **Flutter / Dart**:
|
||
* Dart AOT 编译成 `App.framework` 中的快照(Snapshot 二进制代码段),传统 LLVM 无法直接处理 Dart 符号。
|
||
* 采用“Dart 源码前置 AST 处理”与“Dart 方法转发”方案,混淆 Dart 类名与方法名,并阻断 Dart 与原生通信的 MethodChannel 字符串特征。
|
||
* **Unity (IL2CPP)**:
|
||
* Unity 导出为 Xcode 工程后,核心 C# 代码已转为 C++(`Classes/Native` 目录)。
|
||
* 直接利用 C/C++ 语言混淆能力与控制流加固,对 IL2CPP 生成的 C++ 函数符号、元数据字符串表格、全局结构体进行混淆。
|
||
* **Cocos / Cocos2d-x / Quick-Cocos**:
|
||
* 混淆 C++ 底层驱动层,并对 JS/Lua 脚本资产进行加密打包与 Loader 注入解密。
|
||
|
||
### 6. 马甲包与 4.3 审核对抗分析器 (IPA Diff Tool)
|
||
* **Mach-O 静态分析**:分析 `__TEXT,__text` 段机器码相似度(采用 SSDEEP 模糊哈希、TLSH、SimHash)。
|
||
* **符号表相似度**:导出符号表(Exports / Imports / Objective-C Class Ro/Rw),计算 Jaccard 相似度。
|
||
* **资产重复度检测**:对比图片直方图、感知哈希(pHash)、结构相似度(SSIM)。
|
||
* **自动化生成风控报告**:量化输出与母包/前置版本的相似百分比,低于安全阈值(如 < 30% 相似度)方可提审。
|
||
|
||
---
|
||
|
||
## 三、 分阶段实施路线图 (Phase 1 ~ Phase 5)
|
||
|
||
| 阶段 | 周期 | 核心目标 | 交付产物 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| **Phase 1: 基础工程体系与基础符号/资源混淆 (MVP)** | 4~6 周 | 跑通 Xcode 工程解析、基础符号重命名、资源重命名与 Hash 扰动、简单的 ObjC 反射拦截 | 基础 CLI 工具、可混淆纯 ObjC/Swift 工程并在真机运行通过 |
|
||
| **Phase 2: LLVM 编译级加固核心 (定向加固)** | 6~8 周 | 搭建定制 Clang 插件/Toolchain,实现控制流平坦化、虚假控制流、常量字符串加密、防 Dump | 独立编译插件、集成至 Xcode Target 的加固能力 |
|
||
| **Phase 3: 运行时支撑 (COSDK) 与透明解密** | 4~6 周 | 完善动态库/静态库运行时 SDK,完成 C/ObjC API 全量 Hook,实现文件透明加解密 | 生产级 COSDK 库、动态特征重签名器 |
|
||
| **Phase 4: 双符号表 dSYM 还原与生态适配** | 4~6 周 | 攻克 DWARF 调试节符号还原、打通 Unity/Flutter/Cocos 适配流程 | dSYM 还原工具、跨跨端构建脚本与配置模板 |
|
||
| **Phase 5: IPA 相似度分析工具与桌面客户端** | 4~6 周 | 研发基于 Qt / Electron / SwiftUI 的跨平台客户端,集成 IPA 相似度比对引擎 | 桌面应用 (GUI)、完整商业化闭环、自动化测试套件 |
|
||
|
||
---
|
||
|
||
## 四、 核心技术难点与规避策略
|
||
|
||
1. **Apple 审核红线规避 (2.5.2 / 2.3.1 / 3.3.1)**
|
||
* 严禁引入已知的私有 API(Private Frameworks / Undocumented Selectors)。
|
||
* 严禁使用动态下载执行机器码(JIT / Dynamic Executable Memory)。
|
||
* 加固支撑库本身的代码特征必须**每次打包均动态生成**,避免成为苹果机审黑名单特征。
|
||
2. **Swift 静态派发与 Name Mangling 兼容**
|
||
* Swift 5+ 具备稳定的 ABI,符号名有严格的 Mangling 规则(如 `_$s...`)。
|
||
* 对 Swift 处理时,优先在 AST 层面或中间文件处理,并处理好 `@objc` 桥接方法与模块导出接口。
|
||
3. **运行时崩溃与第三方库冲突**
|
||
* 严禁盲目混淆第三方成熟开源库(如 AFNetworking, SDWebImage, Masonry 等),否则反而会增加相似度聚集特征,且极易引发系统调用崩溃。
|
||
* 必须内置智能扫描器,自动识别 Pods / Carthage / SPM 并建立默认豁免名单。
|