Files

10 KiB
Raw Permalink Blame History

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 或特征字。
  • 调用栈混淆与代码膨胀:
    • 插入多层蹦床代理函数(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 并建立默认豁免名单。