WiFi-SpiderWeb V2.0 — Ecosistema OpenWrt de Ciberdefensa Activa y Honeypot

Detector dinámico de desautenticación Wi-Fi, motor de contramedidas activas y panel web en tiempo real con radar de triangulación RSSI. Diseñado para routers OpenWrt de bajos recursos que funcionan completamente desde USB ExtRoot.

🏗️ Arquitectura avanzada

El sistema funciona mediante una arquitectura multiproceso y de bajo consumo, diseñada para minimizar los ciclos de CPU en hardware embebido mediante filtros BPF a nivel de kernel y una infraestructura IPC segura entre hilos:

   wlan0mon (Monitor Mode)
       │
       ▼

[spider_core.py] ───► /tmp/spider_ipc.sock ───► [spider_attacker.py] │ │ ▼ (Kernel BPF Filter) ├─► Tarpit Engine (Freeze Tools) [IPCSocketReader] ├─► Captive Portal Trap │ └─► Hardware Ban (iptables) ▼ [spider_web.py] (Lightweight ThreadingTCPServer on :8080) │ ▼ (Server-Sent Events - SSE Stream) [index.html Dashboard] ───► Real-Time Radar Sweep & Attacker Profiles Map

⚡ Resumen de características

🚀 Inicio rápido (Plug & Play vía USB)

1. Formatea tu memoria USB a ext4 y asegúrate de que ExtRoot esté configurado en tu dispositivo OpenWrt.
2. Coloca todos los archivos del proyecto (spider_core.py, spider_attacker.py, spider_web.py, index.html y usb_autorun.sh) en el directorio raíz de tu USB.
3. Conecta el USB al router.
4. Accede a tu router por SSH y ejecuta el instalador hotplug:

sh usb_autorun.sh --install-hotplug

5. Aplica los parches de integración e inicia la interfaz web:

python3 spider_web.py --patch-core
python3 spider_web.py --patch-html
python3 spider_web.py --port 8080

6. Abre tu navegador y dirígete a http://YOUR_ROUTER_IP:8080 para acceder al panel en vivo. Haz clic en "Activate Spider-Web Defense" para lanzar el grupo de demonios automatizados.

📈 Endpoints de la API del panel

El microservidor interno gestiona la replicación de estado a través de los siguientes endpoints ligeros:

• GET / : Sirve la interfaz de monitoreo autocontenida.
• GET /api/status : Devuelve métricas actuales de CPU/RAM del sistema y estado de salud de los procesos.
• GET /api/alerts : Tubería persistente de Server-Sent Events (SSE) que transmite telemetría en ráfagas entrantes.
• POST /api/toggle : Inicia/finaliza limpiamente los demonios de defensa en segundo plano.

Limitaciones de hardware y umbrales de controladores

Nota: Si la estabilidad de tu chipset se degrada durante una alta asignación de VAP con hostapd, ajusta la variable HONEYPOT_VAP_COUNT dentro de spider_core.py para que coincida con las restricciones máximas de VAP de tu controlador.

Licencia y aviso legal

MIT — Libre para uso personal, investigación y auditorías de seguridad defensiva. La captura de paquetes no autorizada y la manipulación de hardware pueden violar las regulaciones locales de ciberdelincuencia (CFAA, RGPD, Computer Misuse Act). Realiza siempre las pruebas dentro de entornos de laboratorio autorizados.