Skip to content

README.md

Latest commit

 

History

History
122 lines (85 loc) · 4.63 KB

README.md

File metadata and controls

122 lines (85 loc) · 4.63 KB

ollvm-pass

IRvana Integration

To integrate obfuscation and OLLVM passes over IR generated, the ollvm-pass project was leveraged: https://github.com/0xlane/ollvm-rust

This plugin was built and supports LLVM 18.1.5 under the hood. The ollvm-pass project has been integrated into IRvana and reorganized under the following directory structure:

├── OLLVM/
|   |   └── vs_build --> Build files for OLLVM DLL
|   |   |   └── ollvm-pass.sln --> Visual Studio project to recompile OLLVM DLL
|   |   |   └── obfuscation\Release\LLVMObfuscationx.dll --> Precompiled OLLVM DLL

A Visual Studio solution is included for quick reference along with a precompiled version of the plugin. If you wish to recompile the obfuscation DLL from source, follow the steps below:

## Generate Build Files
IRvana> cd OLLVM
IRvana\OLLVM> cmake -G "Visual Studio 17 2022" -S .\ollvm-pass -B .\build ^
  -DCMAKE_CXX_STANDARD=17 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DBUILD_SHARED_LIBS=ON ^
  -DLT_LLVM_INSTALL_DIR=C:\IRvana\LLVM-18.1.5\

## Build the DLL
IRvana\OLLVM> cmake --build .\build --config Release

## Integrate with IRvana
IRvana\OLLVM> del vs_build  
IRvana\OLLVM> move build vs_build

Replace C:\IRvana\LLVM-18.1.5\ with your actual LLVM installation path.

Official Readme

Out-of-tree llvm obfuscation pass，可在编译时对二进制进行混淆，通过 rustc/opt 动态加载使用，无需重新编译 llvm 和 rustc，支持以下混淆方式：

  • 间接跳转,并加密跳转目标(-irobf-indbr)
  • 间接函数调用,并加密目标函数地址(-irobf-icall)
  • 间接全局变量引用,并加密变量地址(-irobf-indgv)
  • 字符串(c string)加密功能(-irobf-cse) （rust 中不生效，已知问题）
  • 过程相关控制流平坦混淆(-irobf-cff)
  • 全部 (-irobf-indbr -irobf-icall -irobf-indgv -irobf-cse -irobf-cff)

混淆插件提取自 Arkari 项目。

注意：该项目当前仅在 windows x86 下测试，其他平台未测试

effect.png

rust 动态加载

动态加载 llvm pass 插件需切换到 nightly 通道（Allow loading of LLVM plugins [when dynamically built rust]）：

rustup toolchain install nightly

生成一个示例项目，通过 -Zllvm-plugins 参数加载 pass 插件，并通过 -Cpasses 参数指定混淆开关：

cargo new helloworld --bin
cd helloworld
cargo +nightly rustc --target x86_64-pc-windows-msvc --release -- -Zllvm-plugins="/path/to/LLVMObfuscationx.dll" -Cpasses="irobf(irobf-indbr,irobf-icall,irobf-indgv,irobf-cff,irobf-cse)"

opt 动态加载

# 使用 clang 编译源代码并生成 IR
clang -emit-llvm -c input.c -o input.bc

# 使用 opt 工具加载和运行自定义 Pass
opt -load-pass-plugin="/path/to/LLVMObfuscationx.dll" --passes="irobf(irobf-indbr,irobf-icall,irobf-indgv,irobf-cff,irobf-cse)" input.bc -o output.bc

# 将 IR 文件编译为目标文件
llc -filetype=obj output.bc -o output.o

# 链接目标文件生成可执行文件
clang output.o -o output.exe

x86 msvc pass 编译方法

环境

  • Windows 11 (10.0.22631.3737)
  • Visual Studio 2022 (17.10.3)
    • 使用 C++ 的桌面开发
  • LLVM 18.1.5

编译

需在 x64 Native Tools Command Prompt for VS 2022 环境中执行，从开始菜单或者执行 cmd.exe /k "C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat" -startdir=none -arch=x64 -host_arch=x64 进入：

git clone --branch ollvm-pass https://github.com/0xlane/ollvm-rust.git
cd ollvm-rust
cmake -G "Ninja" -S .\ollvm-pass -B .\build -DCMAKE_CXX_STANDARD=17 -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON -DLT_LLVM_INSTALL_DIR=D:\dev\rust_ollvm\llvm-build\llvm_x64
cmake --build .\build\ -j12 # change 12 to yourself nproc

LT_LLVM_INSTALL_DIR 需指定为自己的 LLVM 安装路径

参考

感谢