Evil Twin Access Point Toolkit

Ein vollständiges, modulares und reproduzierbares Evil-Twin-Access-Point-Setup für defensive Sicherheitstests, Penetrationstests und drahtlose Sicherheitsforschung.

⚠️ Rechtlicher Hinweis

NUR FÜR BILDUNGSZWECKE UND AUTORISIERTE SICHERHEITSTESTS

Dieses Tool wird bereitgestellt für:

Bildungszwecke
Autorisierte Penetrationstests
Sicherheitsforschung in kontrollierten Umgebungen
Defensive Sicherheitsschulungen

ILNUTZUNG IST STRENGSTENS UNTERSAGT. Unautorisierter Zugriff auf Computernetzwerke ist in den meisten Ländern eine Straftat. Nutzer tragen die alleinige Verantwortung für:

Einholen einer schriftlichen Genehmigung vor dem Test
Einhaltung aller geltenden Gesetze und Vorschriften
Alle Konsequenzen, die aus Missbrauch entstehen

Durch die Nutzung dieses Tools erklären Sie sich damit einverstanden, es nur in Netzwerken zu verwenden, die Ihnen gehören oder für die Sie eine ausdrückliche schriftliche Testgenehmigung haben.

🎯 Übersicht

Dieses Toolkit erstellt einen unautorisierten drahtlosen Zugangspunkt (Evil Twin), der ein legitimes Netzwerk nachahmt. Es erfasst Netzwerkverkehr, indem es eine identische SSID erstellt, mit der sich Clients möglicherweise automatisch verbinden, in dem Glauben, es sei das legitime Netzwerk.

Was ist ein Evil-Twin-Angriff?

Ein Evil Twin ist ein betrügerischer WLAN-Zugangspunkt, der legitim erscheint, aber eingerichtet ist, um drahtlose Kommunikation abzuhören. Der Angriff funktioniert, indem ein unautorisierter Zugangspunkt in der Nähe des Zielnetzwerks platziert wird, der dieselbe SSID ausstrahlt und Geräte dazu bringt, sich zu verbinden.

Anwendungsfälle

🔐 Penetrationstests der WLAN-Sicherheit
🎓 Schulungen und Vorführungen zum Sicherheitsbewusstsein
🧪 Netzwerksicherheitsforschung in Laborumgebungen
🛡️ Testen von drahtlosen Einbrucherkennungssystemen
📱 Analyse des Geräteverhaltens und der Client-Konnektivität

✨ Funktionen

🔧 Modulares Design: Klare Trennung der Belange mit wiederverwendbaren Funktionen
📊 Ausführliche Ausgabe: Farbcodierte Statusmeldungen für jeden Vorgang
🔍 Echtzeitüberwachung: Live-Verfolgung verbundener Clients mit Zeitstempeln
📝 Umfassende Protokollierung: Detaillierte Logs für hostapd, dnsmasq und Verbindungen
🌐 Internetfreigabe: Automatische NAT-Konfiguration für Internetdurchleitung
🔄 Auto-Erkennung: Automatische Erkennung der internetzugewandten Schnittstelle
🧹 Saubere Abschaltung: Anmutiges Herunterfahren mit vollständiger Systemwiederherstellung
✅ Abhängigkeitsverwaltung: Automatisierte Installation und Überprüfung
🎨 Plattformübergreifend: Unterstützt Debian, Ubuntu, Kali, Fedora, Arch und mehr
📦 Reproduzierbar: Versionskontrollierbare Konfigurationsdateien
📡 Schnittstellenerkennung: Automatische Erkennung von WLAN-Adaptern und AP-Modus-Verifizierung
📸 Datenverkehr erfassen: Integrierte PCAP-Erfassung mit Filterung und Rotation

🔌 Hardware-Anforderungen

WLAN-Netzwerkadapter

Ihr WLAN-Adapter MUSS den AP-Modus (Access Point) unterstützen. Nicht alle WLAN-Karten unterstützen diese Funktionalität.

✅ Empfohlene Adapter

Diese Adapter sind bekanntermaßen gut geeignet und unterstützen den AP-Modus:

Chipsatz	Beispielmodelle	Eigenschaften	Preisspanne
RTL8812AU	Alfa AWUS036ACH, TP-Link Archer T4U	Dualband (2,4/5 GHz), hohe Leistung, hervorragende Reichweite	40-60 $
RTL8814AU	Alfa AWUS1900, TP-Link Archer T9UH	Vier Antennen, AC1900, große Reichweite	60-80 $
Atheros AR9271	TP-Link TL-WN722N v1, Alfa AWUS036NHA	Stabil, gut unterstützt, preisgünstig	20-35 $
MT7612U	Panda PAU0D, Alfa AWUS036ACM	Dualband, gute Kompatibilität	35-50 $
RTL8188EU	Diverse günstige Adapter	Einsteigermodell, nur 2,4 GHz	10-20 $

🏆 Top-Empfehlungen

Alfa AWUS036ACH (RTL8812AU)
- Insgesamt beste Wahl für Penetrationstests
- Hervorragende Treiberunterstützung in Kali Linux
- Hohe Sendeleistung (bis zu 30 dBm)
- Dualband-Unterstützung
TP-Link TL-WN722N v1 (Atheros AR9271)
- Beste Budgetoption
- Absolute Stabilität
- Native Linux-Unterstützung
- ⚠️ Achten Sie darauf, Version 1 zu erhalten, nicht v2 oder v3
Alfa AWUS036ACM (MT7612U)
- Gutes Preis-Leistungs-Verhältnis
- Hervorragende Kompatibilität
- Mittlere Ausgangsleistung

❌ Adapter, die Sie vermeiden sollten

Eingebaute Laptop-WLAN-Karten (unterstützen meist keinen AP-Modus)
RTL8188FTV-Chipsatz (schlechte AP-Modus-Unterstützung)
Broadcom-Chipsätze (eingeschränkte Linux-Unterstützung)
Jeder als „v2“ oder „v3“ gekennzeichnete Adapter von zuvor funktionierenden Modellen (oft mit anderen, inkompatiblen Chipsätzen)

Überprüfen der AP-Modus-Unterstützung

Überprüfen Sie vor dem Kauf, ob der Adapter den AP-Modus unterstützt:```bash

Check if your current adapter supports AP mode

iw list | grep -A 10 "Supported interface modes"

Look for this in the output:

* AP

* monitor

### Zusätzliche Hardware

- **Ethernet-Verbindung**: Erforderlich für Internet-Durchleitung (physisch oder per USB-Ethernet-Adapter)
- **Ausreichende USB-Stromversorgung**: Einige leistungsstarke Adapter benötigen möglicherweise einen USB-Hub mit eigener Stromversorgung
- **Computer**: Jeder Laptop oder Desktop mit Linux (empfohlen: Kali Linux)

---

## 💻 Software-Anforderungen

### Betriebssystem

- **Empfohlen**: Kali Linux (2020.1 oder neuer)
- **Auch unterstützt**:
  - Debian 10+
  - Ubuntu 18.04+
  - Fedora 30+
  - Arch Linux
  - ParrotOS
  - BlackArch

### Erforderliche Pakete

Diese werden automatisch von `install_dependencies.sh` installiert:

- `hostapd` - Erstellt den Access Point
- `dnsmasq` - Stellt DHCP- und DNS-Dienste bereit
- `iptables` - Konfiguriert NAT- und Firewall-Regeln
- `iproute2` - Netzwerkschnittstellen-Konfiguration
- `wireless-tools` - Drahtlos-Verwaltungstools
- `net-tools` - Netzwerk-Diagnosetools
- `iw` - Drahtlos-Konfigurationsdienstprogramm
- `tcpdump` - Paketerfassungsdienstprogramm

### Berechtigungen

- Für alle Vorgänge ist Root-/sudo-Zugriff erforderlich

---

## 📦 Installation

### Schnellstart```bash
# Clone the repository
git clone https://github.com/yourusername/evil-twin-ap.git
cd evil-twin-ap

# Install dependencies
sudo ./install_dependencies.sh

# Detect your wireless interfaces
sudo ./detect_interface.sh

# Configure your settings (update interface if needed)
nano hostapd.conf  # Change SSID, channel, interface
nano dnsmasq.conf  # Adjust DHCP settings, interface

# Start the evil twin
sudo ./start_evil_twin.sh

Detaillierte Installation

Schritt 1: Repository klonen```bash

git clone https://github.com/yourusername/evil-twin-ap.git cd evil-twin-ap

#### Schritt 2: Abhängigkeiten installieren

evil-twin-ap

Beliebteste