ROPfuscator is a research proof of concept and is not intended for production use. The authors do not take any responsibility or liability for the use of the software. Please exercise caution and use at your own risk.
ROPfuscator is a fine-grained code obfuscation framework for C/C++ programs using ROP (return-oriented programming). ROPfuscator obfuscates a program at the assembly code level by transforming regular instructions into ROP chains, thwarting our natural conception of normal control flow. It is implemented as an extension to LLVM (10.0.1) x86 backend.
For build, usage and implementation, see individual documents:
- Building ROPfuscator: build.md
- Using ROPfuscator to obfuscate programs: usage.md
- Obfuscation algorithm details: algorithm.md
- Implementation details: implementation.md
This project aims to provide an improved version of ROPfuscator with a strong focus on reproducibility and ease of integration. We have made several key enhancements in this repository, as outlined below.
ROPfuscator now leverages Nix, a powerful declarative package manager that allows for reliable and reproducible builds. Nix provides several benefits:
- Ensures dependencies and build environments are consistent across systems.
- Allows for isolated build environments, eliminating conflicts with other installed packages.
- Supports rollbacks to previous package versions, making it easier to recover from failed updates.
ROPfuscator provides a Nix flake exposing ROPfuscator's stdenv
s and various helper functions used to natively compile Nix derivations, without applying any modification to the build system of the project to be built.
The evaluation process has been rewritten from scratch, taking full advantage of the Nix package manager. This ensures a more reliable and transparent evaluation, which will be the foundation for future work on ROPfuscator.
ROPfuscator can now transparently attempt to obfuscate any package present in the upstream Nix package repository, nixpkgs, without requiring any modifications. This allows Nix users to seamlessly integrate ROPfuscator into their existing workflows and test its capabilities.
ROPfuscator can target a single project, obfuscating only the object files pertinent to the project itself, or it can obfuscate the target along with all its dependencies.
Please note that the evaluation code present in this repository has not been used to produce any artifact. The original evaluation from the deprecated repository is still valid and it is used in the original white paper, published at the WOOT workshop.
Install Nix (the package manager) and make sure that its daemon is running.
Flakes allow you to specify your code's dependencies in a declarative way and they allow to easily specify inputs and outputs for projects. ROPfuscator exposes different outputs hence we need to enable Nix to use flakes.
Here is a step-by-step process on how to enable them.
This step allows leveraging ROPfuscator's cache repository to avoid recompiling the project and all its dependencies from scratch. This step is optional but recommended.
To enable ROPfuscator's cache, first install cachix
:
nix-env -iA cachix -f https://cachix.org/api/v1/install
Then, configure nix.conf
to use the binary cache:
cachix use ropfuscator
The final step is to build ROPfuscator. This can be achieved by invoking:
nix build github:ropfuscator/ropfuscator -L
If you want to drop in a shell configured to use ROPfuscator by default, just invoke:
nix shell github:ropfuscator/ropfuscator
We combine the following obfuscation layers to achieve robust obfuscation against several attacks.
- ROP Transformation
- Convert each instruction into one or more ROP gadgets, and translate the entire code to ROP chains.
- Opaque Predicate Insertion
- Translate ROP gadget address(es) and stack pushed values into opaque constants, which are composition of multiple opaque predicates.
- Linux 32-bit x86 binaries are the only supported target (as of now)
- For detailed limitations, see limitation.md.
We encourage collaboration and are open to discussing potential extensions or improvements to the project. If you are interested in contributing, please reach out to us or open an issue.
Thank you for your support!