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.
Snitch — Integrações empresariais
Community translated — PRs welcome for refinement / Traduzido pela comunidade — PRs de melhoria são bem-vindos.
PT-BR: Receitas passo a passo para ligar o Snitch a um stack SOC — Wazuh, Splunk, Graylog/Loki, Ansible, Docker/Kubernetes — tudo grátis e auto-hospedado, coerente com a postura local-first do Snitch. O Snitch não emite telemetria própria; as únicas conexões de saída são as que você configura aqui.
1. Saída SIEM
O Snitch oferece três formatos nativos para encaminhar alertas:
| Ajuste | Valores | Efeito |
|---|---|---|
syslog_addr |
host:514 ou tcp://host:514 |
Ativa o encaminhamento syslog (UDP por padrão, TCP com prefixo tcp://) |
syslog_format |
rfc3164 (padrão) |
Syslog BSD clássico — legível por qualquer coletor |
cef |
`CEF:0 | |
webhook_url + webhook_enabled |
URL | POST JSON genérico (ou payloads Discord/Slack/Telegram autodetectados) |
GET /forensics/export?format=… |
json, csv, stix, ecs |
Bundles forenses únicos — ecs emite Elastic Common Schema em NDJSON |
Configure na UI (Configurações → Segurança) ou no snitch.toml:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
2. Wazuh
Ative um listener syslog no manager Wazuh (
/var/ossec/etc/ossec.conf):<remote> <connection>syslog</connection> <port>514</port> <protocol>udp</protocol> <allowed-ips>your-agent-subnet</allowed-ips> </remote>Aponte cada agente Snitch — Ansible:
snitch_syslog_addr: "wazuh.example.com:514" snitch_syslog_format: "cef"O decodificador CEF do Wazuh captura os
CEF:0|Snitch|…; aseveritymapeia para PRI syslog (critical→2, warning→4, info→6).
3. Splunk
- Configurações → Entradas de dados → UDP → nova entrada na 514,
sourcetype
syslog(ou entrada TCP para remetentestcp://…). syslog_format = "cef"dásrc,dst,dpt,cs1Labelde graça; para dashboards, consulteGET /forensics/export?format=ecsvia scripted input — o JSON é extraído automaticamente.
4. Graylog / Loki
- Graylog: System → Inputs → Syslog UDP, porta 514. Os campos de extensão CEF chegam como campos da mensagem.
- Loki/Grafana: aponte
syslog_addrpara um target syslog dopromtailou faça scrape de/forensics/export?format=ecsvia cron → job push para o Loki.
5. Configuração declarativa (Security-as-Code)
O backend aplica um arquivo na inicialização — $SNITCH_CONFIG, ou
snitch.toml/snitch.json no diretório de dados. Cada chave declarada
sobrescreve o valor UI/DB: o arquivo é a fonte de verdade da frota:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
kill_switch_enabled = true
ask_enabled = false # servidores headless
gossip_peers = ["sec-01:8000"]
ports = [80, 443]
Vocabulário completo: packaging/snitch.toml.example.
6. Ansible / Puppet / Salt / GPO
Ansible — role pronta em
deploy/ansible/:ansible-playbook -i inventory deploy/ansible/site.ymlInstala
/opt/snitch, o venv,/etc/snitch/snitch.tomle a unit systemd endurecida, e habilitasnitch.service.Puppet / SaltStack — esqueletos comunitários em
deploy/puppet/edeploy/salt/(labelhelp wanted): as mesmas três primitivas — copiar a árvore backend, renderizarsnitch.toml, gerenciarsnitch.service.Windows GPO —
deploy/gpo/Install-Snitch.ps1faz a instalação silenciosa (config no ProgramData, venv, tarefa SYSTEM em 127.0.0.1). Ask-on-connect no Windows requer adicionalmente o callout WFP assinado — verdocs/SIGNING.md.
7. Docker & Kubernetes
Host único:
docker compose up—network_mode: host+cap_add: NET_RAW/NET_ADMINjá nodocker-compose.yml.Console de frota:
deploy/helm/snitch—mode: collectorsobe um Deployment ClusterIP que funde as auditorias de todos os agentes configurados emGET /remote/fleet;mode: agentrenderiza um DaemonSet host-network comNET_RAW/NET_ADMIN.helm install snitch ./deploy/helm/snitch \ --set token=$(openssl rand -hex 32) \ --set config.gossip_peers='["agent-1:8000","agent-2:8000"]'
8. Regras Sigma
POST /alerts/rules/sigma aceita um YAML Sigma e compila o subconjunto
suportado (seleções campo→valor, |contains/|startswith/|endswith/
|re/|cidr/|gt/|lt/|all, condições 1 of/all of) em regras
custom do Snitch — apenas alertas, com motivos skipped para o que não
é suportado. Os campos mapeiam para o que um sensor de pacotes vê
(DestinationIp→remote_ip, Image→process_name, Domain→host, …).
YARA-L para Google SecOps/Chronicle: GET /alerts/rules/yaral exporta
todas as regras (incluindo as importadas de Sigma) como arquivo .yar —
o caminho Sigma→YARA-L fica coberto.
9. Agentes remotos (snitch-agent/1)
agent/ contém um daemon Rust leve (zero dependências, um binário ~1 MB)
que observa a tabela de sockets do host (/proc/net/*) e envia novos
fluxos de saída para POST /ingest/events. Observa sockets — sem
payloads/SNI (isso fica com o capture local); atribuição de processo é
TODO marcado. Transporte: HTTP + bearer (mesmo domínio de confiança de
gossip_peers).
10. Feeds de threat-intel gratuitos
POST /firewall/blocklist importa ambas as formas:
kind: "domain"— listas hosts/domínios (StevenBlack, EasyList…) → regrasdomain;kind: "ip"— feeds IP (Blocklist.de, exports URLhaus/Feodo) → regrasip; endereços privados/reservados/loopback nunca são importados.
path: lê arquivo local (totalmente offline); url: é um fetch opt-in
explícito e auditado (remote_fetch: true na resposta). Limite
max_entries ≤ 5000 — feeds gigantes pertencem a um resolver.
Provedores opt-in (AbuseIPDB / OTX / VirusTotal) seguem disponíveis via
ti_provider + ti_api_key — nada sai sem a sua chave.
11. Modo headless / daemon
A GUI é opcional: o backend é o produto inteiro. Rode direto
(uvicorn api.main:app), sob a unit systemd incluída ou no container —
todas as funções acima funcionam sem frontend. SNITCH_DEMO=1 segue
oferecendo um feed sintético sem root para treinamentos e CTFs.