Actualmente solo está disponible una versión neerlandesa de la aplicación. La versión en inglés estará disponible pronto.

Guía de usuario – Monitor Wi‑Fi Pasivo (ESSID + Filtro de Banda)

Aviso legal y ético (Uso educativo)

Solo para uso educativo y pruebas autorizadas. Eres el único responsable de cómo utilizas esta herramienta. Interrumpir intencionadamente redes de las que no eres propietario o para las que careces de permiso por escrito para realizar pruebas puede ser ilegal en tu jurisdicción. Incluso el envío de una sola trama de desautenticación a la red de otra persona puede ser contrario a la ley. Úsala únicamente con autorización explícita y bajo tu propia responsabilidad.

1) Propósito (de un vistazo)

Esta aplicación descubre un SSID objetivo, lista los BSSID coincidentes por banda (2.4/5/6 GHz) y monitorea pasivamente cada BSSID para enumerar clientes y, si está presente, capturar handshakes WPA en formato .22000. Los botones de desautenticación funcionan activamente; se realizan desautenticaciones activas.

2) Requisitos del sistema

SO: Linux con iw, ip y systemd/NetworkManager.
Herramientas: airodump-ng (suite aircrack-ng), airmon-ng, hcxpcapngtool, iw, ip, systemctl.
Privilegios: Ejecutar como root (o con capacidades equivalentes para las herramientas de captura).
Adaptador Wi‑Fi: Debe soportar modo monitor y las bandas objetivo. 6 GHz requiere chipset/controlador/kernel moderno.

3) Configuración inicial

Verifica que las herramientas estén instaladas: which airodump-ng, which hcxpcapngtool, etc.
Inicia la aplicación: python3 tu_script.py.
Si ves "Ejecuta este script como root", reinicia con los privilegios adecuados.

Consejo: Usa Autocomprobación (ver §12) para validar rápidamente el entorno.

4) Archivos y carpetas

logs/<SAFE_ESSID>/session.log – registro de sesión continuo (rota después de ~5 MB).
logs/<SAFE_ESSID>/discovery-01.csv – salida de descubrimiento de banda más reciente.
logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – CSV de monitoreo por BSSID.
logs/<SAFE_ESSID>/aliases.json – tus alias legibles para las MAC de clientes.
logs/<SAFE_ESSID>/session.json – datos de sesión (BSSID, clientes, contadores).
logs/<SAFE_ESSID>/*hs*.22000 – handshakes WPA capturados pasivamente.

<SAFE_ESSID> es una versión saneada de tu ESSID, apta para nombres de archivo.

5) Resumen de la ventana principal

5.1 Barra superior (Entradas)

Interfaz Wi‑Fi Dispositivo físico, p.ej., wlan1.
Nombre del monitor Nombre a usar en modo monitor, p.ej., mon0. La aplicación cambiará el modo y renombrará si es necesario.
Banda (2.4 / 5 / 6 GHz) Banda en la que escanear el ESSID objetivo. 6 GHz requiere aircrack-ng reciente y soporte del controlador.
ESSID SSID exacto a buscar (distinguir mayúsculas/minúsculas).
Nivel de registro basic (mínimo), verbose (más detalle), debug (máximo detalle).
Descubrimiento (s) Duración de la fase de descubrimiento de banda.
Escaneo por BSSID (s) Tiempo de escucha pasiva por cada BSSID para enumerar clientes.
Iniciar / DETENER Ejecuta o detiene el flujo. DETENER finaliza los procesos y restaura el estado de NetworkManager/interfaz cuando corresponde.

5.2 Tabla de descubrimiento

Muestra todas las redes vistas durante el descubrimiento (BSSID, canal, banda, ESSID).

Filtros opcionales (si están habilitados en tu compilación):

Campo de búsqueda para filtrar por BSSID/ESSID parcial.
"Ocultar SSID ocultos" elimina filas en blanco/<hidden>.

5.3 Selección de objetivo y BSSID (filtrado por banda)

Lista los BSSID que coinciden con tu ESSID y la banda seleccionada, incluido el canal. Esto identifica los AP exactos que pertenecen a tu SSID.

5.4 Monitoreo por BSSID

Línea de estado – fase, BSSID actual y tiempo restante.
Barra de progreso – indeterminada durante el descubrimiento; cuenta atrás durante los escaneos por BSSID.
Clientes (BSSID actual) – MAC de clientes en vivo; se muestran con alias cuando están configurados.
Controles de salto – saltar descubrimiento o avanzar al siguiente BSSID.
Clientes y Handshakes… – abre el Centro de clientes (ver §6).

5.5 Panel de registro

Registros con marca de tiempo (comandos, códigos de salida, salida del conversor, errores). Se persisten en session.log con rotación automática. Abrir directorio de registros abre la carpeta de la sesión activa.

6) Centro de clientes

6.1 Puntos de acceso (izquierda)

Muestra los BSSID que coinciden con tu ESSID y banda. Selecciona uno para ver sus clientes.

6.2 Clientes (derecha)

Lista las MAC de clientes bajo el BSSID seleccionado con la hora de Última vista.

Asignar alias (doble clic o menú contextual → Nombre…) Guarda una etiqueta legible para una MAC (almacenada en aliases.json). Eliminar alias mediante menú contextual → Limpiar alias.

6.3 Barra de acciones

Iniciar monitoreo (BSSID) Inicia una captura pasiva de handshake para el BSSID seleccionado. Muestra una cuenta atrás e indicador de EAPOL.
Detener monitoreo Detiene la captura.
Difusión / Dirigido a cliente Solo marcadores de posición (sin desautenticación activa en esta compilación). Sí inician una captura pasiva de handshake para el mismo BSSID.
Paquetes Valor de interfaz para posibles variantes de laboratorio (no se usa aquí para desautenticación).
Exportar clientes Escribe CSV (y JSON si está habilitado) de todos los clientes conocidos en la carpeta de registros de la sesión.

6.4 Panel .22000

Muestra las primeras líneas del archivo .22000 más reciente.
Copiar hash copia el texto al portapapeles (sin auto‑limpiar en esta compilación).
Abrir carpeta abre el directorio que contiene el .22000.

6.5 Barra de estado

⏳ Temporizador – cuenta atrás (o "ejecutándose…" si es indefinido).
EAPOL – cambia a "sí" una vez que el conversor/stdout sugiere un handshake.

7) Flujo de trabajo funcional (Bajo el capó)

Pre‑vuelo – Verifica los binarios necesarios; muestra errores explícitos si faltan.
Modo monitor – Cambia la interfaz a modo monitor y aplica el nombre de monitor; restaura el estado del sistema al detener/salir.
Descubrimiento – Ejecuta airodump-ng --band <bg|a|6> a CSV; el robusto analizador basado en cabeceras maneja ESSID extraños / formatos CSV.
Selección de BSSID – Filtra por ESSID exacto y banda seleccionada.
Monitoreo por BSSID – Fija el canal (con fallback de frecuencia para 6 GHz) y ejecuta airodump-ng --bssid … --channel …; analiza la sección de Estaciones del CSV para mostrar nuevos clientes en vivo.
Handshake (.22000) – Durante el monitoreo (o mediante botones del Centro de clientes), convierte el .cap más reciente con hcxpcapngtool. Cuando existe un .22000 no vacío, se muestra y se registra. Se emiten notificaciones de escritorio cuando es compatible.
Watchdog – Si airodump-ng permanece en silencio, el proceso se reinicia limpiamente para ese paso (descubrimiento o por BSSID).
Inotify (opcional) – Usa inotify para analizar cambios de archivo inmediatamente; recurre a sondeo ligero de mtime si no está disponible.
Registro – Captura tanto stdout como stderr; rota session.log automáticamente.
Persistencia de sesión – Escribe continuamente BSSID/clientes/alias/contadores en session.json y los recarga al iniciar para el mismo ESSID.

8) Inicio rápido

Configura

AirScout

Más Populares