Files
iOSGuard/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
T

21 KiB
Raw Blame History

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 审核要求。

一、 系统总体架构与工作流

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(直接线程代码 / 间接跳转表) 循环:
        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 的重签名。
  • 签名核心算法实现流程 (严格顺序):
    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)

四、 实施路线图与阶段性交付物

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_rewriter
2. 保持语义的 objc_scrambler
3. 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_interpreter
2. Unity / Cocos 游戏专用加固套件
M5: 4.3 审核预检与商业化平台 4 周 1. 实现基于 SSDEEP 与符号图谱的内部风控评分算法;
2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。
1. ipa_diff 相似度检测中心
2. 完整的商业级加固发布包