10 KiB
10 KiB
iOS 混淆加固工具(iOSGuard)技术全景与实现路线图
本路线图对标 小蟹 iOS 混淆 (Crab iOS) 核心架构与功能体系,针对 iOS 应用的 App Store 过审差异化(应对 4.3 / 2.3.1 审查) 和 应用代码安全加固(防逆向 / 防 Dump / 防重打包) 需求,制定从 0 到 1 的工程实现方案。
一、 系统架构全景
Crab iOS 并非单纯的源码文本替换工具,而是一套**“LLVM IR 级编译加固 + 源码预处理 + 运行时动态桥接 (COSDK) + 资产透明加密 + dSYM 逆向还原 + IPA 差异度度量”**的复合系统。
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 或特征字。
- 在 LLVM IR 阶段匹配全局字符串(
- 调用栈混淆与代码膨胀:
- 插入多层蹦床代理函数(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/NSClassFromStringNSStringFromClass/NSStringFromSelectorsel_registerName/NSSelectorFromStringclass_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 改变,但图像显示完全一致。
- 针对免加密的静态图片资源,修改 PNG 的自定义无用 Chunk(如增加
- 深度资源加密与虚拟文件系统 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()),严重阻碍生产运维。 - 解决技术路径:
- 编译混淆时输出全局符号双向映射映射表:
mapping.json / mapping.db(记录OriginalSymbol -> ObfuscatedSymbol及其签名、文件名)。 - 生成两份 dSYM 文件:
- 混淆 dSYM:匹配 App Store 提审的 Mach-O,用于苹果机审或基础定位。
- 还原工具 / 还原后的 dSYM:读取原始 DWARF 调试节,利用
llvm-dwarfdump/ 自研 DWARF 重构器,遍历.debug_info、.debug_str,将里面的混淆符号批量替换回原始符号。
- 还原后的 dSYM 可直接上传至 Bugly / Sentry,实现线上崩溃栈无感还原。
- 编译混淆时输出全局符号双向映射映射表:
5. 跨跨端框架专项适配 (Flutter / Unity / Cocos)
- Flutter / Dart:
- Dart AOT 编译成
App.framework中的快照(Snapshot 二进制代码段),传统 LLVM 无法直接处理 Dart 符号。 - 采用“Dart 源码前置 AST 处理”与“Dart 方法转发”方案,混淆 Dart 类名与方法名,并阻断 Dart 与原生通信的 MethodChannel 字符串特征。
- Dart AOT 编译成
- Unity (IL2CPP):
- Unity 导出为 Xcode 工程后,核心 C# 代码已转为 C++(
Classes/Native目录)。 - 直接利用 C/C++ 语言混淆能力与控制流加固,对 IL2CPP 生成的 C++ 函数符号、元数据字符串表格、全局结构体进行混淆。
- Unity 导出为 Xcode 工程后,核心 C# 代码已转为 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)、完整商业化闭环、自动化测试套件 |
四、 核心技术难点与规避策略
- Apple 审核红线规避 (2.5.2 / 2.3.1 / 3.3.1)
- 严禁引入已知的私有 API(Private Frameworks / Undocumented Selectors)。
- 严禁使用动态下载执行机器码(JIT / Dynamic Executable Memory)。
- 加固支撑库本身的代码特征必须每次打包均动态生成,避免成为苹果机审黑名单特征。
- Swift 静态派发与 Name Mangling 兼容
- Swift 5+ 具备稳定的 ABI,符号名有严格的 Mangling 规则(如
_$s...)。 - 对 Swift 处理时,优先在 AST 层面或中间文件处理,并处理好
@objc桥接方法与模块导出接口。
- Swift 5+ 具备稳定的 ABI,符号名有严格的 Mangling 规则(如
- 运行时崩溃与第三方库冲突
- 严禁盲目混淆第三方成熟开源库(如 AFNetworking, SDWebImage, Masonry 等),否则反而会增加相似度聚集特征,且极易引发系统调用崩溃。
- 必须内置智能扫描器,自动识别 Pods / Carthage / SPM 并建立默认豁免名单。