孤挺花(Armariris): LLVM混淆框架教程

孤挺花(Armariris): LLVM混淆框架教程

Armariris孤挺花（Armariris） -- 由上海交通大学密码与计算机安全实验室维护的LLVM混淆框架项目地址:https://gitcode.com/gh_mirrors/ar/Armariris

1. 项目介绍

孤挺花(Armariris) 是一个由上海交通大学密码与计算机安全实验室维护的LLVM混淆框架。该项目旨在提供一种跨平台和跨语言的代码混淆工具，增强程序的安全性。支持的功能包括字符串加密、控制流扁平化和指令替换。项目名称来源于细音启的小说《黄昏色的咏使》及《冰洁镜界的伊甸》中的人物孤挺花，象征着即使无人理解，仍然坚持保护重要事物的精神。

2. 项目快速启动

安装步骤

1. 创建工作目录并进入：

   mkdir obf
   cd obf
   

2. 克隆仓库：

   git clone git@github.com:GoSSIP-SJTU/Armariris.git
   

3. 使用CMake配置构建：

   cmake -DCMAKE_BUILD_TYPE:String=Release /Armariris
   

4. 编译项目：

   make -j4
   

使用示例

要启用不同的混淆选项，可以在编译时加入特定标志：

• 字符串加密：-mllvm -sobf
• 控制流扁平化：-mllvm -fla
• 指令替换：-mllvm -sub
• 设置随机种子：-mllvm -seed=0xdeadbeaf

例如，若要对一个名为my_project的项目进行混淆，编译命令可能是：

clang -O2 -target x86_64-linux-gnu -mllvm -sobf -mllvm -fla -mllvm -sub my_project.c -o my_project_obfuscated -mllvm -seed=0xdeadbeaf

3. 应用案例和最佳实践

• 在敏感信息处理的应用中，可以使用Armariris对存储在字符串中的秘密钥匙或API令牌进行加密。
• 为了提高代码安全性，特别是在发布开源软件时，可以使用控制流扁平化来增加逆向工程的难度。
• 对于关键算法或版权保护，利用指令替换来隐藏原始指令序列，使得分析更加困难。

最佳实践建议结合其他安全措施，如代码签名和动态检测，以形成全面的保护策略。

4. 典型生态项目

虽然Armariris专注于混淆功能，但与其他LLVM相关的项目一起使用可以加强整个开发流程的安全性。以下是一些典型生态项目：

• Clang: LLVM家族的一部分，作为C/C++/Objective-C的前端编译器，与Armariris配合使用能方便地整合混淆功能。
• LLVM Pass Manager: 用于插入自定义优化阶段，包括Armariris提供的混淆选项。
• Opt: LLVM的优化工具，可用于运行编译后的混淆代码的进一步优化。

通过集成这些工具，开发者可以建立一个强大的安全编码和部署环境。

Armariris孤挺花（Armariris） -- 由上海交通大学密码与计算机安全实验室维护的LLVM混淆框架项目地址:https://gitcode.com/gh_mirrors/ar/Armariris