
ESP32 के लिए आधुनिक WiFi ऑडिटिंग लाइब्रेरी, जो उन्नत 802.11 तकनीकों का उपयोग करती है। PMKID निष्कर्षण और CSA इंजेक्शन के माध्यम से WPA/WPA2/WPA3 हैंडशेक कैप्चर करता है (PMF को बायपास करता है)। एंटरप्राइज़ क्रेडेंशियल्स एकत्र करता है, डुअल-बैंड (ESP32-C6 पर 2.4GHz/5GHz) का समर्थन करता है, PCAPNG/Hashcat में निर्यात करता है। स्वच्छ C++ API, 9 उदाहरणों के साथ।
ESP32 माइक्रोकंट्रोलर के लिए एक परिष्कृत WiFi ऑडिटिंग लाइब्रेरी
Politician एक एम्बेडेड C++ लाइब्रेरी है जिसे ESP32 प्लेटफ़ॉर्म पर WiFi सुरक्षा ऑडिटिंग के लिए डिज़ाइन किया गया है। यह उन्नत 802.11 प्रोटोकॉल तकनीकों का उपयोग करके WPA/WPA2/WPA3 हैंडशेक कैप्चर करने और एंटरप्राइज़ क्रेडेंशियल्स एकत्र करने के लिए एक स्वच्छ, आधुनिक API प्रदान करता है।
ClientFoundCb को (const uint8_t *bssid, const uint8_t *sta, int8_t rssi) से बदलकर (const ClientRecord &rec) कर दिया गया है। मौजूदा कॉलबैक अपडेट करें:
// 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
});
लाइब्रेरी एक नॉन-ब्लॉकिंग स्टेट मशीन के आसपास बनाई गई है जो चैनल हॉपिंग, टारगेट चयन, अटैक निष्पादन और कैप्चर प्रोसेसिंग का प्रबंधन करती है। सभी ऑपरेशन politician नेमस्पेस के भीतर समाहित हैं।
| हेडर | विवरण |
|---|---|
Politician.h | मुख्य इंजन क्लास — इसे हर प्रोजेक्ट में शामिल करें |
PoliticianTypes.h | सार्वजनिक स्ट्रक्ट, एनम और कंपाइल-टाइम फ़ीचर गेट |
PoliticianStorage.h | SD कार्ड लॉगर और NVS पर्सिस्टेंस (केवल Arduino) |
PoliticianFormat.h | PCAPNG और HC22000 सीरियलाइज़ेशन प्रिमिटिव |
PoliticianStress.h | ऑप्ट-इन DoS पेलोड (SAE फ़्लड, प्रोब फ़्लड, बीकन फ़्लड) |
PoliticianProbe.h | हिडन SSID प्रोबिंग के लिए ऑप्ट-इन PROGMEM वर्डलिस्ट |
PoliticianWPS.h | ऑप्ट-इन WPS M1 प्रिंट हेल्पर और बिटमास्क कॉन्स्टेंट |
PoliticianSense.h | ऑप्ट-इन निष्क्रिय RSSI-आधारित मोशन और उपस्थिति सेंसिंग |
| मोड | बिट | विवरण |
|---|---|---|
ATTACK_PMKID | 0x01 | फ़ेक एसोसिएशन के माध्यम से PMKID फ़िशिंग |
ATTACK_CSA | 0x02 | चैनल स्विच एनाउंसमेंट इंजेक्शन |
ATTACK_PASSIVE | 0x04 | केवल-सुनना — शून्य ट्रांसमिशन |
ATTACK_DEAUTH | 0x08 | क्लासिक Reason-7 डीऑथेंटिकेशन |
ATTACK_STIMULATE | 0x10 | QoS Null Data क्लाइंट स्टिमुलेशन |
ATTACK_BTM | 0x20 | 802.11v BSS ट्रांज़िशन मैनेजमेंट रिक्वेस्ट |
ATTACK_ALL | 0x3F | सभी सक्रिय अटैक वेक्टर |
Politician.h को शामिल करने से पहले या अपने बिल्ड सिस्टम के माध्यम से (-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 सभी callback प्रकारों को std::function<> से वापस raw function pointers में बदल देता है — लगभग 2KB flash बचाता है और ऐसे वातावरणों में उपयोग सक्षम करता है जहाँ <functional> नहीं है। जब यह flag सेट होता है तो lambda captures उपलब्ध नहीं होते।
POLITICIAN_MAX_INSTANCES (डिफ़ॉल्ट 2) promiscuous ISR dispatcher द्वारा उपयोग किए जाने वाले static instance registry का आकार नियंत्रित करता है। single-instance deployments के लिए इसे 1 पर सेट करें ताकि ISR में loop overhead समाप्त हो जाए।
[env:myboard]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
Politician
या सीधे अपने प्रोजेक्ट की lib/ डायरेक्टरी में क्लोन करें:
cd lib/
git clone https://github.com/0ldev/Politician.git
अपने प्रोजेक्ट की components/ डायरेक्टरी में क्लोन करें और एक CMakeLists.txt बनाएँ:
idf_component_register(
SRCS "src/Politician.cpp" "src/PoliticianFormat.cpp" "src/PoliticianStress.cpp"
INCLUDE_DIRS "src"
)
PoliticianStorage.hकेवल Arduino के लिए है और ESP-IDF के अंतर्गत#errorउत्पन्न करता है। ESP-IDF के VFS औरnvs_flashAPIs का सीधे उपयोग करें।
#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());
WiFi ड्राइवर को promiscuous मोड में इनिशियलाइज़ करता है। किसी भी अन्य मेथड से पहले इसे कॉल करना आवश्यक है। स्टार्टअप पर अमान्य Config मानों को क्लैंप करता है और चेतावनी देता है। फ़ील्ड में डिप्लॉय करने से पहले गलत कॉन्फ़िगरेशन को सामने लाने के लिए पहले validateConfig() का उपयोग करें:
Config cfg;
cfg.hop_min_dwell_ms = 400;
cfg.hop_max_dwell_ms = 200; // wrong — min > max
const char *warnings[8];
int n = politician::validateConfig(cfg, warnings, 8);
for (int i = 0; i < n; i++) Serial.println(warnings[i]);
// → "hop_min_dwell_ms >= hop_max_dwell_ms — max will be clamped to min+50ms"