Evil Twin Access Point Toolkit

Una configuración completa, modular y reproducible de un punto de acceso gemelo malvado para pruebas de seguridad defensiva, pruebas de penetración e investigación de seguridad inalámbrica.

⚠️ Aviso Legal

SOLO PARA FINES EDUCATIVOS Y PRUEBAS DE SEGURIDAD AUTORIZADAS

Esta herramienta se proporciona para:

• Fines educativos
• Pruebas de penetración autorizadas
• Investigación de seguridad en entornos controlados
• Capacitación en seguridad defensiva

EL USO ILEGAL ESTÁ ESTRICTAMENTE PROHIBIDO. El acceso no autorizado a redes informáticas es un delito en la mayoría de las jurisdicciones. Los usuarios son los únicos responsables de:

• Obtener autorización por escrito antes de realizar pruebas
• Cumplir con todas las leyes y regulaciones aplicables
• Cualquier consecuencia derivada del mal uso

Al usar esta herramienta, acepta utilizarla únicamente en redes de su propiedad o para las cuales tenga permiso explícito por escrito para realizar pruebas.

---

📋 Tabla de Contenidos

• Resumen
• Características
• Requisitos de Hardware
• Requisitos de Software
• Instalación
• Configuración
• Uso
• Captura de Tráfico
• Monitoreo
• Solución de Problemas
• Estructura del Proyecto
• Consideraciones de Seguridad
• Contribuciones
• Licencia

---

🎯 Resumen

Este conjunto de herramientas crea un punto de acceso inalámbrico fraudulento (gemelo malvado) que imita una red legítima. Captura el tráfico de red creando un SSID idéntico al que los clientes pueden conectarse automáticamente, creyendo que es la red legítima.

¿Qué es un ataque de gemelo malvado?

Un gemelo malvado es un punto de acceso Wi-Fi fraudulento que parece legítimo pero está configurado para espiar las comunicaciones inalámbricas. El ataque funciona colocando un punto de acceso fraudulento cerca de la red objetivo, transmitiendo el mismo SSID y engañando a los dispositivos para que se conecten.

Casos de Uso

• 🔐 Pruebas de penetración de seguridad inalámbrica
• 🎓 Capacitación y demostraciones de concienciación en seguridad
• 🧪 Investigación de seguridad de redes en entornos de laboratorio
• 🛡️ Pruebas de sistemas de detección de intrusiones inalámbricas
• 📱 Análisis del comportamiento de dispositivos y conectividad de clientes

---

✨ Características

• 🔧 Diseño Modular: Separación clara de responsabilidades con funciones reutilizables
• 📊 Salida Detallada: Mensajes de estado con código de colores para cada operación
• 🔍 Monitoreo en Tiempo Real: Seguimiento en vivo de clientes conectados con marcas de tiempo
• 📝 Registro Exhaustivo: Registros detallados para hostapd, dnsmasq y conexiones
• 🌐 Compartición de Internet: Configuración automática de NAT para paso de internet
• 🔄 Auto-descubrimiento: Detección automática de la interfaz orientada a internet
• 🧹 Limpieza Ordenada: Apagado adecuado con restauración completa del sistema
• ✅ Gestión de Dependencias: Instalación y verificación automatizadas
• 🎨 Multiplataforma: Soporta Debian, Ubuntu, Kali, Fedora, Arch y más
• 📦 Reproducible: Archivos de configuración controlables por versión
• 📡 Detección de Interfaz: Detección automática del adaptador inalámbrico y verificación del modo AP
• 📸 Captura de Tráfico: Captura PCAP integrada con filtrado y rotación

---

🔌 Requisitos de Hardware

Adaptador de Red Inalámbrica

Su adaptador inalámbrico DEBE ser compatible con el modo AP (Punto de Acceso). No todas las tarjetas inalámbricas soportan esta funcionalidad.

✅ Adaptadores Recomendados

Estos adaptadores se sabe que funcionan bien y soportan el modo AP:

Chipset	Ejemplos de Modelos	Características	Rango de Precio
RTL8812AU	Alfa AWUS036ACH, TP-Link Archer T4U	Doble banda (2.4/5GHz), Alta potencia, Excelente alcance	$40-60
RTL8814AU	Alfa AWUS1900, TP-Link Archer T9UH	Cuádruple antena, AC1900, Largo alcance	$60-80
Atheros AR9271	TP-Link TL-WN722N v1, Alfa AWUS036NHA	Estable, Bien soportado, Económico	$20-35
MT7612U	Panda PAU0D, Alfa AWUS036ACM	Doble banda, Buena compatibilidad	$35-50
RTL8188EU	Varios adaptadores económicos	Básico, solo 2.4GHz, Nivel de entrada	$10-20

🏆 Principales Recomendaciones

1. Alfa AWUS036ACH (RTL8812AU)

   • Mejor opción general para pruebas de penetración
   • Excelente soporte de controladores en Kali Linux
   • Alta potencia de transmisión (hasta 30dBm)
   • Soporte de doble banda

2. TP-Link TL-WN722N v1 (Atheros AR9271)

   • Mejor opción económica
   • Estabilidad sólida como una roca
   • Soporte nativo de Linux
   • ⚠️ Asegúrese de obtener la versión 1, no la v2 o v3

3. Alfa AWUS036ACM (MT7612U)

   • Buen equilibrio entre precio y rendimiento
   • Excelente compatibilidad
   • Potencia de salida media

❌ Adaptadores a Evitar

• Tarjetas inalámbricas integradas en portátiles (generalmente no soportan modo AP)
• Chipset RTL8188FTV (soporte deficiente de modo AP)
• Chipsets Broadcom (soporte limitado de Linux)
• Cualquier adaptador etiquetado como "v2" o "v3" de modelos que antes funcionaban (a menudo utilizan chipsets diferentes e incompatibles)

Verificación del Soporte de Modo AP

Antes de comprar, verifique que el adaptador soporte el modo 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

### Hardware Adicional

- **Conexión Ethernet**: Necesaria para el paso de internet (puede ser física o adaptador USB-Ethernet)
- **Suficiente alimentación USB**: Algunos adaptadores de alto consumo pueden requerir un concentrador USB con alimentación
- **Computadora**: Cualquier laptop o PC de escritorio con Linux (recomendado: Kali Linux)

---

## 💻 Requisitos de Software

### Sistema Operativo

- **Recomendado**: Kali Linux (2020.1 o posterior)
- **También Compatibles**:
  - Debian 10+
  - Ubuntu 18.04+
  - Fedora 30+
  - Arch Linux
  - ParrotOS
  - BlackArch

### Paquetes Requeridos

Estos serán instalados automáticamente por `install_dependencies.sh`:

- `hostapd` - Crea el punto de acceso
- `dnsmasq` - Proporciona servicios DHCP y DNS
- `iptables` - Configura reglas NAT y de firewall
- `iproute2` - Configuración de interfaces de red
- `wireless-tools` - Utilidades de gestión inalámbrica
- `net-tools` - Herramientas de diagnóstico de red
- `iw` - Utilidad de configuración inalámbrica
- `tcpdump` - Utilidad de captura de paquetes

### Privilegios

- Se requiere acceso root/sudo para todas las operaciones

---

## 📦 Instalación

### Inicio Rápido```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

Instalación Detallada

Paso 1: Clonar el Repositorio```bash

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

#### Paso 2: Instalar Dependencias