### Hardware Aggiuntivo

- **Connessione Ethernet**: Richiesta per il passaggio Internet (può essere fisica o adattatore USB-Ethernet)
- **Alimentazione USB Sufficiente**: Alcuni adattatori ad alta potenza potrebbero richiedere un hub USB alimentato
- **Computer**: Qualsiasi laptop o desktop con Linux (consigliato: Kali Linux)

---

## 💻 Requisiti Software

### Sistema Operativo

- **Consigliato**: Kali Linux (2020.1 o successivo)
- **Supportati anche**:
  - Debian 10+
  - Ubuntu 18.04+
  - Fedora 30+
  - Arch Linux
  - ParrotOS
  - BlackArch

### Pacchetti Richiesti

Questi verranno installati automaticamente da `install_dependencies.sh`:

- `hostapd` - Crea il punto di accesso
- `dnsmasq` - Fornisce servizi DHCP e DNS
- `iptables` - Configura le regole NAT e firewall
- `iproute2` - Configurazione dell'interfaccia di rete
- `wireless-tools` - Utility di gestione wireless
- `net-tools` - Strumenti diagnostici di rete
- `iw` - Utility di configurazione wireless
- `tcpdump` - Utility di cattura pacchetti

### Privilegi

- È richiesto l'accesso root/sudo per tutte le operazioni

---

## 📦 Installazione

### Avvio Rapido```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

#### Passo 2: Installare le dipendenze

Lo script di installazione rileva automaticamente la tua distribuzione Linux e installa i pacchetti richiesti:```bash
sudo ./install_dependencies.sh

Questo script analizzerà tutte le interfacce wireless e raccomanderà la migliore da utilizzare.

**Esempio di output:**```
==========================================
   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'

## ⚙️ Configurazione

### hostapd.conf - Impostazioni del punto di accesso

Modifica `hostapd.conf` per personalizzare il tuo evil twin:```bash
nano hostapd.conf

### dnsmasq.conf - Impostazioni DHCP/DNS

Modifica `dnsmasq.conf` per personalizzare le impostazioni di rete:```bash
nano dnsmasq.conf

### Network Configuration

**Default settings:**
- **AP IP**: 192.168.99.1
- **Subnet**: 192.168.99.0/24
- **DHCP Range**: 192.168.99.10 - 192.168.99.250
- **Channel**: 6 (2.4GHz)
- **Password**: letitrain2
- **Interface**: wlan1 (adattatore esterno)

---

## 🚀 Utilizzo

### Avvio dell'Evil Twin```bash
sudo ./start_evil_twin.sh

### Fermare l'Evil Twin```bash
sudo ./stop_evil_twin.sh

---

## 📸 Cattura del Traffico

### Cattura del Traffico di Rete

Il toolkit include uno script completo per la cattura del traffico che salva i dati dei pacchetti come file PCAP per l'analisi:```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

### Caratteristiche di Cattura

- ✅ Salva il traffico in formato PCAP standard
- ✅ Rotazione automatica dei file per evitare file enormi
- ✅ Statistiche dei pacchetti in tempo reale in modalità verbose
- ✅ Supporto per il filtraggio BPF (Berkeley Packet Filter)
- ✅ Catture temporizzate o operazione continua
- ✅ Pulizia sicura su Ctrl+C
- ✅ Output salvato nella directory `output/`

### Posizione dell'Output

Tutte le catture vengono salvate in `output/` con nomi di file basati su timestamp:
- Formato: `capture_YYYYMMDD_HHMMSS.pcap`
- Personalizzato: `yourname_YYYYMMDD_HHMMSS.pcap`

### Analisi del Traffico Catturato```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"

---

## 📊 Monitoraggio

### Monitoraggio delle connessioni in tempo reale

Il toolkit fornisce diversi modi per monitorare i client connessi:

#### 1. Registro delle connessioni

Aggiornato automaticamente ogni 5 secondi:```bash
tail -f logs/connections.log

#### 2. Assegnazioni DHCP

Visualizza i lease DHCP in tempo reale:```bash
tail -f logs/dnsmasq.log

#### 3. Stato del punto di accesso

Monitora i log di hostapd:```bash
tail -f logs/hostapd.log

## 🔧 Risoluzione dei problemi

### Problemi comuni e soluzioni

#### 1. "Nessuna interfaccia wireless trovata"

**Problema:** La tua scheda wireless non viene rilevata.

**Soluzioni:**```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 non è riuscito ad avviarsi"

**Problema:** hostapd non riesce ad avviare il punto di accesso.

**Soluzioni:**```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. "I clienti si connettono ma non hanno internet"

**Problema:** NAT/routing non è configurato correttamente.

**Soluzioni:**```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. "Canale X non disponibile"

**Problema:** Le normative wireless limitano alcuni canali.

**Soluzioni:**```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. "Interfaccia sbagliata in uso"

**Problema:** Gli script stanno utilizzando wlan0 anziché wlan1 (o viceversa).

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

### Descrizione dei File

| File | Scopo | Modificare? |
|------|-------|-------------|
| `hostapd.conf` | Impostazioni AP (SSID, canale, password, interfaccia) | ✅ Sì - personalizzare per il tuo test |
| `dnsmasq.conf` | Configurazione DHCP/DNS (interfaccia, intervallo IP) | ✅ Sì - regolare le impostazioni di rete |
| `install_dependencies.sh` | Installa i pacchetti richiesti | ❌ No - eseguire così com'è |
| `detect_interface.sh` | Rileva le interfacce wireless e il supporto per la modalità AP | ❌ No - eseguire così com'è |
| `start_evil_twin.sh` | Avvia l'AP gemello malvagio | ⚠️ Raramente - solo per personalizzazioni avanzate |
| `stop_evil_twin.sh` | Arresta e pulisce | ❌ No - eseguire così com'è |
| `capture_traffic.sh` | Cattura il traffico in file PCAP | ⚠️ Usa le opzioni CLI invece |
| `logs/*.log` | Log di esecuzione | 📖 Sola lettura - per monitoraggio |
| `output/*.pcap` | Dati dei pacchetti catturati | 📖 Sola lettura - per analisi |

---

## 🔒 Considerazioni sulla Sicurezza

### Linee Guida per l'Uso Etico

1. **Autorizzazione**: Ottenere SEMPRE il permesso scritto prima di testare
2. **Ambito**: Rimanere nell'ambito concordato del test
3. **Documentazione**: Tenere registri dettagliati di tutte le attività
4. **Divulgazione**: Segnalare le scoperte in modo responsabile ai proprietari della rete
5. **Gestione dei Dati**: Non intercettare, memorizzare o utilizzare impropriamente i dati catturati

### Considerazioni Legali

- Creare punti di accesso rogue senza autorizzazione è **ILLEGALE** nella maggior parte dei paesi
- Le sanzioni possono includere multe, reclusione e precedenti penali
- Anche i test "innocui" possono essere perseguiti se non autorizzati
- Ambienti aziendali: Ottenere l'approvazione del reparto IT per iscritto
- Spazi pubblici: MAI testare su reti pubbliche

### Sicurezza Tecnica

**Questo toolkit per progettazione:**
- ✅ Si concentra sulla creazione e monitoraggio di punti di accesso
- ✅ Include la cattura del traffico solo per analisi autorizzate
- ✅ Fornisce registrazione completa per la responsabilità
- ⚠️ NON include la raccolta di credenziali
- ⚠️ NON include l'eliminazione di SSL o attacchi MITM attivi
- ⚠️ NON include il phishing tramite captive portal

**Per aumentare la sicurezza dei tuoi test:**
- Utilizzare segmenti di rete isolati
- Implementare l'identificazione della rete di test (SSID unici)
- Limitare i test a finestre temporali specifiche
- Monitorare e registrare tutte le attività
- Utilizzare solo in gabbie di Faraday o stanze schermate RF per evitare perdite di segnale

### Misure Difensive

Le organizzazioni possono proteggersi dagli attacchi evil twin:

- Implementando l'**autenticazione 802.1X** (WPA2/WPA3 Enterprise)
- Utilizzando la **convalida dei certificati** per l'autenticazione di rete
- Implementando **sistemi di rilevamento delle intrusioni wireless (WIDS)**
- Abilitando **Protected Management Frames (PMF/802.11w)**
- Addestrando gli utenti a verificare l'autenticità della rete
- Utilizzando VPN per comunicazioni sensibili
- Monitorando per punti di accesso rogue

---

## 🤝 Contribuire

I contributi sono benvenuti! Segui queste linee guida:

### Come Contribuire

1. **Fork del repository**
2. **Crea un ramo feature**: `git checkout -b feature/tua-feature`
3. **Apporta le tue modifiche** con messaggi di commit chiari
4. **Testa accuratamente** su più sistemi se possibile
5. **Aggiorna la documentazione** se modifichi la funzionalità
6. **Invia una pull request** con una descrizione dettagliata

### Linee Guida per i Contributi

- Mantieni la struttura modulare
- Aggiungi registrazione dettagliata per nuove funzionalità
- Includi la gestione degli errori per casi limite
- Aggiorna il README se aggiungi nuove funzionalità
- Segui lo stile del codice esistente (best practice bash)
- Aggiungi commenti per logiche complesse
- Testa su almeno una distribuzione basata su Debian

### Stile del Codice```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"

## 🙏 Riconoscimenti

- Il team di Kali Linux per gli eccellenti strumenti di sicurezza wireless
- I progetti hostapd e dnsmasq
- La comunità di ricerca sulla sicurezza wireless
- Contributori e tester

---

## 📚 Risorse Aggiuntive

### Risorse di Apprendimento

- [Guida OWASP per i Test di Sicurezza Wireless](https://owasp.org/www-project-web-security-testing-guide/)
- [Metodologia di Penetration Testing WiFi](https://www.sans.org/white-papers/)
- [Sicurezza Wireless su Kali Linux](https://www.kali.org/docs/wireless/)

### Strumenti Correlati

- **Aircrack-ng**: Suite di auditing wireless
- **Wireshark**: Analizzatore di protocolli di rete
- **Bettercap**: Attacchi e monitoraggio di rete
- **Wifiphisher**: Attacchi di phishing automatizzati su WiFi

### Documentazione

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

---

## 📞 Supporto

- **Problemi**: [GitHub Issues](https://github.com/yourusername/evil-twin-ap/issues)
- **Discussioni**: [GitHub Discussions](https://github.com/yourusername/evil-twin-ap/discussions)
- **Sicurezza**: Segnalare vulnerabilità via email (non problemi pubblici)

---

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