Sparrow-WiFi

Sparrow-WiFi é uma ferramenta de consciência espectral WiFi (2,4 GHz e 5 GHz) e Bluetooth para Linux. Ela integra em uma única plataforma: varredura WiFi, descoberta Bluetooth Low Energy e Classic, análise espectral via rádio definido por software (HackRF, Ubertooth), rastreamento GPS, detecção de drones FAA RemoteID, operações remotas montadas em drone/rover, e indexação ECS 8.17 no Elasticsearch ou OpenSearch. Escrito inteiramente em Python 3.

O projeto inclui quatro componentes que funcionam de forma independente ou em conjunto:

Componente	Interface	Finalidade
Sparrow-WiFi	GUI desktop PyQt5	Varredura WiFi/BT, análise espectral, rastreamento de fontes, wardriving
Sparrow Agent	Servidor HTTP headless	Varredura remota, implantações em drone/rover, integração com terceiros
Sparrow DroneID	Baseado na web (navegador)	Detecção de drones FAA RemoteID via WiFi e Bluetooth LE
Sparrow Elastic Bridge	Serviço CLI headless	Indexação ECS 8.17 de observações WiFi/BT no Elasticsearch / OpenSearch

O Sparrow Agent e o Sparrow DroneID expõem APIs REST JSON que permitem que outros aplicativos consultem resultados de varredura, acionem varreduras, recuperem detecções de drones e integrem consciência sem fio/de drones em seus próprios fluxos de trabalho. O Elastic Bridge consome a API REST do agente e envia documentos ECS 8.17 com painéis Kibana agrupados.

---

Novidades (Abril de 2026)

Esta versão traz três melhorias significativas em relação à versão anterior:

• Sparrow Agent: coalescência de varreduras WiFi single-flight. Quando vários clientes HTTP (o aplicativo DroneID, a ponte Elasticsearch, a GUI) acessam /wireless/networks/<iface> simultaneamente, o agente anteriormente iniciava N chamadas redundantes iw scan que serializavam no bloqueio por interface, multiplicando a latência da varredura pelo número de clientes. Agora, a primeira solicitação é a "líder" que realmente escaneia; as solicitações concorrentes aguardam um threading.Event e compartilham o resultado da líder. Também inclui correção TOCTOU na criação de bloqueios e segurança contra exceções nos bloqueios por interface.
• Sparrow DroneID — novo aplicativo baseado na web para detecção FAA RemoteID via WiFi (ASTM F3411 NAN, IEs de fornecedor de beacon, protocolo proprietário DroneID da DJI) e Bluetooth LE (publicidade BT4/BT5 Legacy). Inclui sobreposições de geozonas, alertas multi-estado com integração Slack, exportação KML, saída Cursor-on-Target, indexação opcional ECS 8.17 para Elasticsearch / OpenSearch (com um namespace personalizado droneid.*) e uma interface web responsiva multi-dispositivo. Veja a seção Sparrow DroneID abaixo.
• Ponte modernizada para Elasticsearch / OpenSearch — a ponte sparrow-elastic.py foi reescrita para produzir documentos ECS 8.17 (era ECS 1.5), agora suporta tanto Elasticsearch 8.x quanto OpenSearch 2.x, inicializa automaticamente modelos de índice componíveis com políticas de ciclo de vida ILM/ISM e aliases de gravação rotativos, realiza enriquecimento de fornecedor OUI e classificação de dispositivos baseada em regras (com fingerprinting opcional Fingerbank), e entrega quatro painéis Kibana agrupados mais seis visualizações legadas preservadas. A ponte ECS 1.5 legada está preservada em legacy/sparrow-elastic.py. Veja Integração com Elasticsearch / OpenSearch.

---

Sparrow-WiFi (GUI Desktop)

O aplicativo Sparrow original fornece uma GUI abrangente que substitui ferramentas como inSSIDer e LinSSID, com capacidades muito além da varredura básica:

• Varredura WiFi — Descoberta de SSID em 2,4 GHz e 5 GHz, intensidade do sinal, utilização do canal
• Rastreamento de fontes — Modo Hunt com altas taxas de amostragem e janelas de telemetria para localizar fontes WiFi e Bluetooth
• Análise espectral — Sobreposições espectrais em tempo real de 2,4/5 GHz via Ubertooth One ou HackRF One
• Bluetooth — Varredura de anúncios BLE, detecção/publicidade iBeacon, modo promíscuo do Ubertooth para classic + LE
• Agente remoto — Agente headless (sparrowwifiagent.py) para varredura distribuída, operações montadas em drone/rover e implantações em Raspberry Pi
• Integração GPS — gpsd, coordenadas estáticas ou MAVLink (GPS de drone)
• Mapeamento — Visualização no Google Maps / OpenStreetMap dos resultados da varredura com trilhas GPS
• Importar/Exportar — Saída CSV, JSON e iw scan bruta
• Elasticsearch / OpenSearch — Indexação compatível com ECS 8.17 de dados de varredura WiFi e Bluetooth com gerenciamento de ciclo de vida ILM/ISM, classificação de dispositivos, fingerprinting opcional Fingerbank e painéis Kibana agrupados
• Plugin Falcon — Integração com Aircrack-ng para testes de penetração (modo monitor, descoberta de SSID oculto, deauth, captura WEP/WPA)

Capturas de tela

---

Sparrow DroneID (Aplicação Web)

Um sistema independente baseado na web para detecção e rastreamento de drones que decodifica transmissões obrigatórias de Identificação Remota (RemoteID) da FAA. Executa como um servidor HTTP Python com uma interface de navegador acessível de qualquer dispositivo na rede.

Capacidades

• Captura WiFi — Decodifica quadros de ação ASTM F3411 NAN, IEs de fornecedor de beacon e DroneID proprietário da DJI
• Captura Bluetooth LE — Decodifica publicidade ASTM F3411 BT4/BT5 Legacy (UUID 0xFFFA)
• Mapa em tempo real — Mapa baseado em Leaflet com ícones de quadricóptero, indicadores de direção, marcadores de posição do operador e linhas drone-operador
• Rótulos rápidos — ID do operador e altitude AGL exibidos sob cada ícone de drone no mapa
• Popups de detalhes — Clique em um drone para ver número de série, ID de registro, ID do operador, tipo, velocidade, direção, altitude, rumo/distância do receptor, status BVLOS
• Sistema de alertas — Alertas configuráveis para novos drones, violações de altitude, violações de velocidade e perda de sinal com tons de áudio, notificações visuais, notificações webhook Slack e POSTs JSON opcionais com token de portador para uma API genérica externa de ingestão de alertas (veja Alertas Baseados em API abaixo)
• Reconhecimento de alertas — Fluxo de trabalho de três estados (Ativo/Reconhecido/Resolvido) com identidade do operador, compartilhado entre todos os dispositivos conectados
• Geozonas de aeroportos — Download automático e exibição de aeroportos próximos (dados OurAirports) e polígonos de espaço aéreo Proibido/Restrito da FAA, armazenados em cache localmente para operação offline
• GPS — Integração gpsd ou coordenadas estáticas configuráveis
• Histórico e reprodução — Histórico de detecção armazenado em SQLite com reprodução de linha do tempo e exportação KML
• Cursor-on-Target (CoT) — Saída CoT multicast para integração com SA
• Multi-dispositivo — Interface web funciona em desktop, tablet e telefone simultaneamente
• Métrico / Imperial — Suporte completo a preferências de unidades em toda a interface e alertas