Real-time network monitor + outbound firewall — see & block every connection. Privacy-first, local-first, Rust fleet agent, SIEM exports, 8 languages. / Moniteur réseau temps réel + pare-feu sortant, agent de flotte Rust, exports SIEM. 100 % local.
Funcionalidades de segurança
English | Français | Español | Deutsch | Русский | 日本語 | Português | 中文
O Snitch adiciona uma camada de threat-hunting sobre a observação passiva. O que ela faz — e, tão importante, o que não faz:
Orquestração do firewall de saída
O Snitch não filtra pacotes em user-space. As regras são aplicadas ao firewall nativo do SO, best-effort:
| SO | Mecanismo |
|---|---|
| Windows | regras de bloqueio de saída netsh advfirewall |
| Linux | iptables -A OUTPUT -j DROP (cadeia própria SNITCH_LOCK para o lockdown) |
| macOS | âncora pf gerada carregada com pfctl |
Tipos de regra: ip, cidr, domain (resolvido uma vez na aplicação),
process, port. As regras persistem em snitch.db e são reaplicadas
na inicialização.
Limites honestos:
- Aplicar regras exige os mesmos privilégios da captura. Sem elevação,
applied=Falsefica registrado na regra — a UI mostra «somente visibilidade». O matching continua: pacotes que violam uma regra emitem alertasBLOCKED_ATTEMPTcom contadores por regra. - O
pfno macOS não casa processo — regras de processo lá são, por design, apenas visibilidade. - Regras
domainresolvem o nome uma vez; uma CDN que troca de IP escapa da regra até recriá-la. - Lockdown corta tráfego de saída apenas para IPs públicos — loopback e LAN continuam para a UI seguir acessível.
Resposta a incidentes
POST /processes/kill/POST /processes/suspend— por PID, recusa PID ≤ 3 e o próprio Snitch. Privilégios normais do SO.POST /firewall/rules,DELETE /firewall/rules/{id},POST /firewall/rules/{id}/toggle,POST /firewall/lockdown— autenticados como todo endpoint.GET /forensics/export?process=<nome>&ip=<ip>— pacote de investigação: árvore de processos (até 8 ancestrais), SHA-256 do executável, linha de comando, alertas relacionados, histórico por minuto.format=json|csv|stixescolhe a saída (STIX = bundle 2.1 mínimo para SIEM). Apenas dados locais; a exportação é um download, nunca um upload.
Threat intelligence — opt-in, desligado por padrão
Configurações → Threat intelligence aceita um provedor (abuseipdb,
otx, virustotal) mais sua própria chave de API. Ligado, cada novo
IP público é verificado uma vez por TTL de 24 h; vereditos são cacheados
e suspicious/malicious dispara THREAT_HIT. Sem provedor nem chave,
zero chamadas externas. GET /security/ti mostra a configuração
mascarada; POST /security/threat_check roda uma verificação manual
(também ciente do cache).
Webhooks — opt-in, desligados por padrão
Configurações → Webhook externo aceita URL e interruptor. Alertas
warning e críticos são POSTados ao vivo: Discord/Slack {content},
Telegram {chat_id, text} (campo chat ID se a URL for telegram),
qualquer outro endpoint recebe {alert, source, text}. Falhas são
logadas, nunca fatais.
Novas detecções
DNS_TUNNEL— nomes/rótulos DNS superdimensionados (>60 car. / rótulo40), padrão clássico de exfiltração; uma vez por host a cada 10 min.
CLEARTEXT— TCP de saída para portas não criptografadas por natureza (80, 21, 23, 25, 110, 143…), nível INFO, alimenta a auditoria.BASELINE_DEVIATION— cada processo aprende seus países de destino usuais nos primeiros pacotes, depois avisa uma vez ao alcançar um novo. Baselines persistem (app_baselines).BEACON— já entregue: detecção de intervalos regulares (CV dos tempos de inter-chegada) mesmo com tráfego mínimo.BLOCKED_ATTEMPT,LOCKDOWN,THREAT_HIT— tipos adicionados pelos módulos acima.
Auditoria de segurança
GET /security/audit calcula um score 0–100 a partir dos últimos 500
alertas e do grafo ao vivo: contagens por tipo, contatos com países de
risco, hosts não resolvidos, postura do firewall — e devolve
recomendações em linguagem clara. É um relatório de achados, não uma
certificação.
Novidades v1.2 / Nouveautés v1.2
- Ação
sinkhole— regrasdomain/ippodem redirecionar para loopback em vez de bloquear: domínios via bloco marcado# snitch-sinkholeno arquivo hosts (todos os SOs), IPs/CIDRs viaDNATiptables (somente Linux).sinkholeemprocess/porté rejeitado; plataformas não suportadas →applied=Falsehonesto. - Re-resolução de domínios — regras
domainsão re-resolvidas a cada ~10 min e o delta de IP é aplicado por SO, para que a rotação de CDN não desbloqueie um nome silenciosamente. - Vigilância de integridade (ativada por padrão, somente leitura, local) — baselines SHA-256 de executáveis em rede (
BINARY_CHANGED), divergência nome/exe (NAME_MISMATCH), scanrwxpsomente Linux (MEM_RWX, nível info para apps JIT conhecidas).GET /security/integrity,POST /security/integrity/check. - Explicações de alertas —
GET /security/explain?type=Xretorna explicações bilíngues (EN/FR) escritas à mão; determinísticas e offline — não é um modelo. A UI mostra atrás do botão "Por quê?".
Sondas opcionais (v1.3)
Todas estão desativadas por padrão ou autolimitadas, degradam honestamente e nunca enviam dados para fora da máquina:
- Sonda eBPF connect (Linux,
ebpf_probe) — kprobe BCC tipotcpconnectatribuiconnect()de processos efêmeros demais para a tabela de sockets. Requerpython3-bcc+ root; destinos ambíguos nunca são adivinhados.GET /security/ebpf. - Inspeção Frida —
POST /security/deep_inspect {pid,seconds}anexa a UM pid por ≤60 s e reporta qual módulo carregado emitiu cadaconnect(). Caminhos de staging →INJECT_SUSPECT. - Respondedor sinkhole — com uma regra
sinkholeativa, listeners loopback em :80/:443 transformam cada tentativa em alertaSINKHOLE_HITcom Host/URI ou SNI + processo. - Integridade de módulos — raiz Merkle sobre mapeamentos executáveis →
MODULE_CHANGED; caminhos em/tmp/memfd →MODULE_SUSPECT. - Detecção de mineração — JSON stratum no cabeçalho do payload →
MINING_STRATUM; portas de pools + CPU sustentada →MINING_SUSPECT. - Contadores de hardware —
POST /security/perfamostra ciclos/instruções viaperf_event_open(Linux). - LLM local — opt-in (
slm_enabled):/security/explainchama um endpoint Ollama somente loopback — endpoints remotos rejeitados. - Pacotes IOC —
GET /security/iocpackexporta Bloom + randomized response (nunca em claro);POST /security/iocpack/importverifica destinos probabilisticamente.
Novidades de política e resposta (v1.4)
- Perfis nomeados —
POST /firewall/profile:permissive(tábua rasa),balanced(base de saída prudente) oustrict(base + lockdown); expandem em regras comuns com deduplicação. - Regras de alerta personalizadas —
GET/POST/DELETE /alerts/rules: campo + operador + valor → alertasCUSTOM_RULE(só alerta, nunca bloqueia). - Importar blocklist —
POST /firewall/blocklist: arquivo local (leitura puramente local) ou URL opt-in (fetch HTTPS ≤4 MiB, marcadoremote_fetch) → regrasdomain, deduplicadas, teto 500–5000. - Exportar PCAP —
GET /forensics/pcap(filtrosip/process): anel de ~4 MiB como.pcappara Wireshark. - Pareamento remoto —
POST /remote/pairingpersistelan_bindpara a próxima inicialização; token continua obrigatório.GET /remote/pairingreporta bind + IPs da LAN. - Sandbox sem rede —
POST /security/sandboxexecuta um binário com egress zero (unshare -nLinux,sandbox-execmacOS;contrib/snitch-containmanual). - Modelo embutido —
slm_mode=embeddedcarrega um.ggufdo usuário viallama-cpp-python— zero rede. - Esqueletos nativos —
contrib/wfp-callout/(callout WFP em C + assinatura) econtrib/macos-filter/(NEFilterDataProviderSwift + entitlements): scaffolding de pesquisa, não distribuídos. - ASN — com
GeoLite2-ASN.mmdb/dbip-asn-lite.mmdb, os nós carregamasnalém deorg.
v1.5 — Inspeção passiva, vereditos em kernel e sincronização de frota
- Inspeção passiva do certificado TLS — remontagem TCP limitada (≤16 KiB/fluxo, TTL 30 s) lê a mensagem
Certificate: CN+O emissor/sujeito, autoassinado, SANs, validade,san_mismatch→TLS_CERT. TLS 1.3 permanece opaco — honestamente inobservável em vez de adivinhado. - Guarda de alta entropia — payloads ≥48 B em canais não TLS com ≥4,7 bits/byte →
HIGH_ENTROPY; cooldown de 10 min por host. - Heurística de túnel ICMP — tipos echo com ≥24 B de payload, ≥3× em 5 min →
ICMP_TUNNEL. - Anomalia ML de fluxo — isolation forest em Python puro (64 árvores, zero deps) sobre seus próprios resumos; inerte <384 fluxos,
ML_ANOMALYa 0,62. Desvio de baseline, não um classificador. - Ask-on-connect (Linux, opt-in) —
ask_enabled+ root + iptables: novos fluxos de saída retidos na NFQUEUE 7 atéPOST /security/ask/verdict— o cliente NFQUEUE é Python puro (detection/nfqueue.py, AF_NETLINK), sempython-netfilterqueue; timeout 15 s, fail-closed (ask_failopen=1inverte). Windows/macOS precisam dos esqueletos assinados emcontrib/. - Enforcement eBPF cgroup (Linux, opt-in) —
POST /security/ebpf/isolate {pid}+/security/ebpf/block {ip}: programa attach ao cgroup snitch — drops em kernel SÓ para processos isolados. - Check de hollowing (Linux) —
POST /security/hollow {pid}compara páginas executáveis file-backed de/proc/<pid>/memcom o disco. - Sincronização IOC entre pares (opt-in) —
gossip_peers≤32 +gossip_enabled: pacotes Merkle a cada 5 min via HTTP(S) autenticado — sem discovery, não é ZK. - Syslog (opt-in) —
syslog_addr(host:portaUDP outcp://) → RFC 3164local4. - Contenção Firejail —
firejail --net=nonepreferido,unsharecomo fallback. - Backend nftables — tabela
inet snitchdedicada em vez de iptables onde existenft. - Alertas acionáveis —
actionsestruturadas (bloquear IP, matar/suspender, veredito ask) como botões de um clique. asn/countryem regras custom — base geo local, combinável comaction=blockcomo geo-fence.- Heurística DGA — nomes DNS resolvidos e SNIs TLS são pontuados por
traços lexicais (entropia, vogais, consoantes empilhadas, dígitos) →
DGA_SUSPECT. Heurística local pura; sem WHOIS nem idade de domínio. - Protocolo disfarçado — o cabeçalho ≤64 B do payload deve combinar
com o protocolo da porta (HTTP/80, DNS/53, SSH/22, TLS/443+853,
comandos ASCII de e-mail) →
PROTO_MISMATCH, cooldown por fluxo. - Kill-switch de volume (opt-in) —
kill_switch_enabledtransforma umUPLOAD_SPIKEem bloqueio de firewall real na IP remota (deduplicado, best-effort). Desativado por padrão.