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 — Integraciones empresariales
Community translated — PRs welcome for refinement / Traducido por la comunidad — se aceptan PRs de mejora.
ES: Recetas paso a paso para integrar Snitch en un stack SOC — Wazuh, Splunk, Graylog/Loki, Ansible, Docker/Kubernetes — todo gratis y auto-alojado, coherente con la postura local-first de Snitch. Snitch no emite telemetría propia; las únicas conexiones salientes son las que configuras aquí.
1. Salida SIEM
Snitch ofrece tres formatos nativos para reenviar alertas:
| Ajuste | Valores | Efecto |
|---|---|---|
syslog_addr |
host:514 o tcp://host:514 |
Activa el reenvío syslog (UDP por defecto, TCP con prefijo tcp://) |
syslog_format |
rfc3164 (por defecto) |
Syslog BSD clásico — legible por cualquier colector |
cef |
`CEF:0 | |
webhook_url + webhook_enabled |
URL | POST JSON genérico (o payloads Discord/Slack/Telegram autodetectados) |
GET /forensics/export?format=… |
json, csv, stix, ecs |
Bundles forenses de una vez — ecs emite Elastic Common Schema en NDJSON |
Configúralos en la UI (Ajustes → Seguridad) o en snitch.toml:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
2. Wazuh
Activa un listener syslog en el 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>Apunta cada agente Snitch — Ansible:
snitch_syslog_addr: "wazuh.example.com:514" snitch_syslog_format: "cef"El decodificador CEF de Wazuh recoge los
CEF:0|Snitch|…; laseverityse mapea a PRI syslog (critical→2, warning→4, info→6).
3. Splunk
- Configuración → Entradas de datos → UDP → nueva entrada en 514,
sourcetype
syslog(o entrada TCP para emisorestcp://…). syslog_format = "cef"te dasrc,dst,dpt,cs1Labelgratis; para dashboards consultaGET /forensics/export?format=ecscon un scripted input — el JSON se extrae automáticamente.
4. Graylog / Loki
- Graylog: System → Inputs → Syslog UDP, puerto 514. Los campos de extensión CEF llegan como campos del mensaje.
- Loki/Grafana: apunta
syslog_addra un target syslog depromtailo scrapea/forensics/export?format=ecscon cron → job push a Loki.
5. Configuración declarativa (Security-as-Code)
El backend aplica un archivo al arrancar — $SNITCH_CONFIG, o
snitch.toml/snitch.json en el directorio de datos. Cada clave
declarada sobrescribe el valor UI/DB: el archivo es la fuente de verdad
de la flota:
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]
Vocabulario completo: packaging/snitch.toml.example.
6. Ansible / Puppet / Salt / GPO
Ansible — rol listo en
deploy/ansible/:ansible-playbook -i inventory deploy/ansible/site.ymlInstala
/opt/snitch, el venv,/etc/snitch/snitch.tomly la unidad systemd endurecida, y habilitasnitch.service.Puppet / SaltStack — esqueletos comunitarios en
deploy/puppet/ydeploy/salt/(labelhelp wanted): las mismas tres primitivas — copiar el árbol backend, renderizarsnitch.toml, gestionarsnitch.service.Windows GPO —
deploy/gpo/Install-Snitch.ps1hace la instalación silenciosa (config en ProgramData, venv, tarea SYSTEM en 127.0.0.1). Ask-on-connect en Windows requiere además el callout WFP firmado — verdocs/SIGNING.md.
7. Docker & Kubernetes
Host único:
docker compose up—network_mode: host+cap_add: NET_RAW/NET_ADMINya endocker-compose.yml.Consola de flota:
deploy/helm/snitch—mode: collectorlanza un Deployment ClusterIP que fusiona las auditorías de todos los agentes configurados enGET /remote/fleet;mode: agentrenderiza un DaemonSet host-network conNET_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. Reglas Sigma
POST /alerts/rules/sigma acepta un YAML Sigma y compila el subconjunto
soportado (selecciones campo→valor, |contains/|startswith/|endswith/
|re/|cidr/|gt/|lt/|all, condiciones 1 of/all of) en reglas
custom de Snitch — solo alertas, con motivos skipped para lo no
soportado. Los campos se mapean a lo que un sensor de paquetes ve
(DestinationIp→remote_ip, Image→process_name, Domain→host, …).
YARA-L para Google SecOps/Chronicle: GET /alerts/rules/yaral exporta
todas las reglas (incluidas las Sigma importadas) como archivo .yar —
el camino Sigma→YARA-L queda cubierto.
9. Agentes remotos (snitch-agent/1)
agent/ contiene un daemon Rust ligero (cero dependencias, un solo
binario ~1 MB) que observa la tabla de sockets del host (/proc/net/*)
y envía los nuevos flujos salientes a POST /ingest/events. Observa
sockets — sin payloads/SNI (eso queda en el capture local); la
atribución de proceso está marcada como TODO. Transporte: HTTP + bearer
(dominio de confianza como gossip_peers).
10. Feeds de threat-intel gratuitos
POST /firewall/blocklist importa ambas formas:
kind: "domain"— listas hosts/dominios (StevenBlack, EasyList…) → reglasdomain;kind: "ip"— feeds IP (Blocklist.de, exports URLhaus/Feodo) → reglasip; nunca se importan direcciones privadas/reservadas/loopback.
path: lee un archivo local (totalmente offline); url: es un fetch
opt-in explícito y auditado (remote_fetch: true en la respuesta).
Límite max_entries ≤ 5000 — los feeds gigantes pertenecen a un resolver.
Los proveedores opt-in (AbuseIPDB / OTX / VirusTotal) siguen disponibles
vía ti_provider + ti_api_key — nada sale sin tu clave.
11. Modo headless / daemon
La GUI es opcional: el backend es todo el producto. Ejecútalo directo
(uvicorn api.main:app), bajo la unidad systemd incluida o en el
contenedor — todas las funciones anteriores funcionan sin frontend.
SNITCH_DEMO=1 sigue ofreciendo un feed sintético sin root para
formaciones y CTFs.