Boîte à outils de point d'accès Evil Twin

Une configuration complète, modulaire et reproductible de point d'accès Evil Twin pour les tests de sécurité défensive, les tests d'intrusion et la recherche en sécurité sans fil.

⚠️ Avertissement légal

POUR USAGE ÉDUCATIF ET TESTS DE SÉCURITÉ AUTORISÉS UNIQUEMENT

Cet outil est fourni pour :

Fins éducatives
Tests d'intrusion autorisés
Recherche en sécurité dans des environnements contrôlés
Formation à la sécurité défensive

L'UTILISATION ILLÉGALE EST STRICTEMENT INTERDITE. L'accès non autorisé à des réseaux informatiques est un crime dans la plupart des juridictions. Les utilisateurs sont seuls responsables de :

L'obtention d'une autorisation écrite avant tout test
Le respect de toutes les lois et réglementations applicables
Toute conséquence résultant d'une mauvaise utilisation

En utilisant cet outil, vous acceptez de ne l'utiliser que sur des réseaux dont vous êtes propriétaire ou pour lesquels vous avez obtenu une autorisation écrite explicite.

🎯 Présentation

Cette boîte à outils crée un point d'accès sans fil frauduleux (Evil Twin) qui imite un réseau légitime. Elle capture le trafic réseau en créant un SSID identique auquel les clients peuvent se connecter automatiquement, croyant qu'il s'agit du réseau légitime.

Qu'est-ce qu'une attaque Evil Twin ?

Un Evil Twin est un point d'accès Wi-Fi frauduleux qui semble légitime mais qui est configuré pour espionner les communications sans fil. L'attaque fonctionne en plaçant un point d'accès frauduleux à proximité du réseau cible, en diffusant le même SSID, et en trompant les appareils pour qu'ils se connectent.

Cas d'utilisation

🔐 Tests d'intrusion de sécurité sans fil
🎓 Formation et démonstrations de sensibilisation à la sécurité
🧪 Recherche en sécurité réseau en laboratoire
🛡️ Test des systèmes de détection d'intrusion sans fil
📱 Analyse du comportement des appareils et de la connectivité des clients

✨ Fonctionnalités

🔧 Conception modulaire : Séparation claire des préoccupations avec des fonctions réutilisables
📊 Sortie détaillée : Messages d'état codés par couleur pour chaque opération
🔍 Surveillance en temps réel : Suivi en direct des clients connectés avec horodatages
📝 Journalisation complète : Journaux détaillés pour hostapd, dnsmasq et les connexions
🌐 Partage Internet : Configuration NAT automatique pour le passage Internet
🔄 Découverte automatique : Détection automatique de l'interface connectée à Internet
🧹 Nettoyage propre : Arrêt gracieux avec restauration complète du système
✅ Gestion des dépendances : Installation et vérification automatisées
🎨 Multi-plateforme : Prend en charge Debian, Ubuntu, Kali, Fedora, Arch et plus
📦 Reproductible : Fichiers de configuration contrôlables par version
📡 Détection d'interface : Détection automatique de l'adaptateur sans fil et vérification du mode AP
📸 Capture de trafic : Capture PCAP intégrée avec filtrage et rotation

🔌 Configuration matérielle requise

Carte réseau sans fil

Votre adaptateur sans fil DOIT prendre en charge le mode AP (Point d'accès). Toutes les cartes sans fil ne supportent pas cette fonctionnalité.

✅ Adaptateurs recommandés

Ces adaptateurs sont connus pour bien fonctionner et prendre en charge le mode AP :

Chipset	Exemples de modèles	Caractéristiques	Fourchette de prix
RTL8812AU	Alfa AWUS036ACH, TP-Link Archer T4U	Bi-bande (2,4/5GHz), Haute puissance, Excellente portée	40-60 $
RTL8814AU	Alfa AWUS1900, TP-Link Archer T9UH	Quad antenna, AC1900, Longue portée	60-80 $
Atheros AR9271	TP-Link TL-WN722N v1, Alfa AWUS036NHA	Stable, Bien supporté, Économique	20-35 $
MT7612U	Panda PAU0D, Alfa AWUS036ACM	Bi-bande, Bonne compatibilité	35-50 $
RTL8188EU	Divers adaptateurs économiques	Basique, 2,4GHz seulement, Entrée de gamme	10-20 $

🏆 Meilleures recommandations

Alfa AWUS036ACH (RTL8812AU)
- Meilleur choix global pour les tests d'intrusion
- Excellent support de pilotes sous Kali Linux
- Haute puissance d'émission (jusqu'à 30dBm)
- Support bi-bande
TP-Link TL-WN722N v1 (Atheros AR9271)
- Meilleure option économique
- Stabilité inébranlable
- Support natif Linux
- ⚠️ Assurez-vous d'obtenir la version 1, pas la v2 ou v3
Alfa AWUS036ACM (MT7612U)
- Bon équilibre entre prix et performances
- Excellente compatibilité
- Puissance de sortie moyenne

❌ Adaptateurs à éviter

Cartes sans fil intégrées aux ordinateurs portables (ne supportent généralement pas le mode AP)
Chipset RTL8188FTV (mauvais support du mode AP)
Chipset Broadcom (support Linux limité)
Tout adaptateur étiqueté « v2 » ou « v3 » de modèles fonctionnant auparavant (utilisent souvent des chipsets différents et incompatibles)

Vérification du support du mode AP

Avant d'acheter, vérifiez que l'adaptateur prend en charge le mode AP :```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

### Matériel supplémentaire

- **Connexion Ethernet** : Requise pour le passage Internet (peut être un adaptateur physique ou USB-Ethernet)
- **Alimentation USB suffisante** : Certains adaptateurs haute puissance peuvent nécessiter un hub USB alimenté
- **Ordinateur** : Tout ordinateur portable ou de bureau fonctionnant sous Linux (recommandé : Kali Linux)

---

## 💻 Configuration logicielle requise

### Système d'exploitation

- **Recommandé** : Kali Linux (2020.1 ou ultérieur)
- **Également supporté** :
  - Debian 10+
  - Ubuntu 18.04+
  - Fedora 30+
  - Arch Linux
  - ParrotOS
  - BlackArch

### Paquets requis

Ceux-ci seront automatiquement installés par `install_dependencies.sh` :

- `hostapd` - Crée le point d'accès
- `dnsmasq` - Fournit les services DHCP et DNS
- `iptables` - Configure les règles NAT et pare-feu
- `iproute2` - Configuration de l'interface réseau
- `wireless-tools` - Utilitaires de gestion sans fil
- `net-tools` - Outils de diagnostic réseau
- `iw` - Utilitaire de configuration sans fil
- `tcpdump` - Utilitaire de capture de paquets

### Privilèges

- L'accès root/sudo est requis pour toutes les opérations

---

## 📦 Installation

### Démarrage rapide```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

Installation détaillée

Étape 1 : Cloner le dépôt```bash

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

#### Étape 2 : Installer les dépendances

evil-twin-ap

Populaires