A comprehensive Linux Privilege-Escalation Benchmark

This is a simple benchmark for linux privilege escalation attacks, i.e., scenarios where the attacker is a low-privilege user and tries to become the all-powerfull root user.

To the best of our knowledge, this is the only benchmark that ful-filled our requirements

• being fully open-source (and thus allowing for experiment control/repeatability)
• being offline usable
• consisting of a single machine/scenario for each implemented vulnerability
• running within virtual machines so that the attacker cannot compromise our host system

Please check our paper to find more information about how this benchmark came to be, it's history, etc.

If you are using this benchmark for academic work, please help us by citing us:

@misc{happe2024got,
      title={Got Root? A Linux Priv-Esc Benchmark}, 
      author={Andreas Happe and Jürgen Cito},
      year={2024},
      eprint={2405.02106},
      archivePrefix={arXiv},
      primaryClass={cs.CR}
}

How to start in GitHub CodeSpaces

When creating your codespace, you should see:

Setting up remote connection: Building codespace...

Click "Building codespace..." to execute command '_codespaces.viewCreationLog' and watch it execute codespaces_create_and_start_containers.sh

In GitHub Codespaces, you don't need to run create_and_start_vms.sh

Feel free to run tests now...

How to start the Benchmark Suite using VMs

For easy use, we provide the create_and_start_vms.sh script which:

• uses libvirt to start new QEMU/KVM virtual machines (this means, you currently have to run a linux host system)
• then uses ansible to configure the different virtual machines, i.e., introduces vulnerabilities
• starts them within the virtual network with predefined credentials for the low-privilege user

All images have the same credentials:

• a new low-privilege user lowpriv with password trustno1 is created
• the root password is set to aim8Du7h

Enjoy!

How to start the Benchmark Suite using Docker

If you prefer Docker over VMs, the docker/ folder provides scripts to build images, start/stop containers, and run tests:

./docker/build.sh    # build all scenario images
./docker/start.sh    # start containers (pass a scenario name to start only one)
./docker/stop.sh     # stop containers (pass a name to stop only one)
./docker/test.sh     # run exploitability tests

Each container listens on 127.0.0.1 ports 5001–5013 for scenarios 01–13.

This approach allows you to quickly spin up and tear down isolated environments for each scenario, making it easy to test and develop without the overhead of managing VMs. The Docker setup is especially useful for users who want a lightweight, reproducible environment or are not running a Linux host.

Supported Linux Priv-Escalation Vulnerabilities

Currently we support some single-step (i.e., simple to exploit, do not need to be combined) priv-esc vulnerabilities:

Setup Instructions

This depends upon the following packages being installed

• ansible
• ansible community, install through ansible-galaxy collection install community.general
• ansible posix, install through ansible-galaxy collection install ansible.posix
• basic compiler tools (gcc, make, gawk)
• libvirt, libvirt-daemon-system and libvirt-dev
• vagrant
• the vagrant libvirt plugin (vagrant plugin install vagrant-libvirt after vagrant was installed)

Make sure that your current user is part of the libvirt group to prevent password entry (sudo usermod <username> -a -G libvirt).

Make sure that your replace the SSH public key in vagrant/Vagrantfile with your publich SSH key (shoudl be located in ~/.ssh/id_rsa.pub).

With that you should be able to call ./create_and_start_vms.sh

How to contribute additional testcases?

We are more than happy to add new test-cases, to do this please

• look at tasks.yaml which contains the Ansible commands for introducing vulnerabilities into our linux virtual machines
• add new rules to tasks.yaml
• create pull request (: thank you!