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

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

Le script d'installation détecte automatiquement votre distribution Linux et installe les paquets requis :```bash
sudo ./install_dependencies.sh

Ce script analysera toutes les interfaces sans fil et recommandera la meilleure à utiliser.

**Exemple de sortie:**```
==========================================
   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'

---

## ⚙️ Configuration

### hostapd.conf - Paramètres du point d'accès

Modifiez `hostapd.conf` pour personnaliser votre jumeau malveillant :```bash
nano hostapd.conf

### dnsmasq.conf - Paramètres DHCP/DNS

Modifiez `dnsmasq.conf` pour personnaliser les paramètres réseau :```bash
nano dnsmasq.conf

### Configuration réseau

**Paramètres par défaut :**
- **IP de l'AP** : 192.168.99.1
- **Sous-réseau** : 192.168.99.0/24
- **Plage DHCP** : 192.168.99.10 - 192.168.99.250
- **Canal** : 6 (2,4 GHz)
- **Mot de passe** : letitrain2
- **Interface** : wlan1 (adaptateur externe)

---

## 🚀 Utilisation

### Démarrage du jumeau maléfique```bash
sudo ./start_evil_twin.sh

### Arrêter l'Evil Twin```bash
sudo ./stop_evil_twin.sh

---

## 📸 Capture du trafic

### Capture du trafic réseau

La boîte à outils comprend un script complet de capture de trafic qui enregistre les données de paquets sous forme de fichiers PCAP pour analyse :```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

### Fonctionnalités de capture

- ✅ Enregistre le trafic au format PCAP standard
- ✅ Rotation automatique des fichiers pour éviter les fichiers énormes
- ✅ Statistiques en direct des paquets en mode verbeux
- ✅ Prise en charge du filtrage BPF (Berkeley Packet Filter)
- ✅ Captures temporisées ou opération continue
- ✅ Nettoyage sûr sur Ctrl+C
- ✅ Sortie enregistrée dans le répertoire `output/`

### Emplacement de sortie

Toutes les captures sont enregistrées dans `output/` avec des noms de fichiers basés sur l'horodatage :
- Format : `capture_YYYYMMDD_HHMMSS.pcap`
- Personnalisé : `yourname_YYYYMMDD_HHMMSS.pcap`

### Analyse du trafic capturé```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"

---

## 📊 Surveillance

### Surveillance en temps réel des connexions

La boîte à outils offre plusieurs moyens de surveiller les clients connectés :

#### 1. Journal des connexions

Mis à jour automatiquement toutes les 5 secondes :```bash
tail -f logs/connections.log

#### 2. Attributions DHCP

Voir les baux DHCP en temps réel :```bash
tail -f logs/dnsmasq.log

#### 3. État du point d'accès

Surveiller les logs hostapd:```bash
tail -f logs/hostapd.log

---

## 🔧 Dépannage

### Problèmes courants et solutions

#### 1. "Aucune interface sans fil trouvée"

**Problème :** Votre adaptateur sans fil n'est pas détecté.

**Solutions :**```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 n'a pas réussi à démarrer"

**Problème:** hostapd ne peut pas démarrer le point d'accès.

**Solutions:**```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. "Les clients se connectent mais n'ont pas internet"

**Problème:** Le NAT/routage n'est pas configuré correctement.

**Solutions:**```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. « Le canal X n'est pas disponible »

**Problème :** Les réglementations sans fil restreignent certains canaux.

**Solutions :**```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. "Mauvaise interface utilisée"

**Problème:** Les scripts utilisent wlan0 au lieu de wlan1 (ou vice versa).

**Solutions:**```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

### Descriptions des fichiers

| Fichier | But | Modifier ? |
|---------|-----|------------|
| `hostapd.conf` | Paramètres AP (SSID, canal, mot de passe, interface) | ✅ Oui - personnalisez pour votre test |
| `dnsmasq.conf` | Configuration DHCP/DNS (interface, plage IP) | ✅ Oui - ajustez les paramètres réseau |
| `install_dependencies.sh` | Installe les paquets requis | ❌ Non - exécutez tel quel |
| `detect_interface.sh` | Détecte les interfaces sans fil et le support du mode AP | ❌ Non - exécutez tel quel |
| `start_evil_twin.sh` | Démarre le point d'accès jumeau maléfique | ⚠️ Rarement - uniquement pour personnalisation avancée |
| `stop_evil_twin.sh` | Arrête et nettoie | ❌ Non - exécutez tel quel |
| `capture_traffic.sh` | Capture le trafic vers des fichiers PCAP | ⚠️ Utilisez plutôt les options CLI |
| `logs/*.log` | Journaux d'exécution | 📖 Lecture seule - pour surveillance |
| `output/*.pcap` | Données de paquets capturées | 📖 Lecture seule - pour analyse |

---

## 🔒 Considérations de sécurité

### Directives d'utilisation éthique

1. **Autorisation** : Obtenez TOUJOURS une autorisation écrite avant de tester
2. **Périmètre** : Restez dans le périmètre convenu des tests
3. **Documentation** : Conservez des journaux détaillés de toutes les activités
4. **Divulgation** : Signalez les résultats de manière responsable aux propriétaires du réseau
5. **Gestion des données** : N'interceptez, ne stockez et n'utilisez pas abusivement les données capturées

### Considérations légales

- Créer des points d'accès non autorisés sans autorisation est **ILLÉGAL** dans la plupart des pays
- Les sanctions peuvent inclure des amendes, l'emprisonnement et des casiers judiciaires
- Même les tests « inoffensifs » peuvent être poursuivis s'ils ne sont pas autorisés
- Environnements d'entreprise : Obtenez l'approbation écrite du service informatique
- Espaces publics : NE testez JAMAIS sur les réseaux publics

### Sécurité technique

**Cette boîte à outils par conception :**
- ✅ Se concentre sur la création et la surveillance de points d'accès
- ✅ Inclut la capture de trafic uniquement pour une analyse autorisée
- ✅ Fournit une journalisation complète pour la responsabilité
- ⚠️ N'inclut PAS la récolte d'identifiants
- ⚠️ N'inclut PAS le déshabillage SSL ni les attaques MITM actives
- ⚠️ N'inclut PAS le hameçonnage par portail captif

**Pour renforcer la sécurité de vos tests :**
- Utilisez des segments réseau isolés
- Mettez en œuvre une identification de réseau de test (SSID uniques)
- Limitez les tests à des fenêtres temporelles spécifiques
- Surveillez et journalisez toutes les activités
- Utilisez uniquement dans des cages de Faraday ou des salles blindées RF pour éviter les fuites de signal

---

### Mesures défensives

Les organisations peuvent se protéger contre les attaques de jumeau maléfique en :
- Mettre en œuvre **l'authentification 802.1X** (WPA2/WPA3 Enterprise)
- Utiliser **la validation de certificat** pour l'authentification réseau
- Déployer **des systèmes de détection d'intrusion sans fil (WIDS)**
- Activer **les trames de gestion protégées (PMF/802.11w)**
- Former les utilisateurs à vérifier l'authenticité du réseau
- Utiliser des VPN pour les communications sensibles
- Surveiller les points d'accès non autorisés

---

## 🤝 Contribution

Les contributions sont les bienvenues ! Veuillez suivre ces directives :

### Comment contribuer

1. **Fork (dupliquer) le dépôt**
2. **Créez une branche de fonctionnalité** : `git checkout -b feature/your-feature`
3. **Effectuez vos modifications** avec des messages de commit clairs
4. **Testez minutieusement** sur plusieurs systèmes si possible
5. **Mettez à jour la documentation** si vous changez des fonctionnalités
6. **Soumettez une pull request** avec une description détaillée

### Directives de contribution

- Maintenez la structure modulaire
- Ajoutez une journalisation détaillée pour les nouvelles fonctionnalités
- Incluez la gestion des erreurs pour les cas limites
- Mettez à jour le README si vous ajoutez de nouvelles fonctionnalités
- Suivez le style de code existant (bonnes pratiques bash)
- Ajoutez des commentaires pour la logique complexe
- Testez sur au moins une distribution basée sur Debian

### Style de code```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"

---

## 🙏 Remerciements

- L'équipe Kali Linux pour ses excellents outils de sécurité sans fil
- Les projets hostapd et dnsmasq
- La communauté de recherche en sécurité sans fil
- Les contributeurs et testeurs

---

## 📚 Ressources supplémentaires

### Ressources d'apprentissage

- [Guide de test de sécurité sans fil OWASP](https://owasp.org/www-project-web-security-testing-guide/)
- [Méthodologie de test d'intrusion WiFi](https://www.sans.org/white-papers/)
- [Sécurité sans fil sur Kali Linux](https://www.kali.org/docs/wireless/)

### Outils connexes

- **Aircrack-ng** : Suite d'audit sans fil
- **Wireshark** : Analyseur de protocole réseau
- **Bettercap** : Attaques réseau et surveillance
- **Wifiphisher** : Attaques de phishing automatisées sur WiFi

### Documentation

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

---

## 📞 Support

- **Problèmes** : [GitHub Issues](https://github.com/yourusername/evil-twin-ap/issues)
- **Discussions** : [GitHub Discussions](https://github.com/yourusername/evil-twin-ap/discussions)
- **Sécurité** : Signalez les vulnérabilités par email (pas via les problèmes publics)

---

## ⚖️ Avertissement final```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  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                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘