Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blackhillsinfosec/Wifi-Forge
WifiForge is a tool developed by Black Hills InfoSec to help train Pentesters on different Wi-Fi attack vectors and Wireless capabilities.
https://github.com/blackhillsinfosec/Wifi-Forge
aircrack-ng-pentest aircrack-ng-tutorial airgeddon arpspoof artificial-intelligence docker dockerfile hacking john-the-ripper kali linux pentesting wifi wifi-hacking wifi-pineapple wifi-security wifiphisher wireless-hacking
Last synced: about 2 months ago
JSON representation
WifiForge is a tool developed by Black Hills InfoSec to help train Pentesters on different Wi-Fi attack vectors and Wireless capabilities.
- Host: GitHub
- URL: https://github.com/blackhillsinfosec/Wifi-Forge
- Owner: blackhillsinfosec
- License: mit
- Created: 2024-05-15T14:43:45.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-07-15T16:27:42.000Z (6 months ago)
- Last Synced: 2024-11-16T17:18:21.017Z (2 months ago)
- Topics: aircrack-ng-pentest, aircrack-ng-tutorial, airgeddon, arpspoof, artificial-intelligence, docker, dockerfile, hacking, john-the-ripper, kali, linux, pentesting, wifi, wifi-hacking, wifi-pineapple, wifi-security, wifiphisher, wireless-hacking
- Language: Python
- Homepage:
- Size: 8.82 MB
- Stars: 64
- Watchers: 5
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wi-Fi Forge
Wi-Fi Forge provides a safe and legal environment for learning WiFi hacking. Based on the open source [Mininet-Wifi](https://github.com/intrig-unicamp/mininet-wifi/tree/master?tab=readme-ov-file), this project automatically sets up the networks and tools needed to run a variety of WiFi exploitation labs, removing the need for the overhead and hardware normally required to perform these attacks.
## Disclaimer/Notes
- The installation script will only run on Ubuntu, Debian, Fedora, or Kali.
- It is suggested to run Wifi Forge on Ubuntu version 14.04 or the lastest version of Kali.
- The Wifi Forge installation script may disrupt normal operating system use, it is suggested to use a fresh install, virtual machine, or build using the provided dockerfile (see Set-Up Guide/Docker)
## Compatibility
Wifi-Forge should work on any linux operating system using the docker image. The following Operating Systems have been tested and are confirmed to work.
Kali Linux
Parrot OS
Ubuntu
## Set-Up Guide
Note: As of June, pulling from Dockerhub is the most up-to-date version of wififorge. Installing from any other method (including building directly from the Dockerfile) will not guarantee a stable release.
### Docker (recommended)
Note: Dockerfile will fail if mininet-wifi is already installed locally
#### Install from release (best option)
1. Pull image from dockerhub
```bash
sudo docker pull redblackbird/wififorge:v1.0.0
```
2.. Start a new container
```bash
sudo docker run --privileged=true -it --env="DISPLAY" --env="QT_X11_NO_MITSHM=1" -v /tmp/.X11-unix:/tmp/.X11-unix:rw -v /sys/:/sys -v /lib/modules/:/lib/modules/ --name mininet-wifi --network=host --hostname mininet-wifi redblackbird/wififorge:v1.0.0 /bin/bash
```
3.. Within docker, initiate the controller to simulate APs
```bash
RUN service openvswitch-switch start
```
4.. Run wififorge.py
```bash
sudo python3 Framework/WifiForge.py
```
#### Build from Dockerfile
1. Install Docker
```bash
sudo snap install docker
```
2. Clone the repository
```bash
git clone https://github.com/her3ticAVI/Wifi-Forge
```
3. Run the Dockerfile (may take up to 10 minutes)
```bash
sudo docker build -t wififorge .
```
4. Start a new container (command should automatically initiate a docker shell)
```bash
sudo docker run --privileged=true -it --env="DISPLAY" --env="QT_X11_NO_MITSHM=1" -v /tmp/.X11-unix:/tmp/.X11-unix:rw -v /sys/:/sys -v /lib/modules/:/lib/modules/ --name mininet-wifi --network=host --hostname mininet-wifi wififorge /bin/bash
```
5. Within docker, initiate the controller to simulate APs
```bash
RUN service openvswitch-switch start
```
6. Within docker, run WifiForge.py
```bash
sudo python3 Framework/WifiForge.py
```
### Build from Source
NOTE: While the setup script is generally stable, running the auto installer directly on your machine may disrupt your operating system in a way that renders it unusable.
1. Clone the repository
```bash
git clone https://github.com/her3ticAVI/Wifi-Forge
```
2. Run setup.sh
```bash
cd Wifi-Forge/Framework/
sudo ./setup.sh
```
2. Run Wi-Fi Forge
```bash
sudo python3 WifiForge.py
```
## Labs and Featured Tools
Wi-Fi Forge provides pre-built labs that cover the following:
- Evil twin AP
- WEP PIN Recovery
- WPA2 4 Way Handshake
- WPS Pixie Attacks
- WifiPhisher
- Eaphammer
- etc...
## Common Issues
### Xterm does not work!
Intializing graphical interfaces as root between the docker image and host machine is restricted on most modern distributions. Run the following command to provide the appropriate permissions -
```bash
xhost si:localuser:root
```
If other issues are encountered, start a thread in the issues section of the repo! :)
### Dockerfile stops at apt update!
Once in a while, the dockerfile will fail before installing packages. Though unconfirmed, this error usually occurs after running Wifi-forge (either on baremetal or within a docker). Rebooting and running the Dockerfile again typically solves the issue.
## Links and Further Reading
- https://mininet-wifi.github.io/
- [https://www.hackingarticles.in/wireless-penetration-testing-pmkid-attack/](https://www.hackingarticles.in/wireless-penetration-testing-pmkid-attack/)
- [https://en.wikipedia.org/wiki/IEEE_802.11i-2004](https://en.wikipedia.org/wiki/IEEE_802.11i-2004)
- [https://www.wildwesthackinfest.com](https://www.wildwesthackinfest.com)
- [https://nmap.org/](https://nmap.org/)
- [https://en.wikipedia.org/wiki/Situation_awareness](https://en.wikipedia.org/wiki/Situation_awareness)
- [https://www.educba.com/linux-network-manager/](https://www.educba.com/linux-network-manager/)
- [https://www.aircrack-ng.org/](https://www.aircrack-ng.org/)
- [https://www.aircrack-ng.org/doku.php?id=airodump-ng](https://www.aircrack-ng.org/doku.php?id=airodump-ng)
- [https://www.aircrack-ng.org/doku.php?id=cracking_wpa](https://www.aircrack-ng.org/doku.php?id=cracking_wpa)
- [https://charlesreid1.com/wiki/Aircrack_and_John_the_Ripper](https://charlesreid1.com/wiki/Aircrack_and_John_the_Ripper)