AirmonGUI

Une interface web locale pour la suite d'outils sans fil aircrack-ng.

Captures d'écran · Démarrage rapide · Fonctionnalités · Feuille de route · Contribuer

[!WARNING] Utilisez ceci uniquement sur des réseaux dont vous êtes propriétaire ou pour lesquels vous avez une autorisation écrite de test. Scanner, déauthentifier ou capturer le trafic de réseaux que vous ne contrôlez pas est illégal dans la plupart des endroits. Voir Utilisation légale et responsable.

Ce que c'est

AirmonGUI rassemble airmon-ng, airodump-ng, aireplay-ng, et aircrack-ng derrière une application web qui tourne sur votre propre machine. Vous activez le mode moniteur, scannez les réseaux, capturez une poignée de main WPA et la craquez en cliquant sur des formulaires étiquetés au lieu de vous souvenir des options.

Il ne réimplémente aucun des outils. Le backend exécute les vrais binaires et analyse leur sortie, donc ce que vous voyez est ce que la suite a réellement fait. L'interface se lie à 127.0.0.1 et l'API n'atteint jamais l'extérieur de votre machine.

Pourquoi je l'ai construit

La suite aircrack-ng est excellente, mais le workflow s'étend sur quatre commandes distinctes et de nombreuses options que vous devez garder en tête : mettre la carte en mode moniteur, changer de canal pour trouver une cible, se verrouiller sur un BSSID, envoyer des déauthentifications sur le bon canal, attendre la poignée de main à quatre voies, puis alimenter la capture avec une liste de mots. Si vous manquez le canal, la déauth ne va nulle part. Si vous oubliez --bssid, votre capture est pleine de bruit.

Je voulais cette séquence entière sous forme d'écrans qui vous guident, vous montrent ce qui est dans les ondes, et gardent l'état cohérent entre les étapes. C'est ce que c'est. Cela fonctionne bien pour apprendre comment les attaques se comportent vraiment, pour le travail en laboratoire, et pour accélérer une évaluation autorisée.

Fonctionnalités

Comment ça marche

Une exécution se déroule de haut en bas dans la barre latérale. Voici chaque écran.

Les réseaux, BSSID et clients dans les captures d'écran ci-dessous sont des données de démonstration synthétiques, pas une capture réelle.

1. Mettre l'adaptateur en mode moniteur

Choisissez une interface, vérifiez son pilote, chipset et PHY, et activez le mode moniteur. Libérez juste cette interface quand vous avez terminé.

2. Scanner les ondes

Lancez une tâche airodump-ng et regardez les points d'accès et les clients se remplir au fur et à mesure qu'ils sont trouvés. Filtrez le tableau, puis envoyez n'importe quel réseau directement vers un workflow de déauthentification ou de capture de poignée de main.

3. Choisir une cible

L'analyse du signal note chaque point d'accès pour que ceux qui sont forts, faiblement sécurisés et avec des clients actifs remontent en haut. Elle montre aussi à quel point chaque canal est occupé et quelle sécurité les réseaux environnants utilisent. Vos propres appareils sont signalés pour que vous ne pointiez rien sur vous-même par erreur.

4. Capturer la poignée de main

Cet écran verrouille airodump-ng sur le BSSID et le canal de la cible, exécute le moteur de déauthentification automatique pour déconnecter les clients afin qu'ils se reconnectent, et devient vert dès qu'une poignée de main à quatre voies est capturée.

5. La craquer

Pointez aircrack-ng vers la capture et une liste de mots. Le journal défile pendant l'exécution, et si la phrase de passe est dans votre liste, elle apparaît en haut.

Plus de captures : déauth, captures, journaux

Déauthentification autonome avec verrouillage de canal, historique d'exécution et sortie d'événements analysée :

Gestion des fichiers de capture :

Historique des commandes de session :

Démarrage rapide

Vous avez besoin de Linux, de root, d'un adaptateur sans fil qui supporte le mode moniteur, et de la suite aircrack-ng dans votre $PATH. Voir Prérequis pour la liste complète.

# 0. Installer la suite (Debian, Ubuntu, Kali)
sudo apt update && sudo apt install aircrack-ng wireless-tools

# 1. Cloner
git clone https://github.com/ELHart05/AirmonGUI.git
cd AirmonGUI

# 2. Backend (terminal 1)
cd backend
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
sudo -E .venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

# 3. Frontend (terminal 2)
cd frontend
npm install
npm run dev

Ouvrez http://localhost:5173. L'interface ne parle qu'à 127.0.0.1:8000.

Lors de la première connexion, l'interface demande un jeton API. Le backend en affiche un dans sa console au démarrage, comme ceci :

======================================================================
Jeton API AirmonGUI (généré pour cette exécution) :

    Xy3k...long-random-string...

Collez-le dans l'interface web AirmonGUI lorsqu'il vous est demandé.
======================================================================

Collez ce jeton dans l'écran de déverrouillage. Pour conserver un jeton fixe entre les redémarrages, définissez AIRMON_GUI_AUTH_TOKEN dans backend/.env (le backend charge ce fichier au démarrage). Toutes les routes API, à l'exception de la vérification de santé, nécessitent ce jeton, ce qui empêche un processus local errant ou une page web que vous visitez par hasard de piloter les outils sans fil dans votre dos. Vous devez définir le jeton explicitement avant de lier le backend à autre chose que 127.0.0.1 — sinon il refuse de démarrer.

Si la demande est juste une friction sur une machine mono-utilisateur, définissez AIRMON_GUI_AUTH_ENABLED=false pour désactiver complètement l'authentification ; l'interface ignore alors l'écran de déverrouillage. Avec l'authentification désactivée, le backend refuse de se lier ailleurs que sur la boucle locale — pointez API_HOST vers autre chose que 127.0.0.1 et il ne démarrera pas.

Root est nécessaire car airmon-ng, airodump-ng et aireplay-ng utilisent des sockets bruts. Appelez .venv/bin/uvicorn directement plutôt que uvicorn simple, car sudo réinitialise PATH et manquerait sinon l'environnement virtuel ; le drapeau -E conserve toutes les variables AIRMON_GUI_* que vous avez définies. Si vous préférez ne pas exécuter le serveur en tant que root, mettez en place sudo sans mot de passe pour ces binaires spécifiques et ajustez backend/app/utils.py.

cd frontend
npm run build   # écrit les fichiers statiques dans frontend/dist/

Stack technique

Architecture

AirmonGUI
├── backend/    API REST FastAPI et WebSocket, un module de route par outil
│               app/routes/ (interfaces, airodump, aireplay, aircrack, handshake, captures)
│               app/models.py (E/S validées Pydantic), app/state.py (registre de tâches en processus)
│               app/utils.py (logique de sous-processus et sudo), app/config.py (configuration env)
│
├── frontend/   Application monopage Vue 3, la console de contrôle
│               views/ (Overview, Monitor, Scan, Signal, Deauth, Handshake, Crack, Captures, Reports, Terminal, Logs)
│               composables/ (logique réactive de tâches et d'état), api/ (wrappers fetch)
│
└── website/    Site d'accueil React autonome (optionnel)

Le backend sert une API REST à http://127.0.0.1:8000/api et un WebSocket de terminal à /ws/terminal (protégé par le jeton API ; désactivez-le avec AIRMON_GUI_TERMINAL_ENABLED=0). En développement, le serveur de développement Vite sur :5173 proxy les deux vers le backend.

Prérequis

Dépannage

Impossible de verrouiller wlan0 sur le canal N ou scan sans réseau. L'interface est presque toujours encore en mode géré. Le mode moniteur est ce qui permet à l'adaptateur de capturer et de changer de canal. Activez-le depuis l'onglet Moniteur d'abord (ou airmon-ng start wlan0), puis scannez sur l'interface moniteur — souvent wlan0mon, bien que certains pilotes conservent le nom original. Le scan refuse une interface gérée avec ce même indice, et un scan mono-canal n'abandonne plus si le pré-verrouillage ne peut être vérifié, puisque airodump-ng règle le canal lui-même.

Les réseaux apparaissent au premier lancement mais pas au second. Une interface moniteur résiduelle, ou NetworkManager qui reprend l'adaptateur entre les exécutions, peut la laisser dans un état bloqué. Exécutez airmon-ng check kill (bouton Check Kill) avant de scanner, et arrêtez un scan avant d'en démarrer un autre sur la même interface.

Feuille de route

Toute aide sur l'un de ces points est la bienvenue. Voir Contribuer.

• Lanceur en une commande (une cible Makefile ou Docker Compose) pour le backend et le frontend
• Un relais hashcat pour le craquage GPU
• Capture et attaque PMKID
• Graphiques des clients et points d'accès au fil du temps
• La vue Reports, terminée et exportable
• Une version packagée et un script d'installation

Vous avez une idée ? Ouvrez un ticket. Les demandes de fonctionnalités et les questions sont les bienvenues.

Contribuer

Les pull requests sont les bienvenues, et plus elles sont petites et ciblées, mieux c'est.

1. Lisez CONTRIBUTING.md pour la configuration, la vérification et les règles de sécurité.
2. Forkez, créez une branche et limitez le changement à une seule chose.
3. Vérifiez que le backend (uvicorn) et le frontend (npm run dev) démarrent tous deux proprement.
4. Ouvrez une PR qui explique ce qui a changé et pourquoi.

Chaque dossier a son propre README avec des notes : backend, frontend, website.

Si le projet vous est utile, une étoile aide d'autres personnes à le trouver et me dit que ça vaut la peine de continuer.

Historique des étoiles

Utilisation légale et responsable

AirmonGUI est destiné aux tests sans fil autorisés, à la recherche et à l'enseignement sur des réseaux dont vous êtes propriétaire ou pour lesquels vous avez une autorisation écrite d'évaluation.

Intercepter le trafic et déauthentifier des réseaux ou des appareils que vous ne contrôlez pas est illégal dans la plupart des juridictions. Les valeurs par défaut maintiennent l'API et le serveur de développement sur la boucle locale pour une bonne raison, ne les exposez donc pas sur un réseau partagé ou public. Les auteurs n'assument aucune responsabilité en cas de mauvaise utilisation. En utilisant ce logiciel, vous confirmez que vous avez la permission pour chaque réseau et chaque appareil que vous touchez.

Utilisez-le pour comprendre et défendre les réseaux, pas pour attaquer ceux qui ne sont pas les vôtres.

Licence

MIT, voir LICENSE. Construit au-dessus du projet aircrack-ng, qui fait le travail réel.