
Moderne WiFi-Auditing-Bibliothek für ESP32 mit fortschrittlichen 802.11-Techniken. Erfasst WPA/WPA2/WPA3-Handshakes per PMKID-Extraktion und CSA-Injection (umgeht PMF). Sammelt Enterprise-Zugangsdaten, unterstützt Dual-Band (2.4GHz/5GHz auf ESP32-C6), exportiert nach PCAPNG/Hashcat. Saubere C++-API mit 9 Beispielen.
Eine hochentwickelte WiFi-Auditing-Bibliothek für ESP32-Mikrocontroller
Politician ist eine eingebettete C++-Bibliothek, die für WiFi-Sicherheitsaudits auf ESP32-Plattformen entwickelt wurde. Sie bietet eine saubere, moderne API zum Erfassen von WPA/WPA2/WPA3-Handshakes und zum Sammeln von Enterprise-Anmeldedaten mithilfe fortgeschrittener 802.11-Protokolltechniken.
ClientFoundCb wurde von (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) zu (const ClientRecord &rec) geändert. Aktualisieren Sie bestehende Callbacks:
// Before
engine.setClientFoundCallback([](const uint8_t *bssid, const uint8_t *sta, int8_t rssi) { … });
// After
engine.setClientFoundCallback([](const ClientRecord &rec) {
// rec.bssid, rec.sta, rec.rssi — same data plus rand_mac, vendor, timestamps
});
Die Bibliothek basiert auf einer nicht-blockierenden Zustandsmaschine, die Kanal-Hopping, Zielauswahl, Angriffsausführung und Capture-Verarbeitung verwaltet. Alle Operationen sind im Namespace politician enthalten.
| Header | Beschreibung |
|---|---|
Politician.h | Haupt-Engine-Klasse — in jedes Projekt einbinden |
PoliticianTypes.h | Öffentliche Structs, Enums und Compile-Time-Feature-Gates |
PoliticianStorage.h | SD-Karten-Logger und NVS-Persistenz (nur Arduino) |
PoliticianFormat.h | Serialisierungsprimitive für PCAPNG und HC22000 |
PoliticianStress.h | Opt-in-DoS-Payloads (SAE-Flood, Probe-Flood, Beacon-Flood) |
PoliticianProbe.h | Opt-in-PROGMEM-Wortliste für das Probing versteckter SSIDs |
PoliticianWPS.h | Opt-in-WPS-M1-Print-Helfer und Bitmask-Konstanten |
PoliticianSense.h | Opt-in passive RSSI-basierte Bewegungs- und Anwesenheitserkennung |
| Modus | Bit | Beschreibung |
|---|---|---|
ATTACK_PMKID | 0x01 | PMKID-Fishing über Fake-Assoziation |
ATTACK_CSA | 0x02 | Channel Switch Announcement Injection |
ATTACK_PASSIVE | 0x04 | Nur Lauschen — keine Übertragung |
ATTACK_DEAUTH | 0x08 | Klassische Reason-7-Deauthentifizierung |
ATTACK_STIMULATE | 0x10 | QoS Null Data Client-Stimulation |
ATTACK_BTM | 0x20 | 802.11v BSS Transition Management Request |
ATTACK_ALL | 0x3F | Alle aktiven Angriffsvektoren |
Definieren Sie eines dieser Makros vor dem Einbinden von Politician.h oder über Ihr Build-System (-DNAME):
; platformio.ini
build_flags =
-DPOLITICIAN_NO_DB ; Strip 14KB OUI database (no vendor lookups)
-DPOLITICIAN_NO_PCAPNG ; Strip PCAPNG serialization
-DPOLITICIAN_NO_HC22000 ; Strip Hashcat HC22000 formatter
-DPOLITICIAN_NO_LOGGING ; Strip all internal Serial log output
-DPOLITICIAN_NO_STD_FUNCTION ; Use raw fn pointers instead of std::function
-DPOLITICIAN_NO_MSCHAPV2 ; Strip bare EAP-MSCHAPv2 capture
-DPOLITICIAN_NO_KARMA ; Strip KARMA rogue AP responder
-DPOLITICIAN_MAX_INSTANCES=1 ; Limit to one instance (saves a pointer array slot)
POLITICIAN_NO_STD_FUNCTION setzt alle Callback-Typen von std::function<> auf rohe Funktionszeiger zurück — spart ~2KB Flash und ermöglicht die Verwendung in Umgebungen ohne <functional>. Lambda-Captures sind nicht verfügbar, wenn dieses Flag gesetzt ist.
POLITICIAN_MAX_INSTANCES (Standard 2) steuert die Größe der statischen Instanzregistrierung, die vom promiskuitiven ISR-Dispatcher verwendet wird. Auf 1 setzen für Single-Instance-Deployments, um den Schleifen-Overhead im ISR zu eliminieren.
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
Oder klonen Sie es direkt in das lib/-Verzeichnis Ihres Projekts:
cd lib/
git clone https://github.com/0ldev/Politician.git
Klone das Repository in das Verzeichnis components/ deines Projekts und erstelle eine CMakeLists.txt:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hist nur für Arduino gedacht und gibt unter ESP-IDF einen#erroraus. Verwende stattdessen die VFS- undnvs_flash-APIs von ESP-IDF direkt.
#include <Arduino.h>
#include <SD.h>
#include <Politician.h>
#include <PoliticianStorage.h>
using namespace politician;
using namespace politician::storage;
Politician engine;
PcapngFileLogger pcap; // Streaming logger — one open(), many write() calls
void onHandshake(const HandshakeRecord &rec) {
Serial.printf("[✓] %s ch%d rssi=%d type=%d\n",
rec.ssid, rec.channel, rec.rssi, rec.type);
pcap.write(rec);
}
void setup() {
Serial.begin(115200);
SD.begin();
pcap.open(SD, "/captures.pcapng", 4 * 1024 * 1024); // optional auto-rotation at 4MB
engine.setEapolCallback(onHandshake);
engine.begin();
engine.setAttackMask(ATTACK_ALL);
}
void loop() {
engine.tick();
}
#include <nvs_flash.h>
#include <esp_event.h>
#include <Politician.h>
using namespace politician;
static Politician engine;
static void audit_task(void *) {
engine.setEapolCallback([](const HandshakeRecord &rec) {
printf("[+] %s ch%d\n", rec.ssid, rec.channel);
});
engine.begin();
engine.setAttackMask(ATTACK_ALL);
for (;;) { engine.tick(); vTaskDelay(pdMS_TO_TICKS(1)); }
}
extern "C" void app_main(void) {
nvs_flash_init();
esp_event_loop_create_default();
xTaskCreate(audit_task, "politician", 8192, nullptr, 5, nullptr);
}
Error begin(const Config &cfg = Config());
Initialisiert den WiFi-Treiber im Promiscuous-Modus. Muss vor jeder anderen Methode aufgerufen werden. Begrenzt und warnt bei ungültigen Config-Werten beim Start. Verwenden Sie vorab validateConfig(), um Fehlkonfigurationen aufzudecken, bevor Sie im Feld bereitstellen:
Config cfg;
cfg.hop_min_dwell_ms = 400;
cfg.hop_max_dwell_ms = 200; // wrong — min > max