ESP32 Wi-Fi Penetration Tool

ESP32 Wi-Fi Penetration Tool

This project introduces an universal tool for the ESP32 platform for implementing various Wi-Fi attacks. It provides some common functionality that is commonly used in Wi-Fi attacks and makes implementing new attacks a bit simpler. It also includes Wi-Fi attacks itself like capturing PMKIDs from handshakes, or handshakes themselves by different methods like starting rogue duplicated AP or sending deauthentication frames directly, etc…

Obviously cracking is not part of this project, as ESP32 is not sufficient to crack hashes in an effective way. The rest can be done on this small, cheap, low-power SoC.

Features

• PMKID capture
• WPA/WPA2 handshake capture and parsing
• Deauthentication attacks using various methods
• Denial of Service attacks
• Formatting captured traffic into PCAP format
• Parsing captured handshakes into HCCAPX file ready to be cracked by Hashcat
• Passive handshake sniffing
• Easily extensible framework for new attacks implementations
• Management AP for easy configuration on the go using a smartphone for example
• And more…

Components

This project consists of multiple components, that can be reused in other projects. Each component has its own README with a detailed description. Here comes a brief description of the components:

• Main component is an entry point for this project. All necessary initialisation steps are done here. Management AP is started and the control is handed to a webserver.
• Wifi Controller component wraps all Wi-Fi-related operations. It’s used to start AP, connect as STA, scan nearby APs, etc.
• Webserver component provides web UI to configure attacks. It expects that AP is started and no additional security features like SSL encryption are enabled.
• Wi-Fi Stack Libraries Bypasser component bypasses Wi-Fi Stack Libraries restriction to send some types of arbitrary 802.11 frames.
• Frame Analyzer component processes captured frames and provide parsing functionality to other components.
• PCAP Serializer component serializes captured frames into PCAP binary format and provides it to other components (mostly for webserver/UI)
• HCCAPX Serializer component serializes captured frames into HCCAPX binary format and provides it to other components (mostly for webserver/UI)

Install & Use

Copyright (c) 2021 risinek