Pentest Environment Deployer |

This repo provides an easy way to deploy a clean and customized pentesting environment with Kali linux using vagrant and virtualbox.

Requirements

I assume you are familiar with virtualbox and vagrant.

• https://www.virtualbox.org/
• http://www.vagrantup.com/

Latest pentest-env release is tested with:

• Virtualbox (6.0.4)
• Vagrant (2.2.3)

Current box

Kali 2018.1

See the documentation page about boxes for more details.

See also others available instances.

Getting started

To get started with pentest-env, clone this repository and run vagrant up inside the directory. This will download and run the Kali instance.

You can customize, add targets, create new targets etc.. inside pentest-env. Some examples are available in the examples/ directory, to use one simply set the PENTESTRC environment variable:

> PENTESTRC=examples/ctf.pentestrc vagrant status
Current machine states:

kali                      running (virtualbox)
metasploitable2           not created (virtualbox)
primer                    not created (virtualbox)

This environment represents multiple VMs. The VMs are all listed
above with their current state. For more information about a specific
VM, run `vagrant status NAME`.

For more details, visit the documentation pages:

1. Installation
2. Usage
3. Docker
4. Openstack
5. Customizations
6. Instances
7. Targets
8. Write custom instances and targets
9. Debugging
10. Security
11. About boxes
12. Known issues

Some configuration examples:

1. Configure Kali linux with Tor & proxychains
2. Configure Kali linux with Whonix gateway
3. Faraday cscan against metasploitable 2 & 3 targets
4. Configure a Teamserver

Target examples:

1. Basic Chef environment
2. Simple & insecure Kubernetes cluster

About Security

verify checksums

It's recommended to check downloaded box files with provided checksums (SHA256).
See https://raw.githubusercontent.com/Sliim/pentest-env/master/checksums.txt for checksums list.

sshd is running

Provided boxes run the sshd service.
So if you plan to run the Kali linux with a Bridged interface, default setup can be dangerous!

• root password of kali is toor.
• SSH private key is not private! Anyone can use this key to connect to your instance.

See the secure the environment page to automatically change these defaults values.

Shared folders symlinks

I recommend to disable SharedFoldersEnableSymlinksCreate which are enabled by default by vagrant.

More details and source in the Security/Disable SharedFoldersEnableSymlinksCreate section.

Related projects

Here is some projects you can build and integrate easily with pentest-env.

• Metasploitable3 - https://github.com/rapid7/metasploitable3/
• DetectionLab - https://github.com/clong/DetectionLab
• DanderSpritz-Lab - https://github.com/francisck/DanderSpritz_lab

License

See COPYING file