Bu proje, iki ayrı ESP32 cihazını web tabanlı bir yönetim paneliyle birleştiren kablosuz güvenlik laboratuvar sistemidir.

Sistem üç farklı firmware akışını birbirinden ayırır:

1. Yetkili saldırı/test firmware'i
2. Güvenli saldırı simülasyonu firmware'i
3. Savunma ve izleme firmware'i

Bu ayrım sayesinde gerçek laboratuvar testleri, bozucu olmayan güvenli simülasyonlar ve savunma/izleme işlemleri aynı proje içinde ancak bağımsız dosyalarla yürütülür.

• İki ESP32 cihazlı saldırı–savunma mimarisi
• OLED tabanlı cihaz içi menüler
• Web Serial API ile tarayıcıdan doğrudan ESP32 bağlantısı
• CP2102 USB-UART seri haberleşme
• Canlı seri log görüntüleme
• WIDS benzeri olay kayıtları
• Honeypot alarm akışı
• SSID yayın ve liste yönetimi
• Manuel CLI komut ekranı
• Yetkili laboratuvar test kontrolleri
• Güvenli saldırı simülasyonu
• Türkçe ve İngilizce teknik dokümantasyon

┌──────────────────────────────┐
│ Saldırı/Test ESP32           │
│ attack-simulation-device.ino │
└──────────────┬───────────────┘
               │
               │ Yetkili laboratuvar test akışı
               │
┌──────────────▼───────────────┐
│ Güvenli Simülasyon ESP32     │
│ simulation-password.ino      │
└──────────────┬───────────────┘
               │
               │ Zararsız simülasyon olayı
               │
┌──────────────▼───────────────┐
│ Savunma ESP32                │
│ defense-monitoring-device.ino│
└──────────────┬───────────────┘
               │ USB / CP2102
               │
┌──────────────▼───────────────┐
│ Web Serial API               │
└──────────────┬───────────────┘
               │
┌──────────────▼───────────────┐
│ Web Panel                    │
│ Log • WIDS • Alarm • CLI     │
└──────────────────────────────┘

Kontrollü ve açıkça yetkilendirilmiş laboratuvar ortamlarında saldırı/test işlevlerini yürütür.

Başlıca işlevleri:

• Yetkili test akışlarını başlatma ve durdurma
• OLED üzerinde test durumu gösterme
• Web panelinden seri komut alma
• Manuel CLI ile kontrol
• Test ve kanıt logları üretme

Bu firmware yalnızca izinli laboratuvar ortamlarında kullanılmalıdır.

Bozucu saldırı trafiği üretmeyen güvenli simülasyon firmware'idir.

İş akışı:

1. Kablosuz ağları tarar
2. Yetkili savunma erişim noktasını bulur
3. Yapılandırılmış laboratuvar parolasıyla bağlanır
4. Kaynak MAC ve hedef SSID bilgisini hazırlar
5. Savunma cihazındaki simülasyon uç noktasına zararsız olay gönderir
6. Savunma cihazı olayı loglar ve web paneline aktarır

Savunma ve erişim izleme cihazında çalışır.

Başlıca işlevleri:

• Kilitli laboratuvar erişim noktası
• OLED menü ve durum ekranları
• WIDS benzeri olay kayıtları
• Honeypot alarm işleme
• SSID yayın ve liste yönetimi
• Seri port logları
• Simülasyon olaylarını alma
• Kaynak MAC ve hedef SSID kayıtları
• Otomatik savunma modu
• Web paneline canlı veri aktarımı

Web paneli, tarayıcının Web Serial API özelliğini kullanarak ESP32 cihazına doğrudan bağlanır.

Bağlantı akışı:

ESP32 → CP2102 USB-UART → Web Serial API → Web Panel

Panel özellikleri:

• ESP32 bağlantı yönetimi
• Canlı seri loglar
• Savunma modları
• Honeypot başlatma/durdurma
• WIDS olay günlüğü
• Alarm ekranı
• SSID yayın yönetimi
• SSID liste yönetimi
• Manuel CLI
• Yetkili laboratuvar test butonları
• Durum ve kanıt logları

• ESP32-WROOM-32U geliştirme kartları
• SH1106 / SSD1106 uyumlu OLED ekranlar
• Harici antenler
• Breadboard
• Butonlar
• Jumper kablolar
• CP2102 USB-UART bağlantısı

1. Arduino IDE'ye ESP32 kart paketini kur.
2. Kullanılan OLED kütüphanelerini ekle.
3. İlgili .ino dosyasını aç.
4. Örnek ağ bilgilerini laboratuvar bilgileriyle değiştir.
5. Firmware'i doğru ESP32 cihazına yükle.
6. Savunma ESP32'sini USB ile bilgisayara bağla.
7. Web panelini Web Serial destekli bir tarayıcıda aç.
8. CP2102 seri cihazını seç.
9. Logları, alarm durumlarını ve simülasyon olaylarını izle.

This project is a wireless-security laboratory system that combines two ESP32 devices with a web-based management panel.

It separates three different firmware workflows:

1. Authorized attack/test firmware
2. Safe attack-simulation firmware
3. Defense and monitoring firmware

This separation allows authorized laboratory testing, non-disruptive simulation and defense monitoring to coexist in the same project while remaining clearly isolated in different source files.

• Dual-ESP32 attack/defense architecture
• OLED-based on-device menus
• Direct browser-to-ESP32 connection through Web Serial API
• CP2102 USB-to-UART serial communication
• Live serial logging
• WIDS-style event records
• Honeypot alert workflow
• SSID broadcast and list management
• Manual CLI interface
• Authorized laboratory test controls
• Safe non-disruptive simulation
• Bilingual technical documentation

Runs authorized attack and security-test functions in controlled laboratory environments.

Main capabilities:

• Start and stop authorized test workflows
• Display test state on the OLED
• Receive serial commands from the web panel
• Manual CLI control
• Produce test and evidence logs

This firmware must only be used in explicitly authorized laboratory environments.

Provides a safe and non-disruptive attack-simulation workflow.

Process:

1. Scans wireless networks
2. Finds the authorized defense access point
3. Connects using the configured laboratory password
4. Prepares source MAC and target SSID information
5. Sends a harmless event to the defense-device simulation endpoint
6. The defense device logs the event and forwards it to the web panel

Runs on the defense and access-monitoring ESP32.

Main capabilities:

• Locked laboratory access point
• OLED menu and status screens
• WIDS-style event records
• Honeypot alert processing
• SSID broadcast and list management
• Serial logging
• Simulation-event handling
• Source MAC and target SSID records
• Automatic defense mode
• Live data transfer to the web panel

The web panel uses the browser Web Serial API to connect directly to the ESP32.

Connection flow:

ESP32 → CP2102 USB-UART → Web Serial API → Web Panel

Panel features:

• ESP32 connection management
• Live serial logs
• Defense-mode controls
• Honeypot start/stop controls
• WIDS event log
• Alarm interface
• SSID broadcast management
• SSID list management
• Manual CLI
• Authorized laboratory test buttons
• Status and evidence logs

• ESP32-WROOM-32U development boards
• SH1106 / SSD1106-compatible OLED displays
• External antennas
• Breadboards
• Push buttons
• Jumper wires
• CP2102 USB-to-UART interface

.
├── docs/
│   ├── project-report-bilingual-v2.docx
│   ├── project-report-bilingual-v2.pdf
│   └── images/
├── firmware/
│   ├── attack-simulation-device/
│   │   ├── attack-simulation-device.ino
│   │   └── simulation-password.ino
│   └── defense-monitoring-device/
│       └── defense-monitoring-device.ino
├── images/
├── web-panel/
│   └── admin-panel.html
├── .gitignore
├── CITATION.cff
├── LICENSE
├── NOTICE
├── README.md
└── SECURITY.md

• ESP32 attack/test firmware
• Safe simulation firmware
• Defense-monitoring firmware
• OLED interfaces
• Web Serial integration
• Live log view
• WIDS event records
• Alarm workflow
• Bilingual report
• Public repository sanitization

The bilingual technical report is available in the docs/ directory.

• docs/project-report-bilingual-v2.docx
• docs/project-report-bilingual-v2.pdf

This project is licensed under the Apache License 2.0.

You may:

• Use
• Study
• Modify
• Redistribute
• Develop derivative works

Redistributed or modified versions must preserve the required license and attribution notices.

Required attribution:

Based on the ESP32 Web-Based Attack Simulation and Defense System by Batuthz.

See:

• LICENSE
• NOTICE

Batuthz identifies the original project and its source.

The Batuthz name must not be used to falsely claim endorsement, partnership or official approval of modified versions.

This repository is intended only for:

• Authorized security testing
• Controlled laboratory simulations
• Cybersecurity education
• Defensive security research
• ESP32 development
• Web Serial API experimentation

Do not use this project against any network, system, account, service or device without explicit permission.

The project is provided as-is, without warranty.

The original developer and contributors are not responsible for misuse, unauthorized activity, network disruption, data loss, hardware damage, legal consequences or other damage resulting from use of the project.