### 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

#### Schritt 2: Abhängigkeiten installieren

Das Installationsskript erkennt automatisch Ihre Linux-Distribution und installiert die erforderlichen Pakete:```bash
sudo ./install_dependencies.sh

Dieses Skript analysiert alle drahtlosen Schnittstellen und empfiehlt die beste zur Verwendung.

**Beispielausgabe:**```
==========================================
   Wireless Interface Detection
==========================================

[INFO] Scanning for wireless interfaces...

[✓] Found 2 wireless interface(s)

═══════════════════════════════════════════
Interface: wlan1
═══════════════════════════════════════════
State: DORMANT
MAC Address: 1a:60:c6:85:87:53
Driver: rtl88XXau

[INFO] Checking capabilities for wlan1...
[✓] Supports AP mode (Access Point) ✓
[✓] Supports Monitor mode ✓
Current Mode: managed

═══════════════════════════════════════════
Interface: wlan0
═══════════════════════════════════════════
State: DOWN
MAC Address: b2:72:bf:bc:31:bd
Driver: iwlwifi

[INFO] Checking capabilities for wlan0...
[✓] Supports AP mode (Access Point) ✓
[✓] Supports Monitor mode ✓
Current Mode: managed
[!] Power management is ON (may cause issues)

==========================================
   Summary & Recommendations
==========================================

[✓] Found 2 AP-capable interfaces:
  - wlan1
  - wlan0

[INFO] Recommendation: Use wlan1 (likely external USB adapter)

[!] wlan0 is usually built-in WiFi - use external adapter if available

[INFO] To update configuration files, run:
  sed -i 's/^interface=.*/interface=wlan1/' hostapd.conf
  sed -i 's/^interface=.*/interface=wlan1/' dnsmasq.conf

Current Configuration:
  hostapd.conf: interface=wlan1
  dnsmasq.conf: interface=wlan1

[INFO] After updating, verify with: iw list | grep -A 10 'Supported interface modes'

---

## ⚙️ Konfiguration

### hostapd.conf - Access Point-Einstellungen

Bearbeiten Sie `hostapd.conf`, um Ihren evil twin anzupassen:```bash
nano hostapd.conf

### dnsmasq.conf - DHCP/DNS Einstellungen

Bearbeiten Sie `dnsmasq.conf`, um Netzwerkeinstellungen anzupassen:```bash
nano dnsmasq.conf

### Netzwerkkonfiguration

**Standardeinstellungen:**
- **AP-IP**: 192.168.99.1
- **Subnetz**: 192.168.99.0/24
- **DHCP-Bereich**: 192.168.99.10 - 192.168.99.250
- **Kanal**: 6 (2.4GHz)
- **Passwort**: letitrain2
- **Schnittstelle**: wlan1 (externer Adapter)

---

## 🚀 Verwendung

### Starten des Evil Twin```bash
sudo ./start_evil_twin.sh

### Den Evil Twin stoppen```bash
sudo ./stop_evil_twin.sh

---

## 📸 Verkehrserfassung

### Netzwerkverkehr aufzeichnen

Das Toolkit enthält ein umfassendes Skript zur Verkehrserfassung, das Paketdaten als PCAP-Dateien zur Analyse speichert:```bash
# Basic capture (continuous until Ctrl+C)
sudo ./capture_traffic.sh

# Capture for specific duration (60 seconds)
sudo ./capture_traffic.sh -d 60

# Capture with verbose output and live statistics
sudo ./capture_traffic.sh -v

# Capture only HTTP/HTTPS traffic
sudo ./capture_traffic.sh -f "tcp port 80 or tcp port 443"

# Capture with custom filename
sudo ./capture_traffic.sh -n my_test_capture

# Capture on specific interface
sudo ./capture_traffic.sh -i wlan1

# Capture with file rotation (50MB files, max 20 files)
sudo ./capture_traffic.sh -s 50 -m 20

### Erfassungsfunktionen

- ✅ Speichert Verkehr im standardmäßigen PCAP-Format
- ✅ Automatische Dateirotation, um große Dateien zu vermeiden
- ✅ Live-Paketstatistiken im ausführlichen Modus
- ✅ Unterstützung für BPF-Filter (Berkeley Packet Filter)
- ✅ Zeitlich begrenzte Erfassungen oder kontinuierlicher Betrieb
- ✅ Sichere Bereinigung bei Ctrl+C
- ✅ Ausgabe wird im Verzeichnis `output/` gespeichert

### Ausgabeort

Alle Erfassungen werden in `output/` mit Zeitstempel-basierten Dateinamen gespeichert:
- Format: `capture_YYYYMMDD_HHMMSS.pcap`
- Custom: `yourname_YYYYMMDD_HHMMSS.pcap`

### Analyse des erfassten Datenverkehrs```bash
# Open in Wireshark (GUI)
wireshark output/capture_20251018_143215.pcap

# Analyze with tcpdump
tcpdump -r output/capture_20251018_143215.pcap -n

# Filter for specific protocols
tcpdump -r output/capture_20251018_143215.pcap 'tcp port 80'

# Extract HTTP requests
tcpdump -r output/capture_20251018_143215.pcap -A 'tcp port 80'

# Get capture statistics
capinfos output/capture_20251018_143215.pcap

# Use tshark for advanced analysis
tshark -r output/capture_20251018_143215.pcap -Y "http.request"

---

## 📊 Überwachung

### Echtzeit-Verbindungsüberwachung

Das Toolkit bietet mehrere Möglichkeiten, verbundene Clients zu überwachen:

#### 1. Verbindungsprotokoll

Automatisch alle 5 Sekunden aktualisiert:```bash
tail -f logs/connections.log

#### 2. DHCP-Zuweisungen

DHCP-Leases in Echtzeit anzeigen:```bash
tail -f logs/dnsmasq.log

#### 3. Zugangspunkt-Status

Überwachen der hostapd-Protokolle:```bash
tail -f logs/hostapd.log

---

## 🔧 Fehlerbehebung

### Häufige Probleme und Lösungen

#### 1. "Keine drahtlosen Schnittstellen gefunden"

**Problem:** Ihr WLAN-Adapter wird nicht erkannt.

**Lösungen:**```bash
# Check if adapter is connected
lsusb | grep -i wireless

# Check interface name
ip link show

# Try replugging USB adapter

# Check kernel messages
dmesg | tail -20

# Run the detection script
sudo ./detect_interface.sh

#### 3. "hostapd failed to start"

**Problem:** hostapd kann den Access Point nicht starten.

**Lösungen:**```bash
# Check if interface is busy
sudo airmon-ng check kill

# Verify interface is up
sudo ip link set wlan1 up

# Check hostapd config syntax
sudo hostapd -d hostapd.conf

# View detailed logs
cat logs/hostapd.log

# Make sure you're using the right interface
grep "^interface=" hostapd.conf

#### 5. "Clients verbinden sich, haben aber kein Internet"

**Problem:** NAT/Routing ist nicht richtig konfiguriert.

**Lösungen:**```bash
# Verify IP forwarding
cat /proc/sys/net/ipv4/ip_forward
# Should output: 1

# Check NAT rules
sudo iptables -t nat -L -v

# Verify internet interface
ip route show default

# Test internet on host
ping -c 3 8.8.8.8

# Check if eth0 has internet
ping -I eth0 -c 3 8.8.8.8

#### 7. "Kanal X ist nicht verfügbar"

**Problem:** Funkvorschriften schränken bestimmte Kanäle ein.

**Lösungen:**```bash
# Check available channels for your country
iw list | grep -A 20 "Frequencies:"

# Edit hostapd.conf and change to available channel
nano hostapd.conf
# Common safe channels: 1, 6, 11 (2.4GHz)

#### 9. "Falsche Schnittstelle wird verwendet"

**Problem:** Skripte verwenden wlan0 anstelle von wlan1 (oder umgekehrt).

**Lösungen:**```bash
# Run interface detection
sudo ./detect_interface.sh

# Update config files to use correct interface
sed -i 's/^interface=.*/interface=wlan1/' hostapd.conf
sed -i 's/^interface=.*/interface=wlan1/' dnsmasq.conf

# Verify changes
grep "^interface=" hostapd.conf dnsmasq.conf

### Dateibeschreibungen

| Datei | Zweck | Ändern? |
|------|---------|---------|
| `hostapd.conf` | AP-Einstellungen (SSID, Kanal, Passwort, Schnittstelle) | ✅ Ja - für Ihren Test anpassen |
| `dnsmasq.conf` | DHCP/DNS-Konfiguration (Schnittstelle, IP-Bereich) | ✅ Ja - Netzwerkeinstellungen anpassen |
| `install_dependencies.sh` | Installiert erforderliche Pakete | ❌ Nein - wie besehen ausführen |
| `detect_interface.sh` | Erkennt drahtlose Schnittstellen & AP-Modus-Unterstützung | ❌ Nein - wie besehen ausführen |
| `start_evil_twin.sh` | Startet den Evil-Twin-AP | ⚠️ Selten - nur für fortgeschrittene Anpassungen |
| `stop_evil_twin.sh` | Stoppt und bereinigt | ❌ Nein - wie besehen ausführen |
| `capture_traffic.sh` | Erfasst Datenverkehr in PCAP-Dateien | ⚠️ Verwenden Sie stattdessen CLI-Optionen |
| `logs/*.log` | Laufzeitprotokolle | 📖 Nur-Lesen - zur Überwachung |
| `output/*.pcap` | Erfasste Paketdaten | 📖 Nur-Lesen - zur Analyse |

---

## 🔒 Sicherheitsaspekte

### Ethische Nutzungsrichtlinien

1. **Genehmigung**: Holen Sie IMMER eine schriftliche Genehmigung vor dem Testen
2. **Umfang**: Bleiben Sie im vereinbarten Testumfang
3. **Dokumentation**: Führen Sie detaillierte Protokolle aller Aktivitäten
4. **Offenlegung**: Melden Sie Ergebnisse verantwortungsvoll an die Netzwerkbesitzer
5. **Datenverarbeitung**: Fangen Sie keine Daten ab, speichern Sie sie nicht oder missbrauchen Sie sie nicht

### Rechtliche Hinweise

- Das Erstellen von nicht autorisierten Rogue Access Points ist in den meisten Ländern **ILLEGAL**
- Strafen können Geldstrafen, Haft und Vorstrafen umfassen
- Selbst „harmlose“ Tests können bei fehlender Autorisierung strafrechtlich verfolgt werden
- Unternehmensumgebungen: Holen Sie die schriftliche Genehmigung der IT-Abteilung ein
- Öffentliche Räume: Testen Sie NIEMALS in öffentlichen Netzwerken

### Technische Sicherheit

**Dieses Toolkit ist von Natur aus:**
- ✅ Konzentriert sich auf die Erstellung und Überwachung von Access Points
- ✅ Enthält Datenverkehrserfassung nur für autorisierte Analysen
- ✅ Bietet umfassende Protokollierung für die Nachvollziehbarkeit
- ⚠️ Enthält KEIN Credential Harvesting
- ⚠️ Enthält KEIN SSL-Stripping oder aktive MITM-Angriffe
- ⚠️ Enthält KEIN Captive-Portal-Phishing

**Um die Sicherheit Ihrer Tests zu erhöhen:**
- Verwenden Sie isolierte Netzwerksegmente
- Implementieren Sie eine Testnetzwerkkennung (eindeutige SSIDs)
- Begrenzen Sie Tests auf bestimmte Zeitfenster
- Überwachen und protokollieren Sie alle Aktivitäten
- Verwenden Sie es nur in Faraday-Käfigen oder HF-abgeschirmten Räumen, um Signalverluste zu vermeiden

### Abwehrmaßnahmen

Organisationen können sich vor Evil-Twin-Angriffen schützen, indem sie:

- Implementierung der **802.1X-Authentifizierung** (WPA2/WPA3 Enterprise)
- Verwendung der **Zertifikatsvalidierung** für die Netzwerkauthentifizierung
- Einsatz von **drahtlosen Eindringungserkennungssystemen (WIDS)**
- Aktivierung von **Protected Management Frames (PMF/802.11w)**
- Schulung der Benutzer zur Überprüfung der Netzwerkauthentizität
- Verwendung von VPNs für sensible Kommunikation
- Überwachung auf nicht autorisierte Access Points

---

## 🤝 Mitwirken

Beiträge sind willkommen! Bitte befolgen Sie diese Richtlinien:

### So können Sie beitragen

1. **Repository forken**
2. **Erstellen Sie einen Feature-Branch**: `git checkout -b feature/your-feature`
3. **Nehmen Sie Ihre Änderungen vor** mit klaren Commit-Nachrichten
4. **Testen Sie gründlich** auf mehreren Systemen, wenn möglich
5. **Aktualisieren Sie die Dokumentation**, wenn Sie die Funktionalität ändern
6. **Reichen Sie einen Pull-Request** mit detaillierter Beschreibung ein

### Richtlinien für Beiträge

- Behalten Sie die modulare Struktur bei
- Fügen Sie ausführliche Protokollierung für neue Funktionen hinzu
- Fügen Sie Fehlerbehandlung für Randfälle ein
- Aktualisieren Sie die README, wenn Sie neue Funktionen hinzufügen
- Befolgen Sie den vorhandenen Codestil (Bash-Best Practices)
- Fügen Sie Kommentare für komplexe Logik hinzu
- Testen Sie auf mindestens einer Debian-basierten Distribution

### Code Style```bash
# Use descriptive function names
configure_network_interface() {
    # Clear comments
    # Error handling
    # Verbose output
}

# Consistent formatting
print_info "Starting process..."
command || print_error "Failed to execute command"

---

## 🙏 Danksagungen

- Das Kali Linux Team für exzellente Wireless-Sicherheitswerkzeuge
- Die Projekte hostapd und dnsmasq
- Die Forschungsgemeinschaft für drahtlose Sicherheit
- Mitwirkende und Tester

---

## 📚 Zusätzliche Ressourcen

### Lernressourcen

- [OWASP Leitfaden zum Testen der Wireless-Sicherheit](https://owasp.org/www-project-web-security-testing-guide/)
- [WiFi Penetration Testing Methodik](https://www.sans.org/white-papers/)
- [Drahtlose Sicherheit auf Kali Linux](https://www.kali.org/docs/wireless/)

### Verwandte Werkzeuge

- **Aircrack-ng**: Wireless-Prüfungssuite
- **Wireshark**: Netzwerkprotokollanalysator
- **Bettercap**: Netzwerkangriffe und -überwachung
- **Wifiphisher**: Automatisierte Phishing-Angriffe auf WiFi

### Dokumentation

- [hostapd Dokumentation](https://w1.fi/hostapd/)
- [dnsmasq Handbuch](http://www.thekelleys.org.uk/dnsmasq/doc.html)
- [Linux Wireless Wiki](https://wireless.wiki.kernel.org/)
- [tcpdump Handbuch](https://www.tcpdump.org/manpages/tcpdump.1.html)

---

## 📞 Unterstützung

- **Probleme**: [GitHub Issues](https://github.com/yourusername/evil-twin-ap/issues)
- **Diskussionen**: [GitHub Discussions](https://github.com/yourusername/evil-twin-ap/discussions)
- **Sicherheit**: Melden Sie Schwachstellen per E-Mail (nicht über öffentliche Issues)

---

## ⚖️ Abschließende Warnung```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  This tool is provided for EDUCATIONAL PURPOSES ONLY        │
│                                                             │
│  Unauthorized access to computer networks is ILLEGAL        │
│                                                             │
│  Always obtain written permission before testing            │
│                                                             │
│  You are responsible for your actions                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘