
مكتبة حديثة لتدقيق شبكات WiFi لوحدة ESP32 باستخدام تقنيات 802.11 المتقدمة. تلتقط مصافحة WPA/WPA2/WPA3 عبر استخراج PMKID وحقن CSA (يتجاوز PMF). تجمع بيانات اعتماد المؤسسات، تدعم النطاق المزدوج (2.4GHz/5GHz على ESP32-C6)، وتُصدر إلى PCAPNG/Hashcat. واجهة برمجة تطبيقات C++ نظيفة مع 9 أمثلة.
مكتبة تدقيق WiFi متطورة لوحدات ESP32 الدقيقة
Politician هي مكتبة C++ مدمجة مصممة لتدقيق أمن WiFi على منصات ESP32. توفر واجهة برمجة تطبيقات نظيفة وحديثة لالتقاط مصافحات WPA/WPA2/WPA3 وجمع بيانات الاعتماد المؤسسية باستخدام تقنيات بروتوكول 802.11 المتقدمة.
تم تغيير 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 flood، probe flood، beacon flood) |
PoliticianProbe.h | قائمة كلمات PROGMEM اختيارية لاستقصاء SSID المخفي |
PoliticianWPS.h | مساعدات طباعة WPS M1 الاختيارية وثوابت bitmask |
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 | طلب إدارة انتقال BSS 802.11v |
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 يعيد جميع أنواع الاستدعاءات من std::function<> إلى مؤشرات دوال خام — مما يوفر حوالي 2KB من الذاكرة الوميضية ويتيح الاستخدام في البيئات التي لا تحتوي على <functional>. لا تتوفر عمليات التقاط lambda عند تعيين هذا العلم.
POLITICIAN_MAX_INSTANCES (الافتراضي 2) يتحكم في حجم سجل النسخ الثابت المستخدم بواسطة موزّع ISR متعدد الاستخدامات. اضبطه على 1 لعمليات النشر أحادية النسخة لإزالة الحمل الزائد للحلقة في ISR.
[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 فقط ويُصدر#errorتحت ESP-IDF. استخدم واجهات VFS وnvs_flashالخاصة بـ ESP-IDF مباشرةً.
#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 mode). يجب استدعاؤها قبل أي طريقة أخرى. تقيّد قيم 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"
engine.begin(cfg); // begins normally; begin() clamps automatically
validateConfig() دالة مضمّنة مجانية في نطاق politician — بلا تخصيصات، وبلا تبعيات.
يرفض begin() إعدادات القفز الذكي التي لا يمكن تمثيل الحد الأدنى لفترة البقاء فيها بعد تصحيح min + 50 ms. استدعاء begin() على محرك مُهيَّأ مسبقًا يوقف وقت التشغيل السابق أولًا، لذا فإن إعادة البدء حتمية. استدعاء stop() آمن أكثر من مرة؛ فهو يعطّل الالتقاط، ويلغي تسجيل المثيل، ويحرر موارد العامل. كما يوقف المُدمِّر محركًا نشطًا. تظل ملكية برنامج تشغيل WiFi على مستوى العملية بأكملها وتُعاد استخدامها بواسطة المثيلات اللاحقة.