The WiFi Deauthentication Detection System is a Django-based web application designed to monitor and manage WiFi devices, detect deauthentication events, and provide a user-friendly interface for configuring settings and accessing device information.
- Monitor Mode Control: Enable or disable monitor mode for all available WiFi devices.
- Device List: View a list of WiFi devices connected to the system and check if monitor mode is enabled.
- Deauthentication Detection: Detect and log deauthentication events, saving them to a MongoDB database.
- Database Configuration: Configure the database settings through the GUI.
- MAC Address Lookup API: Utilize a MAC address lookup API to identify devices.
-
Clone the repository:
git clone https://github.com/yourusername/wifi-deauth-detection.git
-
Install dependencies:
cd wifi-deauth-detection pip install -r requirements.txt cd wifi python manage.py runserver
-
Access the web application at
http://localhost:8000
in your web browser.
- Configure the database settings in
settings
.
-
select Device tab and enable monitor mode.
-
select deauth detector tab and select the device and set the macaddress.io api key(optional).
- select dashboard and start the sensor.
- if attack is detected it visualise on the dashboard(refresh is required).
- Browse in to the web application.
- Navigate through the GUI to access different features:
- Enable/disable monitor mode
- View connected devices and monitor mode status
- Configure database settings
- Access MAC address lookup API
- Monitor deauthentication events in real-time and view logs in the database.
The sensor script (deauth2.py
) is responsible for scanning deauthentication events. It can be triggered from the UI using subprocesses.
Contributions are welcome! Please submit pull requests.
- Developed by Sharath c