Sparrow-WiFi

Sparrow-WiFi es una herramienta de conciencia espectral WiFi y Bluetooth (2.4 GHz y 5 GHz) para Linux. Integra en una sola plataforma el escaneo WiFi, la detección de Bluetooth Low Energy y Classic, el análisis espectral mediante radio definida por software (HackRF, Ubertooth), el seguimiento GPS, la detección de drones FAA RemoteID, operaciones remotas con drones/rovers y la indexación ECS 8.17 en Elasticsearch o OpenSearch. Escrito íntegramente en Python 3.

El proyecto incluye cuatro componentes que funcionan de forma independiente o conjunta:

Componente	Interfaz	Propósito
Sparrow-WiFi	GUI de escritorio PyQt5	Escaneo WiFi/BT, análisis espectral, seguimiento de fuentes, wardriving
Sparrow Agent	Servidor HTTP sin interfaz gráfica	Escaneo remoto, despliegues en drones/rovers, integración con terceros
Sparrow DroneID	Basado en web (navegador)	Detección de drones FAA RemoteID mediante WiFi y Bluetooth LE
Sparrow Elastic Bridge	Servicio CLI sin interfaz gráfica	Indexación ECS 8.17 de observaciones WiFi/BT en Elasticsearch / OpenSearch

Sparrow Agent y Sparrow DroneID exponen APIs REST JSON que permiten a otras aplicaciones consultar resultados de escaneo, iniciar escaneos, recuperar detecciones de drones e integrar la conciencia inalámbrica/de drones en sus propios flujos de trabajo. Elastic Bridge consume la API REST del agente y envía documentos ECS 8.17 con paneles de Kibana incluidos.

---

Novedades (abril de 2026)

Esta versión incluye tres mejoras significativas respecto a la anterior:

• Sparrow Agent: coalescencia de escaneos WiFi de un solo vuelo. Cuando múltiples clientes HTTP (la aplicación DroneID, el puente de Elasticsearch, la GUI) acceden simultáneamente a /wireless/networks/<iface>, el agente anterior lanzaba N llamadas iw scan redundantes que se serializaban en el bloqueo por interfaz, multiplicando la latencia de escaneo por el número de clientes. Ahora la primera solicitud es la "líder" que realmente escanea; las solicitudes concurrentes esperan en un threading.Event y comparten el resultado de la líder. También incluye corrección TOCTOU en la creación de bloqueos y seguridad ante excepciones en los bloqueos por interfaz.
• Sparrow DroneID — nueva aplicación web para detección de RemoteID FAA mediante WiFi (ASTM F3411 NAN, IEs de proveedor en balizas, protocolo DroneID propietario de DJI) y Bluetooth LE (publicidad Legacy BT4/BT5). Incluye superposiciones de geozonas, alertas multi-estado con integración con Slack, exportación KML, salida Cursor-on-Target, indexación opcional ECS 8.17 a Elasticsearch / OpenSearch (con un espacio de nombres droneid.* personalizado) y una interfaz web responsive multidispositivo. Consulte la sección Sparrow DroneID a continuación.
• Puente modernizado para Elasticsearch / OpenSearch — el puente sparrow-elastic.py ha sido reescrito para producir documentos ECS 8.17 (antes ECS 1.5), ahora admite tanto Elasticsearch 8.x como OpenSearch 2.x, inicia automáticamente plantillas de índice componibles con políticas de ciclo de vida ILM/ISM y alias de escritura por rotación, realiza enriquecimiento de proveedores OUI y clasificación de dispositivos basada en reglas (con huella digital Fingerbank opcional), y envía cuatro paneles de Kibana incluidos más seis visualizaciones heredadas conservadas. El puente heredado ECS 1.5 se conserva en legacy/sparrow-elastic.py. Consulte Integración con Elasticsearch / OpenSearch.

---

Sparrow-WiFi (GUI de escritorio)

La aplicación original Sparrow proporciona una GUI integral que sustituye a herramientas como inSSIDer y LinSSID, con capacidades que van mucho más allá del escaneo básico:

• Escaneo WiFi — descubrimiento de SSID en 2.4 GHz y 5 GHz, intensidad de señal, utilización del canal
• Seguimiento de fuentes — Modo de caza con altas tasas de muestreo y ventanas de telemetría para localizar fuentes WiFi y Bluetooth
• Análisis espectral — Superposiciones espectrales en tiempo real en 2.4/5 GHz mediante Ubertooth One o HackRF One
• Bluetooth — Escaneo de publicidad BLE, detección/publicidad de iBeacon, modo promiscuo de Ubertooth para Classic + LE
• Agente remoto — Agente sin interfaz gráfica (sparrowwifiagent.py) para escaneo distribuido, operaciones montadas en drones/rovers y despliegues en Raspberry Pi
• Integración GPS — gpsd, coordenadas estáticas o MAVLink (GPS de dron)
• Mapas — Visualización de resultados de escaneo con trazas GPS en Google Maps / OpenStreetMap
• Importar/Exportar — CSV, JSON y salida cruda de iw scan
• Elasticsearch / OpenSearch — Indexación de datos de escaneo WiFi y Bluetooth conforme a ECS 8.17 con gestión de ciclo de vida ILM/ISM, clasificación de dispositivos, huella digital Fingerbank opcional y paneles de Kibana incluidos
• Complemento Falcon — Integración con Aircrack-ng para pruebas de penetración (modo monitor, descubrimiento de SSID ocultos, deauth, captura WEP/WPA)

Capturas de pantalla

---

Sparrow DroneID (Aplicación web)

Un sistema independiente de detección y seguimiento de drones basado en web que decodifica las transmisiones de Identificación Remota (RemoteID) obligatorias por la FAA. Se ejecuta como un servidor HTTP Python con una interfaz de usuario accesible desde cualquier dispositivo de la red.

Capacidades

• Captura WiFi — Decodifica tramas de acción ASTM F3411 NAN, IEs de proveedor en balizas y DroneID propietario de DJI
• Captura Bluetooth LE — Decodifica publicidad Legacy ASTM F3411 BT4/BT5 (UUID 0xFFFA)
• Mapa en tiempo real — Mapa basado en Leaflet con iconos de cuadricópteros, indicadores de rumbo, marcadores de posición del operador y líneas dron-operador
• Etiquetas de un vistazo — ID del operador y altitud AGL mostrados bajo cada icono de dron en el mapa
• Ventanas emergentes de detalle — Haga clic en un dron para ver número de serie, ID de registro, ID del operador, tipo, velocidad, rumbo, altitud, rumbo/distancia desde el receptor, estado BVLOS
• Sistema de alertas — Alertas configurables para nuevos drones, violaciones de altitud, violaciones de velocidad y pérdida de señal con tonos de audio, notificaciones visuales, notificaciones webhook Slack y POSTs JSON opcionales con token portador a una API externa genérica de ingesta de alertas (consulte Alertas basadas en API a continuación)
• Confirmación de alertas — Flujo de trabajo de tres estados (Activa/Confirmada/Resuelta) con identidad del operador, compartida entre todos los dispositivos conectados
• Geozonas de aeropuertos — Descarga y visualización automática de aeropuertos cercanos (datos OurAirports) y polígonos de espacio aéreo Prohibido/Restringido de la FAA, almacenados en caché local para funcionamiento sin conexión
• GPS — Integración con gpsd o coordenadas estáticas configurables
• Historial y reproducción — Historial de detecciones respaldado por SQLite con reproducción en línea de tiempo y exportación KML
• Cursor-on-Target (CoT) — Salida CoT multicast para integración con SA
• Multidispositivo — La interfaz web funciona simultáneamente en escritorio, tablet y teléfono
• Métrica/Imperial — Soporte completo de preferencias de unidades en toda la interfaz y las alertas