Project index
ResearchpublicWireless Security & Auditing

Wireless WPA/WPA2 security testing script

WiFi Dictionary Attack

WiFi Dictionary Attack is an educational wireless security testing tool written in Python. Leveraging the PyWiFi interface abstraction layer, it enumerates wireless network interfaces, scans broadcast beacon frames for surrounding BSSIDs/SSIDs, and automates WPA/WPA2 4-way handshake association attempts against a target access point using candidate passwords from an input dictionary. Designed for defensive wireless auditing and credential robustness assessments on owned network hardware, it provides clear console output reporting interface connection states, time deltas, and recovered passphrase keys upon successful authentication.

Problem

Network administrators and security learners need lightweight, transparent auditing scripts to demonstrate why default or weak pre-shared keys (PSK) in WPA/WPA2 networks remain susceptible to offline and dictionary-based association attacks.

Solution

A streamlined, Python-native Wi-Fi penetration testing script with PyWiFi hardware abstraction, configurable target SSIDs, wordlist stream processing, and instant association state feedback.

Outcome

A compact wireless security assessment utility demonstrating Python wireless interface control, 802.11 network scanning, automated credential testing, and reproducible CI workflow integration.

Standout Features

  • Automated wireless interface detection and 802.11 BSSID/SSID beacon scanning
  • Dictionary-driven WPA/WPA2 pre-shared key (PSK) association testing engine
  • Real-time connection status monitoring and interface state validation
  • Clean modular architecture with GitHub Actions automated lint and syntax verification

Stack & Signals

  • Python 3.6+
  • PyWiFi
  • comtypes
  • GitHub Actions CI

Canonical destination

github.com/SagarBiswas-MultiHAT/WiFi-Dictionary-Attack

View on GitHub