Benutzerhandbuch – Wi-Fi Passiver Monitor (ESSID + Bandfilter)

Rechtlicher & ethischer Hinweis (Nur zu Bildungszwecken)

Nur für Bildungszwecke und autorisierte Tests. Du trägst die alleinige Verantwortung für die Nutzung dieses Werkzeugs. Das absichtliche Stören von Netzwerken, die dir nicht gehören oder für die du keine schriftliche Genehmigung zum Testen hast, kann in deinem Land illegal sein. Selbst ein einzelnes Deauthentifizierungs-Frame, das an das Netzwerk einer anderen Person gesendet wird, kann rechtswidrig sein. Verwende es nur mit ausdrücklicher Genehmigung und auf eigenes Risiko.

1) Zweck (Auf einen Blick)

Diese Anwendung findet eine Ziel-SSID, listet passende BSSIDs nach Band (2,4/5/6 GHz) auf und überwacht jede BSSID passiv, um Clients zu erfassen und, falls vorhanden, WPA-Handshakes in .22000 zu speichern. Deauthentifizierungs-Schaltflächen sind aktiv arbeitend; aktive Deauths werden durchgeführt.

2) Systemanforderungen

Betriebssystem: Linux mit iw, ip und systemd/NetworkManager.
Werkzeuge: airodump-ng (aircrack-ng-Suite), airmon-ng, hcxpcapngtool, iw, ip, systemctl.
Rechte: Als root ausführen (oder mit entsprechenden Fähigkeiten für Erfassungswerkzeuge).
WLAN-Adapter: Muss den Monitor-Modus und die Ziel-Bänder unterstützen. 6 GHz erfordert modernen Chipsatz/Treiber/Kernel.

3) Ersteinrichtung

Überprüfen, ob die Werkzeuge installiert sind: which airodump-ng, which hcxpcapngtool usw.
App starten: python3 dein_skript.py.
Falls „Führe dieses Skript als root aus“ erscheint, mit ausreichenden Rechten neu starten.

Tipp: Selbsttest (siehe §12) verwenden, um die Umgebung schnell zu validieren.

4) Dateien & Ordner

logs/<SAFE_ESSID>/session.log – fortlaufendes Sitzungsprotokoll (rotiert nach ~5 MB).
logs/<SAFE_ESSID>/discovery-01.csv – letzte Band-Erkennungsausgabe.
logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – pro BSSID-Überwachungs-CSV.
logs/<SAFE_ESSID>/aliases.json – deine lesbaren Aliase für Client-MACs.
logs/<SAFE_ESSID>/session.json – Sitzungsdaten (BSSIDs, Clients, Zähler).
logs/<SAFE_ESSID>/*hs*.22000 – passiv erfasste WPA-Handshakes.

<SAFE_ESSID> ist eine bereinigte, dateinamensichere Version deiner ESSID.

5) Hauptfenster-Übersicht

5.1 Obere Leiste (Eingaben)

WLAN-Schnittstelle Physikalisches Gerät, z. B. wlan1.
Monitor-Name Name, der im Monitor-Modus verwendet werden soll, z. B. mon0. Die App wechselt den Modus und benennt ggf. um.
Band (2,4 / 5 / 6 GHz) Band, das nach der Ziel-ESSID durchsucht werden soll. 6 GHz erfordert aktuelle aircrack-ng- und Treiberunterstützung.
ESSID Exakte SSID, die anvisiert wird (Groß-/Kleinschreibung beachten).
Log-Level basic (minimal), verbose (ausführlicher), debug (maximale Details).
Erkennung (s) Dauer des Band-Erkennungsdurchgangs.
Scan pro BSSID (s) Passive Hörzeit pro BSSID, um Clients zu erfassen.
Start / STOP Startet oder stoppt die Pipeline. STOP beendet Prozesse und stellt NetworkManager/Schnittstellenzustand (wenn anwendbar) wieder her.

5.2 Erkennungstabelle

Zeigt alle während der Erkennung gesehenen Netzwerke (BSSID, Kanal, Band, ESSID).

Optionale Filter (falls in deinem Build aktiviert):

Suchfeld filtert nach Teil-BSSID/ESSID.
„Versteckte SSIDs ausblenden“ entfernt leere/<hidden>-Zeilen.

5.3 Ziel- & BSSID-Auswahl (bandgefiltert)

Listet BSSIDs auf, die deiner ESSID und dem ausgewählten Band entsprechen, inklusive Kanal. Dies identifiziert die genauen APs deiner SSID.

5.4 Pro-BSSID-Überwachung

Statuszeile – Phase, aktuelle BSSID und verbleibende Zeit.
Fortschrittsbalken – unbestimmt während der Erkennung; Countdown während der Scans pro BSSID.
Clients (aktuelle BSSID) – Live-Client-MACs; bei gesetzten Aliasen mit diesen angezeigt.
Steuerung zum Überspringen – Erkennung überspringen oder zur nächsten BSSID springen.
Clients & Handshakes… – öffnet das Client-Center (siehe §6).

5.5 Protokollbereich

Zeitgestempelte Logs (Befehle, Exit-Codes, Konverterausgabe, Fehler). Werden in session.log gespeichert und automatisch rotiert. Protokollverzeichnis öffnen öffnet den aktiven Sitzungsordner.

6) Client-Center

6.1 Zugangspunkte (links)

Zeigt BSSIDs an, die deiner ESSID und deinem Band entsprechen. Wähle eine aus, um ihre Clients anzuzeigen.

6.2 Clients (rechts)

Listet Client-MACs unter der ausgewählten BSSID mit Zuletzt gesehen-Zeit.

Alias zuweisen (Doppelklick oder Kontextmenü → Name…) Speichere eine lesbare Bezeichnung für eine MAC (gespeichert in aliases.json). Alias entfernen über Kontextmenü → Alias löschen.

6.3 Aktionsleiste

Überwachung starten (BSSID) Startet eine passive Handshake-Erfassung für die ausgewählte BSSID. Zeigt einen Countdown und EAPOL-Indikator.
Überwachung stoppen Stoppt die Erfassung.
Broadcast / Client-gerichtet Nur Platzhalter (kein aktives Deauth in diesem Build). Sie starten dennoch eine passive Handshake-Erfassung für dieselbe BSSID.
Pakete UI-Wert für mögliche Laborvarianten (hier nicht für Deauth verwendet).
Clients exportieren Schreibt CSV (und JSON, falls aktiviert) aller bekannten Clients in den Sitzungsprotokollordner.

6.4 .22000-Bereich

Zeigt die ersten Zeilen der neuesten .22000-Datei.
Hash kopieren kopiert den Text in die Zwischenablage (kein automatisches Löschen in diesem Build).
Ordner öffnen öffnet das Verzeichnis mit der .22000.

6.5 Statusleiste

⏳ Timer – zählt herunter (oder „läuft…“ bei unbestimmter Dauer).
EAPOL – wechselt auf „ja“, sobald Konverter/stdout auf einen Handshake hindeuten.

7) Funktionaler Ablauf (Hinter den Kulissen)

Preflight – Überprüft erforderliche Binärdateien; zeigt explizite Fehler an, wenn sie fehlen.
Monitor-Modus – Schaltet die Schnittstelle in den Monitor-Modus und wendet deinen Monitor-Namen an; stellt den Systemzustand bei STOP/Beenden wieder her.
Erkennung – Führt airodump-ng --band <bg|a|6> in eine CSV aus; robuster headerbasierter Parser behandelt kuriose ESSIDs/CSV-Formate.
BSSID-Auswahl – Filtert nach exakter ESSID und ausgewähltem Band.
Pro-BSSID-Überwachung – Fixiert den Kanal (mit Frequenz-Fallback bei 6 GHz) und führt airodump-ng --bssid … --channel … aus; parst den CSV-Abschnitt Stations, um neue Clients live anzuzeigen.
Handshake (.22000) – Während der Überwachung (oder über Client-Center-Schaltflächen) wird die neueste .cap mit hcxpcapngtool konvertiert. Wenn eine nicht leere .22000 existiert, wird sie angezeigt und protokolliert. Desktop-Benachrichtigungen werden ausgegeben, wo unterstützt.
Watchdog – Wenn airodump-ng verstummt, wird der Prozess für diesen Schritt (Erkennung oder pro BSSID) sauber neu gestartet.
Inotify (optional) – Verwendet inotify für sofortige Dateiänderungsanalyse; fällt auf leichtgewichtiges mtime-Polling zurück, wenn nicht verfügbar.
Protokollierung – Erfasst sowohl stdout als auch stderr; rotiert session.log automatisch.
Sitzungspersistenz – Schreibt fortlaufend BSSIDs/Clients/Aliase/Zähler in session.json und lädt sie beim Start für dieselbe ESSID neu.

8) Schnellstart

Konfigurieren
- WLAN-Schnittstelle auswählen (z. B. wlan1).
- Monitor-Name festlegen (z. B. mon0).
- Band wählen (2,4/5/6 GHz).
- ESSID eingeben (exakt).
- Erkennung auf 15–30 s und Pro BSSID auf 45–60 s setzen.
- Log-Level verbose wählen.
Ausführen
- Auf Start klicken. Den Erkennungsfortschritt beobachten.
- Nach Abschluss die Erkennungstabelle überprüfen.
BSSIDs prüfen

AirScout

Beliebteste