shenleiandClaude Opus 4.8 b76d7cdc21 harden(defender): docs/18 §7 抗静态分析硬化(符号隐藏/串混淆/副本分散/基线派生)
针对「纯客户端抗静态分析」的最高性价比项落地,守在 tests/test_static_hardening.py(6 条,gate 于 iphoneos SDK):

- 符号隐藏 + strip(§7.0 新增):IGVisibility.h 定 IG_INTERNAL=hidden,全库
  -fvisibility=hidden;仅四入口 ig_defender_scan/ig_poison_init/ig_poison_apply/
  ig_policy_scan_and_mark 标 IG_PUBLIC 保持导出,其余 ig_* 变 private external,
  链接后 strip -x 彻底消失——攻击者 nm 不再能按名定位 ig_poison_mark/mask 去 NOP。
- §7.1 串混淆:gen_jb_paths.py(唯一真源)生成 IGJailbreakPaths.inc /
  IGInjectSignatures.inc(XOR keystream,两表不共享 key),运行期解码进栈、用完擦除;
  decode 内 volatile key 屏障阻止 -O2 把常量折叠回 __const 明文。strings 已捞不到
  /var/jb、Cydia、substrate、gum-js-loop 等。--check 守 .inc 与清单同步。
- §7.2 副本分散:g_h0/h1/h2 置于不相邻命名段 __DATA,__ig_p0/p1/p2,加 __ig_pd 诱饵
  (mask 不读);刻意不用 TLS(会破坏跨线程毒化一致性)。
- §7.4 基线派生:删硬编码 0xA5C3F10E7B2D4968,改 ig_poison_baseline() 由拆分种子经
  volatile 屏障派生;otool -tV 已无旧魔数立即数。
- §7.3 OLLVM/VMP:仅留 build 的 IG_OBFUSCATOR hook,stock clang 无能力,需另备工具链(未完成)。
- §7.5 越狱设备正向验证仍阻塞(无设备)。

构建/快照同步:build_defender_lib.sh 加 -fvisibility=hidden + gen --check + IG_OBFUSCATOR
hook;build_poison_device.py 快照纳入 *.inc。全量 69 测试通过;poison_device.m 全模块
iphoneos 交叉编译通过(arm64)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 10:47:35 +09:00

iOSGuard - 企业级 iOS 加固与安全防护系统

反 HOOK 正向验证(2026-11-12):step11 真机 HOOK 正向验证完成,11/11 用例通过:真实 GOT 重绑定(fishhook 同款)、蹦床序言(B/LDR+BR)、frida 特征线程名、Documents 注入 dylib、ObjC 方法 IMP 基线替换在 iPhone 16 Plus(iOS 27.2,非越狱)全部命中对应 reason;DYLD_INSERT_LIBRARIES 真实 dyld 注入双命中 202+200。同轮新增调试器跟踪探针(reason=300)与 ObjC IMP 基线探针(reason=110)并接入聚合扫描。宿主测试 62 项通过。见 真机 HOOK 正向验证。同日完成 readoor-test Swift 策略层整改(110/300 分级、越狱终止改经策略统一处置、debuggerDetected 接入探针证据)与登录/VIP/激活敏感入口门禁推广,构建通过;随后完成业务 App 内 C 探针副本同步(IGObjCBaseline 入副本与聚合接线,IGSyscall/IGAntiDebug 按合规物理排除)、Swift 侧 ObjC 基线登记(模块前缀解析,2/2 登记)与真机双向业务验证:干净启动零误报,DYLD_INSERT 真实注入双命中 202+200 判「加固锁定」且进程按白名单存活(证据 docs/evidence/20261112-readoor-inject-console.log)。强制模式各入口按钮级拦截回归仍待执行。

观察包进度(2026-11-11):SSZipArchive 动态绑定保护试点已在指定词书真机解压中命中四个文件函数,874 次转发无拒绝,9 个输出文件的聚合摘要与同构建基线一致,页面、正常缓存、返回重进及前后台恢复通过。59 项宿主/工具测试通过;真机攻击正向验证尚未完成。PDF 修复、完整业务回归和报告复测继续暂缓。见 SSZipArchive 保护试点。

当前状态(2026-11-10):已完成 ZipZap write/close 三层防护试点:链接后定点改写、运行时解析与间接调用、Defender 调度完整性检查。readoor31 Release 构建、44 项自动化测试及 8 项独立真机诊断通过,本轮两处改写后整包直接调用为 558→556。详见 三层试点与证据。前一轮 v2.199.0 IPA 的 28 项测试与 878→0 仍保留为独立基线,两轮产物不同。尚未完成完整 App 真机业务回归和 V4.6.6 复测;不能宣称报告问题全部解决。下文能力表仍属于规划,不代表各项均已实现或验证。

当前主线:面向 iOS App 反 Hook 与安全加固,以 readoor 的 ECNUP 外语安全报告为首个验收案例。报告分析、源码核查、实施顺序及复测标准见 readoor 漏洞报告分析与加固实施方案。当前优先级以该方案为准;既有文档中的审核差异化、VMP、元数据重构等内容保留为远期研究。

Platform License Architecture

iOSGuard 是一套融合了 小蟹加固 (Crab iOS) 与 网易易盾 (NetEase YiDun) 核心能力的企业级 iOS 应用安全加固与对抗系统。 支持 “源码工程编译期深度混淆” 与 “无源码 IPA 纯二进制后处理加固” 双模形态,满足 App Store 审核对抗(防 4.3 / 2.3.1 拒审)、核心代码防逆向防反编译、反外挂反调试、游戏与核心资产保护等多维需求。


🌟 核心特性概览

模块 核心能力 对标产品
Mach-O 深度重构 Header 动态扩容、段全局平移、LC_LOAD_DYLIB 守护库注入、0x4000 严格页面对齐 网易易盾 / 顶象
Class-Dump 彻底防御 抹除 __objc_methname、__objc_classname,动态解密重构 class_rw_t 网易易盾 / 爱加密
原生代码虚拟化 (VMP) ARM64 汇编抽离、私有紧凑字节码转换、合规纯解释型虚拟机(不破坏 W^X) 网易易盾 / 梆梆安全
LLVM 编译加固 Pass 控制流平坦化 (Fla)、虚假控制流 (BCF)、常量字符串动态加密、调用栈蹦床代理 小蟹加固 / OLLVM / Hikari
全维度主动防御 (Defender) 内联汇编 SVC 0x80 反调试、ARM64 硬件断点 (DR0-DR7) 探测、反 Frida、反 Inline/GOT Hook、沙盒越狱感知 网易易盾
双符号表与崩溃还原 编译期记录 mapping.db,重构 DWARF 调试节,无缝兼容 Bugly / Sentry / Crashlytics 小蟹加固
资产与游戏安全 免加密文件 Hash 扰动、ChaCha20 流式透明解密、Unity global-metadata.dat 与 Cocos Lua/JS 保护 小蟹加固 / 网易易盾
跨平台自动化重签名 支持 macOS (codesign) 与 Linux/Docker (zsign 改造内核),强制支持 iOS 15+ DER 规范 企业自动化流水线
4.3 审核预检分析器 基于 SSDEEP 模糊哈希的 Mach-O 机器码比对、符号集 Jaccard 相似度、图片 pHash 差异度评分 小蟹加固

📂 项目模块结构

iOSGuard/
 ├── docs/                        # 详细设计与实现方案文档
 │    ├── 01_ROADMAP.md           # 小蟹加固路线与技术全景
 │    ├── 02_SECURITY_ARCHITECTURE.md # 易盾级安全加固架构深度剖析
 │    └── 03_COMPLETE_IMPLEMENTATION_PLAN.md # 完整工程实现蓝图与技术规范
 ├── core/                        # 核心 C/C++ 跨平台加固引擎
 │    ├── macho/                  # Mach-O 解析与重构器 (Header扩容 / 段平移 / 对齐)
 │    ├── metadata/               # Objective-C 元数据清洗与加密 (防 Class-Dump)
 │    ├── vmp/                    # 原生代码虚拟化编译器与虚拟机解释引擎
 │    └── signer/                 # 跨平台重签名核心 (基于 zsign 扩展,支持 DER)
 ├── defender/                    # 注入的运行时防护库源码 (输出 libDefender.dylib)
 │    ├── anti_debug/             # 内联汇编 SVC 系统调用反调试、硬件断点轮询
 │    ├── anti_hook/              # Inline Hook 前向指令探测、Dyld GOT 范围校验
 │    ├── anti_frida/             # Frida 端口探测、线程扫描、动态库匹配
 │    ├── anti_jailbreak/         # 沙盒感知、fork 检测、特征路径探测
 │    └── vfs_crypto/             # 资源透明解密 Hook (open/read/imageNamed)
 ├── llvm-plugins/                # 源码加固 LLVM Pass (集成至 Xcode 自定义 Toolchain)
 │    ├── Flattening/             # 控制流平坦化 Pass
 │    ├── BogusControlFlow/       # 虚假控制流 Pass
 │    ├── StringEncryption/       # 常量字符串加密 Pass
 │    └── CallStackObfuscate/     # 调用栈伪装与蹦床代理 Pass
 ├── tools/                       # 辅助工具链
 │    ├── dsym_restorer/          # dSYM 崩溃逆向还原工具 (DWARF 重写)
 │    ├── ipa_diff_analyzer/      # IPA 4.3 相似度静态评估分析器
 │    └── pbx_injector/           # Xcode 工程配置与 Build Phase 自动化注入脚本
 ├── cli/                         # 命令行终端工具
 └── README.md                    # 本文件

📖 技术文档导航

详细技术实现细节与数学/算法推导请参阅 docs/ 目录:

  1. 小蟹路线与技术全景:包含符号策略、资源 Hash 扰动、COSDK 运行时反射修复与 dSYM 崩溃还原体系。
  2. 易盾安全防护架构方案:包含代码虚拟化 (VMP)、全维度主动防御底层汇编、游戏资产防护与白盒加密。
  3. 完整工程实现蓝图:包含八大子系统详细设计规范、Mach-O 段平移算法、跨平台签名时序与里程碑规划。

🚀 研发里程碑规划

  • M1 (第 1~4 周,极简闭环 MVP):自建 arm64 测试工程 + Padding 充足条件下验证 LC_LOAD_DYLIB 原地注入 + 物理嵌入 libDefender.dylib 与 @rpath 解析 + macOS 原生 codesign 重签名 + 真机冷启/基础合规反调试/崩溃符号化全流程闭环验证。
  • M2 (第 5~9 周,进阶加固与重定位修复):全局段平移(Segment Shift)与 LC_DYLD_CHAINED_FIXUPS 修复 + Objective-C 元数据精细化抽取与 ASLR 动态恢复 + Linux 端 zsign 无 Mac 依赖签名闭环。
  • M3 (第 10~14 周,LLVM 混淆与 dSYM 还原):控制流平坦化、字符串加密 Pass + DWARF 定点重写与线上崩溃还原。
  • M4 (第 15~20 周,代码虚拟化与游戏安全):原生纯解释型 VMP 虚拟机 + 完整内存/指令边界防御 + Unity IL2CPP / Cocos 加密保护。
  • M5 (第 21~24 周,4.3 预检与平台化):SSDEEP 相似度分析工具 + 内部风控度量体系 + CLI 命令行与商业控制台交付。

⚖️ 苹果审核与合规声明

  1. AMFI 与 W^X 合规:本系统代码虚拟化 (VMP) 采用纯解释型虚拟机,不申请可执行内存(无 mprotect(PROT_EXEC)),严格遵守苹果 W^X 内存安全规范。
  2. 公开 API 提审合规 (Guideline §2.5.1):App Store 提审版本中通过宏开关物理排除所有私有未公开符号(如 iPhoneOS SDK 未包含的 ptrace 相关调用)及裸汇编 syscall,仅依赖公开文档支持的 sysctl 调试检测;内核级汇编软中断与 PT_DENY_ATTACH 严格限制于企业内部分发 (Enterprise) / Ad-Hoc 场景。
  3. 签名标准化:重签名引擎严格遵从苹果 iOS 15+ DER-encoded Entitlements 与 CodeDirectory 16KB 分页哈希规范,保证 App Store 提审解签正常。
S
Description
No description provided
Readme
427 KiB