WirelessPen

Kit de auditoría WiFi pasiva — solo lectura, cero transmisión

Requiere autorización escrita explícita sobre la red auditada

---

¿Qué es?

WirelessPen es un toolkit CLI modular para auditoría y diagnóstico WiFi pasivos en Linux. Escucha y analiza tramas 802.11 en modo monitor sin inyectar, modificar ni transmitir ningún paquete.

Garantía de diseño: ningún script transmite tramas en ningún escenario.

---

Aviso legal

El uso de herramientas de captura inalámbrica sin autorización es ilegal (LGT y CP en España, Computer Misuse Act en el RU, CFAA en EE. UU., entre otras normativas). Los autores no asumen responsabilidad alguna por usos no autorizados.

Cada script muestra un aviso legal y solicita confirmación explícita antes de iniciar la captura.

---

Scripts

Script	Función
scan_networks.py	Escáner pasivo — SSID, BSSID, canal, RSSI, cifrado
analyze_security.py	Analiza vulnerabilidades en las redes capturadas
monitor_wifi.py	Monitor continuo de anomalías en tiempo real
generate_report.py	Genera informe HTML + JSON con hallazgos

Anomalías detectadas

Anomalía	Severidad	Criterio
Red abierta	CRÍTICA	Sin Privacy bit
WEP	CRÍTICA	Sin RSN IE ni WPA IE
WPA/TKIP	ALTA	WPA vendor IE presente
WPA2 + TKIP	MEDIA	RSN con cifrado TKIP
SSID duplicado	ALTA	Mismo SSID, distintos BSSIDs
Tormenta Deauth	ALTA	≥ 20 tramas en 10 s
Beacon flood	MEDIA	≥ 50 beacons/s por BSSID
Congestión de canal	INFO	≥ 5 APs en el mismo canal

---

Requisitos

SO: Linux con adaptador inalámbrico en modo monitor. Dependencia Python: scapy ≥ 2.5.0 (ver requirements.txt). Dependencias de sistema:

# Debian / Ubuntu / Kali
sudo apt install iw wireless-tools

Hardware recomendado: Realtek RTL8812AU, Atheros AR9271, MediaTek MT7612U.

---

Instalación

git clone https://github.com/Crypt0xDev/WirelessPen.git
cd WirelessPen
python3 -m venv env && source env/bin/activate
pip install -r requirements.txt

---

Uso rápido

# 1. Activar modo monitor
sudo ip link set wlan0 down
sudo iw dev wlan0 set type monitor
sudo ip link set wlan0 up

# 2. Escanear (60 s)
sudo python3 scripts/scan_networks.py -i wlan0 -t 60 -o resultados/scan.json

# 3. Analizar seguridad
python3 scripts/analyze_security.py --input resultados/scan.json -o resultados/hallazgos.json

# 4. Monitor continuo (5 min)
sudo python3 scripts/monitor_wifi.py -i wlan0 -t 300 -o resultados/monitor.json

# 5. Generar informe
python3 scripts/generate_report.py \
    --scan resultados/scan.json \
    --findings resultados/hallazgos.json \
    --monitor resultados/monitor.json \
    --out-dir resultados/informe/

---

Salida de ejemplo

BSSID              SSID           CH    RSSI    ENC    CIPHER   CALIDAD      TRAMAS
──────────────────────────────────────────────────────────────────────────────────
AA:BB:CC:DD:EE:01  MiRedCasa       6  -48 dBm  WPA2   CCMP     Excelente      324
AA:BB:CC:DD:EE:02  CafeWifi       11  -61 dBm  Open   None     Buena          189
AA:BB:CC:DD:EE:03  Vecino_2.4      1  -74 dBm  WPA    TKIP     Aceptable       97

  Total de redes descubiertas: 3

---

Estructura

WirelessPen/
├── config.py            # Configuración global
├── requirements.txt
├── LICENSE · security.md
├── scripts/
│   ├── scan_networks.py
│   ├── analyze_security.py
│   ├── monitor_wifi.py
│   └── generate_report.py
├── utils/
│   ├── logger.py        # Logging centralizado
│   ├── parser.py        # Argparse base compartido
│   └── wifi_utils.py    # Aviso legal, interfaz, helpers RSSI
├── configs/
└── tests/

---

Licencia

MIT — consulta LICENSE.

Crypt0xDev — uso ético y responsable