WiFiChallengeLab-docker

Docker version of WiFiChallenge Lab with modifications in the challenges and improved stability. Ubuntu virtual machine with virtualized networks and clients to perform WiFi attacks on OPN, WPA2, WPA3 and Enterprise networks.

Changelog from version v1.0

The principal changes from version 1.0.5 to 2.0.3 are the following.

• Remove Nested VMs. Replaced with Docker
• Add new attacks and modify the existent to make them more real
  • WPA3 bruteforce and downgrade
  • MGT Multiples APs
  • Real captive portal evasion (instead of just MAC filtering)
  • Phishing client with fake website.
• Eliminating the WPS pin attack as it is outdated, unrealistic, and overly simplistic.
• Use Ubuntu as SO instead of Debian
• Use vagrant to create the VM to be easy to replicate
• More Virtual WiFi adapters
  • More APs
  • More clients
• Monitorization and detection using nzyme WIDS.

Install

Using the VM

Download the VM for VMWare or VirtualBox:

• GitHub releases
• Proton Drive

Docker inside a Linux host

Download the repository and start the docker with the APs, the clients and nzyme for alerts.

git clone https://github.com/r4ulcl/WiFiChallengeLab-docker
cd WiFiChallengeLab-docker
docker-compose up -d --file docker-compose.yml

Create your own VM using vagrant

Requirements

• A Linux host with at least 4 CPU cores and 4 GB of RAM.
• docker
• docker-compose

Create the VM with vagrant

git clone https://github.com/r4ulcl/WiFiChallengeLab-docker
cd WiFiChallengeLab-docker
cd vagrant

Edit file vagrantfile memory and CPU to your needs.

nano vagrantfile

If you want a VMWare VM:

vagrant up vmware_vm 

And for a VirtualBox VM:

vagrant up virtualbox_vm 

Usage

Attack from Ubuntu VM

• The tools are installed and can be found in the tools folder of the root home.
• There are 7 antennas available, wlan0 to wlan6.
• Do not disturb mode can be disabled with the following command.

Attack from Host

• Start the docker-compose.yml file and use the virtual WLAN.
• Use your own tools and configurations to attack.

Attack from Docker Attacker

• TODO

Modify config files

To modify the files you can download the repository and edit both APs and clients (in the VM the path is /var/WiFiChallenge). The files are divided by APs, Clients, and Nzyme files.

Recompile Docker

To recreate the Docker files with the changes made, modify the docker-compose.yml file by commenting out the "image:" line in each Docker and uncommenting the line with "build:". Then use "docker-compose build" to create a new version.

Support this project

Buymeacoffee

License

GNU General Public License v3.0