The deauthentication detector makes use of the scapy python library to detect when a deauthentication attack is occurring. When an attack is detected, information about the attack is captured and stored in a MongoDB database. This data is then consumed by a Python Flask web API which serves the deauthentication attack data as JSON to a React web application which displays the attack information as well as information about the history of previous attacks to the user in an easy to digest format.
The following are required to run the deauthentication attack detector
- Python3
- pip3
- Node.js and NPM
- Aircrack-ng
- MongoDB
Follow these steps to setup the Deauthentication Detector on your current computer
- Clone this repository
- Navigate to the deauth-detector directory via the command line
- Set environmental variable with monitor mode device name
export monitorDevice="wlan1mon"
- Run the deploy.sh bash script
./deploy.sh
- Once installation concludes, navigate to localhost:3000 via a web browser to view the running dashboard
Follow these steps to setup RaspberryPi - Deauthentication Detection for use with a RaspberryPi
- Download BalenaEtcher
- Download the RaspberryPi - Deauthentication Detection image from here
- Use BalenaEtcher to burn the Deauthencation Detection .img to an sd card
- Boot up the raspberrypi with a monitor mode enabled wifi card
- Set environmental variable with monitor mode device name
export monitorDevice="wlan1mon"
- Navigate to the deauth-detector directory
cd ~/deauth-detector
- Pull the latest code from GitHub
git pull origin master
- Run the deploy.sh bash script
sudo -E bash -c './deploy.sh'
- Once installation concludes, navigate to localhost:3000 via a web browser to view the running dashboard