Laboratorio Vulnerable Wi-Fi (vuln-wifi.lab) con Vagrant e mac80211_hwsim

Laboratorio automatizado para prácticas de Hacking Ético Wi-Fi baseado en Vagrant, VirtualBox e mac80211_hwsim

Este laboratorio está estruturado para coincidir cos manuais PDF do repositorio repoEDU-CCbySA - HE - Wi-Fi

Aviso Legal

IMPORTANTE: Este laboratorio é EXCLUSIVAMENTE para fins educativos.

O autor do presente documento declina calquera responsabilidade asociada ao uso incorrecto e/ou malicioso que puidese realizarse coa información exposta no mesmo. Por tanto, non se fai responsable en ningún caso, nin pode ser considerado legalmente responsable en ningún caso, das consecuencias que poidan derivarse da información contida nel, incluíndo os posibles erros e información incorrecta existentes, información difamatoria, así como das consecuencias que se poidan derivar sobre a súa aplicación en sistemas de información reais e/ou virtuais. Este documento foi xerado para uso didáctico e debe ser empregado en contornas privadas e virtuais controladas co permiso correspondente do administrador desas contornas.

NON EXPOÑAS ESTA MÁQUINA A INTERNET.

Usos permitidos e non permitidos:

✅ Permitido: uso en contornas virtuais controladas con permiso do administrador
✅ Permitido: aprendizaxe e formación en ciberseguridade
❌ PROHIBIDO: uso contra redes reais sen autorización explícita e por escrito
❌ PROHIBIDO: distribución de ferramentas ou técnicas con fins maliciosos

Características Principais

Automatización completa mediante vagrant up
6 escenarios preconfigurados listos para usar
Simulación realista con mac80211_hwsim (sen hardware físico)
Namespaces de rede para illamento total
Ferramentas preinstaladas: aircrack-ng, hostapd, hostapd-wpe, hostapd-mana, FreeRADIUS, dragondrain, hcxdumptool
Dúas modalidades de guías por práctica: manual detallada e versión automatizada con wifite
Compatible con PDFs oficiais do repositorio HE

Requisitos Previos

Software Necesario

Software	Versión Mínima	Enlace de Descarga
VirtualBox	7.0+	virtualbox.org
Vagrant	2.3+	vagrantup.com
Git	2.0+	git-scm.com

Hardware Recomendado

RAM: 8 GB (mínimo 6 GB libres para a VM)
CPU: 4 cores (2 cores para a VM)
Disco: 20 GB libres
OS: Windows 10/11, macOS 11+, GNU/Linux (Debian 12+)

Instalación Rápida

1. Clonar o Repositorio

git clone https://github.com/ricardofc/vuln-wifi.lab.git
cd vuln-wifi.lab

2. Iniciar a Máquina Virtual

make up

Tempo estimado: 15-20 minutos (primeira execución).

3. Acceder á VM

make ssh

4. Primeira Execución

# Verificar instalación
sudo wifilabctl doctor

# Listar escenarios dispoñibles
sudo wifilabctl list

Saída esperada:

ID                   Descrición
------------------------------------------------------------
psk                  WPA2-PSK: Ataque de dicionario offline
psk_pmf              WPA2-PSK con PMF: Protección básica contra deauth
eap_evil_twin        WPA2-EAP: Evil Twin sen validación de certificados
eap_mitm             WPA2-EAP: Man-in-the-Middle con hostapd-mana
wpa3_sae             WPA3-SAE: Auditoría de contrasinal (resistente a ataques offline)
wpa3_sae_vulnerable  WPA3-SAE vulnerable (hostapd 2.7) + Evil Twin WPA2-PSK + Dragondrain DoS

Índice de Prácticas

Correspondencia entre Manuais PDF e Escenarios

Cada práctica dispón de dúas guías complementarias: a guía manual detallada (paso a paso, como o PDF) e a guía con wifite (ferramenta automatizada). Ambas traballan co mesmo escenario wifilabctl.

Bloque 1: WPA2-PSK

4 PDFs → 3 guías manuais + 3 guías Wifite. Os PDFs 1.3 e 1.4 comparten guía manual (1.3) porque cobren o mesmo ataque PMKID: o PDF-1.3 usa o escenario psk (sen PMF) e o PDF-1.4 usa psk_pmf (con ieee80211w=2), demostrando que PMF non protexe contra PMKID.

Manual PDF	Escenario	Guía Manual	Guía Wifite	Descrición
1-Taller-HE-Practica-WiFi-1.pdf	`psk`	`1-ATAQUE_WPA2_PSK.md`	`wifite-1-ATAQUE_WPA2_PSK.md`	Captura de handshake 4-Way + cracking offline con `aircrack-ng`
1-Taller-HE-Practica-WiFi-2.pdf	`psk_pmf`	`1.2-ATAQUE_WPA2_PSK_PMF.md`	`wifite-1.2-ATAQUE_WPA2_PSK_PMF.md`	PMF (`ieee80211w=2`): as tramas de deauth van cifradas, o ataque falla
1-Taller-HE-Practica-WiFi-3.pdf	`psk`	`1.3-ATAQUE_WPA2_PSK_PMKID.md`	`wifite-1.3-ATAQUE_WPA2_PSK_PMKID.md`	PMKID silencioso con `hcxdumptool` + `hashcat -m 22000` (AP sen PMF)
1-Taller-HE-Practica-WiFi-4.pdf	`psk_pmf`	`1.3-ATAQUE_WPA2_PSK_PMKID.md`	`wifite-1.3-ATAQUE_WPA2_PSK_PMKID.md`	PMKID con `ieee80211w=2` activo: PMF non protexe contra PMKID

As catro prácticas do Bloque 1 diferéncianse polo método de captura e o escenario:

PDF 1.1 (psk): deautenticación con aireplay-ng → captura do handshake 4-Way → cracking offline con aircrack-ng
PDF 1.2 (psk_pmf): o AP ten ieee80211w=2 → as tramas de deauth van cifradas e son descartadas polo cliente; o ataque falla; verifícase con tshark e logs de wpa_supplicant
PDF 1.3 (psk): hcxdumptool envía Association Requests e captura o PMKID en 15-30 s → cracking offline con hashcat -m 22000; non require deautenticar ao cliente; AP sen PMF
PDF 1.4 (psk_pmf): mesmo ataque PMKID co AP e cliente en ieee80211w=2 → demostra que PMF non protexe contra PMKID; hcxdumptool captura o PMKID igualmente

Bloque 2: WPA2-Enterprise (EAP)

3 PDFs → 2 guías manuais + 1 guía Wifite (a práctica 2.1 é demostración de limitacións de Wifite). O PDF 2.1 (setup e funcionamento de FreeRADIUS) só ten guía Wifite, que demostra que Wifite descarta automaticamente obxectivos WPA-E sen realizar ningún ataque.

Manual PDF	Escenario	Guía Manual	Guía Wifite	Descrición
2-Taller-HE-Practica-WiFi-1.pdf	`eap_mitm`	—	`wifite-2.1-ATAQUE_WPA2_EAP.md`	Setup FreeRADIUS + AP WPA2-EAP + cliente; Wifite detecta `WPA-E` e descarta o obxectivo automaticamente
2-Taller-HE-Practica-WiFi-2.pdf	`eap_evil_twin`	`2-ATAQUE_WPA2_EAP_EVIL_TWIN.md`	`—`	Evil Twin con `hostapd-wpe`: captura hash MSCHAPv2 + cracking con `hashcat -m 5500`
2-Taller-HE-Practica-WiFi-3.pdf	`eap_mitm`	`2-ATAQUE_WPA2_EAP_MITM.md`	`—`	MITM con `hostapd-mana`: relay RADIUS + captura de tráfico con `mitmproxy`

Bloque 3: WPA3-SAE

3 PDFs → 3 guías manuais + 3 guías Wifite. Wifite non pode executar ningún dos ataques avanzados de WPA3; as súas guías documentan as limitacións da ferramenta.

Manual PDF	Escenario	Guía Manual	Guía Wifite	Descrición
3-Taller-HE-Practica-WiFi-1.pdf	`wpa3_sae`	`3.1-ATAQUE_WPA3_SAE.md`	`wifite-3.1-ATAQUE_WPA3-SAE.md`	SAE resistente a cracking offline; Dragonblood (timing); forza bruta online con `wacker`
3-Taller-HE-Practica-WiFi-2.pdf	`wpa3_sae`	`3.2-ATAQUE_WPA3_KRACK.md`	`wifite-3.2-ATAQUE_WPA3_KRACK.md`	Verificación inmunidade KRACK en WPA3 con PMF obrigatorio (`tshark`)
3-Taller-HE-Practica-WiFi-3.pdf	`wpa3_sae_vulnerable`	`3.3-ATAQUE_WPA3_DoS_WPA2_EVIL_TWIN.md`	`wifite-3.3-ATAQUE_WPA3_DoS_WPA2_EVIL_TWIN.md`	Dragondrain DoS + downgrade WPA2-PSK/EAP; Wifite é inútil para este ataque multi-etapa

Uso Básico

Como Comezar unha Práctica

Método 1: Seguindo o Manual PDF

Abre o manual PDF correspondente (ver sección Manuais PDF do Taller)
Consulta a táboa de correspondencia anterior para identificar o escenario
Inicia o escenario dende dentro da VM:

# Exemplo para Práctica 1.1 (WPA2-PSK básico)
sudo wifilabctl up psk

Consulta a guía de ataque proporcionada polo profesorado (sección Ataques específicos)
Segue os pasos do PDF e da guía markdown en paralelo

Método 2: Exploración Libre

# Ver todos os escenarios dispoñibles
sudo wifilabctl list

# Iniciar un escenario
sudo wifilabctl up <nome_escenario>

# Ver estado actual
sudo wifilabctl status

# Ver logs en tempo real
sudo wifilabctl logs <nome_escenario>

# Deter e limpar
sudo wifilabctl reset

Comandos de wifilabctl

Listar Escenarios

sudo wifilabctl list

Iniciar un Escenario

sudo wifilabctl up <escenario>

Exemplos:

# Prácticas 1.1 e 1.3 (WPA2-PSK handshake e PMKID)
sudo wifilabctl up psk

# Práctica 1.2 (PMF / ieee80211w)
sudo wifilabctl up psk_pmf

# Prácticas 2.1 e 2.2 (WPA2-EAP Evil Twin)
sudo wifilabctl up eap_evil_twin

# Práctica 2.3 (WPA2-EAP MITM)
sudo wifilabctl up eap_mitm

# Prácticas 3.1 e 3.2 (WPA3-SAE + wacker + KRACK)
sudo wifilabctl up wpa3_sae

# Práctica 3.3 (Dragondrain DoS + Downgrade WPA2-PSK/EAP)
sudo wifilabctl up wpa3_sae_vulnerable

Ver Estado do Laboratorio

sudo wifilabctl status

Saída esperada:

[*] Informe de Estado do Laboratorio
============================================================
Namespaces activos:
  wifi_ap_wlan0
  wifi_cliente_wlan1

Interfaces por namespace:
  wifi_ap_wlan0:
    wlan0: UP (AP)
  wifi_cliente_wlan1:
    wlan1: UP (Cliente)

Ver Logs en Tempo Real

sudo wifilabctl logs <escenario>
# Ctrl+C para saír

Deter e Limpar

sudo wifilabctl reset

Diagnosticar Problemas

sudo wifilabctl doctor

Makefile

O Makefile proporciona atallos para as operacións máis comúns dende o host, sen necesidade de entrar na VM manualmente.

Comandos Dispoñibles

# Levantar e aprovisionar a VM
make up

# Conectar á VM por SSH
make ssh

# Suspender a VM
make halt

# Destruír a VM completamente
make destroy

# Destruír e limpar (alias de destroy)
make clean

Exemplo de Fluxo Completo

# 1. Levantar a VM
make up

# 2. Conectar e traballar
make ssh

# 3. Dentro da VM: iniciar o escenario desexado
sudo wifilabctl up eap_evil_twin

# 4. Ao rematar: suspender ou destruír
make halt      # Suspender (conserva o estado)
make destroy   # Destruír completamente

Comparación de Prácticas

Táboa Comparativa de Vulnerabilidades

Práctica	Escenario	Tecnoloxía	Tipo de Ataque	Vulnerable?	Tempo Estimado
PDF 1.1	`psk`	WPA2-PSK	Deauth + handshake 4-Way + dicionario offline (`aircrack-ng`)	SI	30 min
PDF 1.2	`psk_pmf`	WPA2-PSK + PMF	Intento deauth — bloqueado por `ieee80211w=2`	NON (deauth)	20 min
PDF 1.3	`psk`	WPA2-PSK	PMKID con `hcxdumptool` + `hashcat -m 22000`, AP sen PMF	SI	20 min
PDF 1.4	`psk_pmf`	WPA2-PSK + PMF	PMKID con `ieee80211w=2` activo — PMF non protexe contra PMKID	SI	25 min
PDF 2.1	`eap_mitm`	WPA2-EAP	Setup FreeRADIUS + cliente; Wifite descarta `WPA-E`	Referencia	30 min
PDF 2.2	`eap_evil_twin`	WPA2-EAP	Evil Twin (`hostapd-wpe`) + `hashcat -m 5500`	SI	45 min
PDF 2.3	`eap_mitm`	WPA2-EAP	MITM (`hostapd-mana`) + relay RADIUS + `mitmproxy`	SI	60 min
PDF 3.1	`wpa3_sae`	WPA3-SAE	Dragonblood timing; forza bruta online con `wacker`	NON offline / SI online	45 min
PDF 3.2	`wpa3_sae`	WPA3-SAE + PMF	Verificación inmunidade KRACK con `tshark`	NON	30 min
PDF 3.3	`wpa3_sae_vulnerable`	WPA3-SAE (≤2.7)	Dragondrain DoS + downgrade WPA2-PSK ou WPA2-EAP	SI (modo transición)	60 min

Resumo por Tecnoloxía

WPA2-PSK

Protección	Estado	Observacións
Handshake Capture	Vulnerable	Require cliente conectado; cracking offline con `aircrack-ng` (PDF 1.1)
PMKID Attack	Vulnerable	Require cliente lexítimo con sesión activa; AP cachea PMK tras 1º handshake (PDF 1.3 e 1.4)
PMF (`ieee80211w=2`)	Protexe só contra deauth	Bloquea frames de deauth non cifrados (PDF 1.2) pero non protexe contra PMKID (PDF 1.4)
Dicionario Offline	Vulnerable	Afecta tanto a handshake como a PMKID; contrasinais longos e aleatorios resisten

WPA2-EAP

Protección	Estado	Observacións
Evil Twin	Vulnerable	Se o cliente non valida o certificado do servidor RADIUS
MITM	Vulnerable	`hostapd-mana` captura credenciais MSCHAPv2
Validación Certificado	Protexe	Se `ca_cert` está correctamente configurado en `wpa_supplicant`

WPA3-SAE

Protección	Estado	Observacións
Dicionario Offline	Protexido	SAE non expón hash crackeable; `aircrack-ng` non é aplicable
Forza Bruta Online (`wacker`)	Parcialmente vulnerable	Posible se o contrasinal é débil; limitado pola velocidade de resposta do AP
KRACK	Protexido	PMF obrigatorio + implementación correcta
Dragonblood DoS	Vulnerable	En hostapd < 2.10
Downgrade a WPA2	Vulnerable	Se o modo transición está activo

Estrutura do Laboratorio

Dentro da VM (`/home/kali/wifiLab/`)

O bootstrap.sh copia unicamente o mínimo necesario para o funcionamento do laboratorio.

/home/kali/wifiLab/
├── scenarios/                     # Definicións YAML dos escenarios
│   ├── eap_evil_twin.yaml
│   ├── eap_mitm.yaml
│   ├── psk.yaml
│   ├── psk_pmf.yaml
│   ├── wpa3_sae.yaml
│   └── wpa3_sae_vulnerable.yaml
├── scripts/
│   └── wifilabctl                 # Xestor de escenarios (tamén en /usr/local/bin/)
└── run/                           # Creado por wifilabctl ao iniciar un escenario
    └── <escenario>/
        ├── hostapd.log            # Logs do AP lexítimo
        ├── wpa_supplicant.log     # Logs do cliente simulado
        ├── freeradius.log         # Logs de RADIUS (só escenarios EAP)
        ├── hostapd_wpe.log        # Logs do AP falso (só eap_evil_twin)
        └── *.cap                  # Ficheiros de captura de tráfico

Resolución de Problemas

Problemas Comúns

1. "Non hai namespaces wifi activos"

Causa: O escenario non está iniciado ou fallou ao cargar o módulo mac80211_hwsim.

Solución:

# Verificar módulo
lsmod | grep mac80211_hwsim

# Se non está cargado
sudo modprobe mac80211_hwsim radios=4

# Reiniciar escenario
sudo wifilabctl reset
sudo wifilabctl up psk

2. "RADIUS server not responding"

Causa: FreeRADIUS non está en execución ou problema de certificados.

Solución:

# Verificar FreeRADIUS
sudo systemctl status freeradius

# Comprobar certificados
ls -la /etc/freeradius/3.0/certs/

# Rexenerar certificados
cd /etc/freeradius/3.0/certs/
sudo make

# Reiniciar RADIUS
sudo systemctl restart freeradius

3. "hostapd-mana: not found"

Causa: hostapd-mana non está compilado.

Solución:

# Compilar hostapd-mana
cd /opt/hostapd-mana
make -C hostapd

# Verificar binario
ls -la /opt/hostapd-mana/hostapd/hostapd

# Crear enlace simbólico
sudo ln -sf /opt/hostapd-mana/hostapd/hostapd /usr/local/bin/hostapd-mana

4. "airodump-ng: interface wlan2mon not found"

Causa: A interface non está en modo monitor.

Solución:

# Matar procesos que interfiren
sudo airmon-ng check kill

# Poñer en modo monitor
sudo airmon-ng start wlan2

# Verificar
iwconfig

5. "Vagrant SSH not working"

Causa: SSH non está escoitando.

Solución:

# Dende o host
make destroy
make up

# Ou dende a VM (consola GUI)
sudo systemctl restart ssh
sudo systemctl status ssh

Comandos de Diagnóstico

# Verificar estado completo
sudo wifilabctl doctor

# Comprobar interfaces de rede
ip link show

# Comprobar namespaces
ip netns list

# Comprobar módulo mac80211_hwsim
lsmod | grep mac80211

# Ver procesos relacionados
ps aux | grep -E 'hostapd|wpa_supplicant|freeradius'

# Verificar logs do sistema
journalctl -xeu freeradius
journalctl -xeu ssh

Reinicio Completo

Se todo falla, reinicia completamente:

# Dende o host (fóra da VM)
make destroy
make up

Actualización e Mantemento

Actualizar o Laboratorio

# No host, actualizar o repositorio
git pull origin main

# Destruír e recrear a VM coa nova versión
make destroy
make up

Desinstalación Completa

make destroy
cd ..
rm -rf vuln-wifi.lab

Laboratorio Vulnerable Wi-Fi (vuln-wifi.lab) con Vagrant e mac80211_hwsim

Aviso Legal

Táboa de Contidos

Características Principais

Requisitos Previos

Software Necesario

Hardware Recomendado

Instalación Rápida

1. Clonar o Repositorio

2. Iniciar a Máquina Virtual

3. Acceder á VM

4. Primeira Execución

Índice de Prácticas

Correspondencia entre Manuais PDF e Escenarios

Bloque 1: WPA2-PSK

Bloque 2: WPA2-Enterprise (EAP)

Bloque 3: WPA3-SAE

Uso Básico

Como Comezar unha Práctica

Método 1: Seguindo o Manual PDF

Método 2: Exploración Libre

Comandos de wifilabctl

Listar Escenarios

Iniciar un Escenario

Ver Estado do Laboratorio

Ver Logs en Tempo Real

Deter e Limpar

Diagnosticar Problemas

Makefile

Comandos Dispoñibles

Exemplo de Fluxo Completo

Comparación de Prácticas

Táboa Comparativa de Vulnerabilidades

Resumo por Tecnoloxía

WPA2-PSK

WPA2-EAP

WPA3-SAE

Estrutura do Laboratorio

Dentro da VM (/home/kali/wifiLab/)

Resolución de Problemas

Problemas Comúns

1. "Non hai namespaces wifi activos"

2. "RADIUS server not responding"

3. "hostapd-mana: not found"

4. "airodump-ng: interface wlan2mon not found"

5. "Vagrant SSH not working"

Comandos de Diagnóstico

Reinicio Completo

Actualización e Mantemento

Actualizar o Laboratorio

Desinstalación Completa

Referencias

Documentación Oficial

Investigación e Vulnerabilidades

Ferramentas

Manuais PDF do Taller

Dentro da VM (`/home/kali/wifiLab/`)