Educational tool for detecting Wi-Fi deauthentication attacks
A passive monitoring tool for network administrators to detect deauthentication attacks in Wi-Fi networks. Designed for educational purposes and authorized security testing.
| Feature | Description |
|---|---|
| 🔍 Attack Detection | Identifies deauthentication packets in real-time |
| 🚨 Alert System | Immediate notifications for suspicious activity |
| 📊 Logging | Timestamped records of security events |
| ⚖️ Ethical Design | Strictly for authorized educational use |
Warning
This tool is only for:
- Educational use in controlled environments
- Security testing with explicit network ownership/permission
❗ Unauthorized use may violate laws like the Computer Fraud and Abuse Act
- ESP32 (or compatible Wi-Fi microcontroller)
- Arduino IDE (Download)
- ESP32 Board Package (Install Guide)
- Libraries:
#include <WiFi.h> #include <esp_wifi.h>
🚀 Installation bash Copy
git clone https://github.com/your-repo/wifi-security-monitor.git cd wifi-security-monitor Setup Arduino IDE
Install ESP32 board support
Add required libraries
Upload to ESP32
arduino Copy void setup() { Serial.begin(115200); // Initialization code... } Monitor Output
Serial Monitor at 115200 baud
📝 Usage Example
python
Copy
[2023-11-15 14:30:45] ALERT: Deauth packet detected
Source MAC: AA:BB:CC:DD:EE:FF
Target MAC: 11:22:33:44:55:66
RSSI: -72dBm
🌟 Future Roadmap
Push notifications via Telegram/Email
Automated MAC address whitelisting
Statistical anomaly detection
🤝 Contributing bash Copy
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add amazing feature') - Push (
git push origin feature/AmazingFeature) - Open a Pull Request
📜 License Distributed under the MIT License. See LICENSE for details.