Actuellement, seule une version néerlandaise de l'application est disponible. La version anglaise suivra bientôt.

Guide d'utilisation – Moniteur Wi-Fi Passif (Filtre ESSID + Bande)

Avis juridique et éthique (Utilisation éducative)

Pour une utilisation éducative et des tests autorisés uniquement. Vous êtes seul responsable de la manière dont vous utilisez cet outil. Perturber intentionnellement des réseaux que vous ne possédez pas ou pour lesquels vous n'avez pas d'autorisation écrite peut être illégal dans votre juridiction. Même une seule trame de désauthentification envoyée au réseau de quelqu'un d'autre peut être illégale. Utilisez uniquement avec une autorisation explicite et à vos risques et périls.

1) Objectif (en un coup d'œil)

Cette application découvre un SSID cible, liste les BSSID correspondants par bande (2,4/5/6 GHz) et surveille passivement chaque BSSID pour énumérer les clients et, le cas échéant, capturer des handshakes WPA au format .22000. Les boutons de désauthentification sont fonctionnels ; les désauthentifications actives sont effectuées.

2) Configuration système requise

Système d'exploitation : Linux avec iw, ip et systemd/NetworkManager.
Outils : airodump-ng (suite aircrack-ng), airmon-ng, hcxpcapngtool, iw, ip, systemctl.
Privilèges : Exécuter en tant que root (ou avec les capacités équivalentes pour les outils de capture).
Adaptateur Wi-Fi : Doit prendre en charge le mode moniteur et les bandes cibles. Le 6 GHz nécessite un chipset/pilote/noyau moderne.

3) Première installation

Vérifiez que les outils sont installés : which airodump-ng, which hcxpcapngtool, etc.
Lancez l'application : python3 votre_script.py.
Si vous voyez « Exécutez ce script en tant que root », redémarrez avec les privilèges suffisants.

Astuce : Utilisez Auto-test (voir §12) pour valider rapidement l'environnement.

4) Fichiers et dossiers

logs/<SAFE_ESSID>/session.log – journal de session tournant (rotation après ~5 Mo).
logs/<SAFE_ESSID>/discovery-01.csv – dernière sortie de découverte de bande.
logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – CSV de surveillance par BSSID.
logs/<SAFE_ESSID>/aliases.json – vos alias lisibles pour les MAC des clients.
logs/<SAFE_ESSID>/session.json – données de session (BSSID, clients, compteurs).
logs/<SAFE_ESSID>/*hs*.22000 – handshakes WPA capturés passivement.

<SAFE_ESSID> est une version sécurisée de votre ESSID compatible avec les noms de fichiers.

5) Aperçu de la fenêtre principale

5.1 Barre supérieure (Entrées)

Interface Wi-Fi Périphérique physique, ex. wlan1.
Nom du moniteur Nom à utiliser en mode moniteur, ex. mon0. L'application changera de mode et renommera si nécessaire.
Bande (2,4 / 5 / 6 GHz) Bande à analyser pour l'ESSID cible. Le 6 GHz nécessite une version récente d'aircrack-ng et un support pilote.
ESSID SSID exact à cibler (sensible à la casse).
Niveau de journalisation basic (minimal), verbose (plus de détails), debug (détails maximum).
Découverte (s) Durée de la passe de découverte de bande.
Analyse par BSSID (s) Temps d'écoute passif par BSSID pour énumérer les clients.
Démarrer / STOP Lance ou arrête le pipeline. STOP termine les processus et restaure l'état de NetworkManager/l'interface lorsque cela est applicable.

5.2 Tableau de découverte

Affiche tous les réseaux vus pendant la découverte (BSSID, canal, bande, ESSID).

Filtres optionnels (si activés dans votre build) :

Champ de recherche filtrant par BSSID/ESSID partiel.
« Masquer les SSID cachés » supprime les lignes vides/<hidden>.

5.3 Sélection de cible et de BSSID (filtrée par bande)

Liste les BSSID qui correspondent à votre ESSID et à la bande sélectionnée, y compris le canal. Cela identifie les points d'accès exacts appartenant à votre SSID.

5.4 Surveillance par BSSID

Ligne de statut – phase, BSSID actuel et temps restant.
Barre de progression – indéterminée pendant la découverte ; décompte pendant les analyses par BSSID.
Clients (BSSID actuel) – MAC des clients en direct ; affichés avec alias si définis.
Contrôles de saut – sauter la découverte ou passer au BSSID suivant.
Clients et handshakes… – ouvre le Centre client (voir §6).

5.5 Panneau de journalisation

Journaux horodatés (commandes, codes de sortie, sortie du convertisseur, erreurs). Persistent dans session.log avec rotation automatique. Ouvrir le répertoire des journaux ouvre le dossier de session actif.

6) Centre client

6.1 Points d'accès (gauche)

Affiche les BSSID correspondant à votre ESSID et bande. Sélectionnez-en un pour voir ses clients.

6.2 Clients (droite)

Liste les MAC des clients sous le BSSID sélectionné avec l'heure de Dernière vue.

Attribuer un alias (double-clic ou menu contextuel → Nommer…) Enregistrer une étiquette lisible pour un MAC (stockée dans aliases.json). Supprimer l'alias via le menu contextuel → Effacer l'alias.

6.3 Barre d'actions

Démarrer la surveillance (BSSID) Lance une capture passive de handshake pour le BSSID sélectionné. Affiche un décompte et un indicateur EAPOL.
Arrêter la surveillance Arrête la capture.
Diffusion / Ciblé client Espaces réservés uniquement (pas de désauthentification active dans cette version). Ils démarrent néanmoins une capture passive de handshake pour le même BSSID.
Paquets Valeur d'interface pour d'éventuelles variantes de laboratoire (non utilisée ici pour la désauthentification).
Exporter les clients Écrit un CSV (et JSON si activé) de tous les clients connus dans le dossier des journaux de session.

6.4 Panneau .22000

Affiche les premières lignes du dernier fichier .22000.
Copier le hash copie le texte dans le presse-papiers (pas d'effacement automatique dans cette version).
Ouvrir le dossier ouvre le répertoire contenant le .22000.

6.5 Barre de statut

⏳ Minuteur – compte à rebours (ou « en cours… » si indéfini).
EAPOL – passe à « oui » une fois que le convertisseur/la sortie standard suggère un handshake.

AirScout

Populaires