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 — Enterprise-Integrationen
Community translated — PRs welcome for refinement / Von der Community übersetzt — PRs zur Verbesserung willkommen.
DE: Schritt-für-Schritt-Anleitungen, um Snitch in einen SOC-Stack einzubinden — Wazuh, Splunk, Graylog/Loki, Ansible, Docker/Kubernetes — alles kostenlos und selbst gehostet, passend zu Snitches Local-first-Ansatz. Snitch sendet keine eigene Telemetrie; die einzigen ausgehenden Verbindungen sind die hier konfigurierten.
1. SIEM-Ausgabe
Snitch bietet drei native Formate für die Alarm-Weiterleitung:
| Einstellung | Werte | Wirkung |
|---|---|---|
syslog_addr |
host:514 oder tcp://host:514 |
Aktiviert Syslog-Weiterleitung (UDP Standard, TCP mit tcp://-Präfix) |
syslog_format |
rfc3164 (Standard) |
Klassisches BSD-Syslog — von jedem Kollektor lesbar |
cef |
`CEF:0 | |
webhook_url + webhook_enabled |
URL | Generischer JSON-POST (oder automatisch erkannte Discord/Slack/Telegram-Payloads) |
GET /forensics/export?format=… |
json, csv, stix, ecs |
Einmalige Forensik-Bundles — ecs erzeugt zeilenweise Elastic Common Schema |
In der UI setzen (Einstellungen → Sicherheit) oder in snitch.toml:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
2. Wazuh
Syslog-Listener auf dem Wazuh-Manager aktivieren (
/var/ossec/etc/ossec.conf):<remote> <connection>syslog</connection> <port>514</port> <protocol>udp</protocol> <allowed-ips>your-agent-subnet</allowed-ips> </remote>Jeden Snitch-Agenten darauf zeigen lassen — Ansible:
snitch_syslog_addr: "wazuh.example.com:514" snitch_syslog_format: "cef"Der CEF-Decoder von Wazuh übernimmt die
CEF:0|Snitch|…-Meldungen;severitywird auf syslog-PRI abgebildet (critical→2, warning→4, info→6).
3. Splunk
- Einstellungen → Daten-Inputs → UDP → neuer Input auf 514, Sourcetype
syslog(oder TCP-Input fürtcp://…-Sender). syslog_format = "cef"liefertsrc,dst,dpt,cs1Labelgratis; für DashboardsGET /forensics/export?format=ecsper Scripted Input abfragen — JSON wird automatisch extrahiert.
4. Graylog / Loki
- Graylog: System → Inputs → Syslog UDP, Port 514. CEF-Erweiterungsfelder landen als Nachrichtenfelder.
- Loki/Grafana:
syslog_addrauf einpromtail-Syslog-Target richten oder/forensics/export?format=ecsper Cronjob → Loki-Push-Job scrapen.
5. Deklarative Konfiguration (Security-as-Code)
Das Backend wendet eine Datei beim Start an — $SNITCH_CONFIG, sonst
snitch.toml/snitch.json im Datenverzeichnis. Jede deklarierte
Einstellung überschreibt den UI/DB-Wert — die Datei ist die
Wahrheitsquelle der Flotte:
syslog_addr = "siem.example.com:514"
syslog_format = "cef"
kill_switch_enabled = true
ask_enabled = false # headless Server
gossip_peers = ["sec-01:8000"]
ports = [80, 443]
Vollständiges Vokabular: packaging/snitch.toml.example.
6. Ansible / Puppet / Salt / GPO
Ansible — fertige Rolle in
deploy/ansible/:ansible-playbook -i inventory deploy/ansible/site.ymlInstalliert
/opt/snitch, das venv,/etc/snitch/snitch.tomlund die gehärtete systemd-Unit, aktiviert dannsnitch.service.Puppet / SaltStack — Community-Skelette in
deploy/puppet/unddeploy/salt/(Labelhelp wanted): dieselben drei Primitive — Backend-Baum kopieren,snitch.tomlrendern,snitch.serviceverwalten.Windows GPO —
deploy/gpo/Install-Snitch.ps1führt die Silent-Installation aus (ProgramData-Config, venv, SYSTEM-Aufgabe auf 127.0.0.1). Ask-on-connect unter Windows braucht zusätzlich den signierten WFP-Callout — siehedocs/SIGNING.md.
7. Docker & Kubernetes
Einzelhost:
docker compose up—network_mode: host+cap_add: NET_RAW/NET_ADMINbereits indocker-compose.yml.Flotten-Konsole:
deploy/helm/snitch—mode: collectorstartet ein ClusterIP-Deployment, das die Audits aller konfigurierten Agenten inGET /remote/fleetzusammenführt;mode: agentrendert ein Host-Network-DaemonSet mitNET_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. Sigma-Regeln
POST /alerts/rules/sigma akzeptiert ein Sigma-YAML und kompiliert die
unterstützte Teilmenge (Feld→Wert-Selektionen, |contains/|startswith/
|endswith/|re/|cidr/|gt/|lt/|all, 1 of/all of-Bedingungen)
in Snitch-Custom-Rules — nur Alarme, skipped-Gründe für alles
außerhalb der Teilmenge. Felder werden auf das gemappt, was ein
Paket-Sensor sieht (DestinationIp→remote_ip, Image→process_name,
Domain→host, …).
YARA-L für Google SecOps/Chronicle: GET /alerts/rules/yaral exportiert
alle Regeln (inkl. importierter Sigma-Regeln) als .yar-Datei — der
Weg Sigma→YARA-L ist damit abgedeckt.
9. Remote-Agenten (snitch-agent/1)
agent/ enthält einen leichten Rust-Daemon (null Abhängigkeiten, ein
~1-MB-Binary), der die Socket-Tabelle des Hosts (/proc/net/*)
beobachtet und neue ausgehende Flows an POST /ingest/events pusht.
Er beobachtet Sockets — keine Payloads/SNI (das bleibt beim lokalen
Capture); Prozess-Attribution ist als TODO markiert. Transport: HTTP +
Bearer-Token (Trust-Domain wie gossip_peers).
10. Kostenlose Threat-Intel-Feeds
POST /firewall/blocklist importiert beide Formen:
kind: "domain"— Hosts-/Domain-Listen (StevenBlack, EasyList…) →domain-Firewall-Regeln;kind: "ip"— IP-Feeds (Blocklist.de, URLhaus/Feodo-Exports) →ip-Regeln; private/reservierte/Loopback-Adressen werden nie importiert.
path: liest eine lokale Datei (vollständig offline); url: ist ein
expliziter, auditierter Opt-in-Fetch (remote_fetch: true in der
Antwort). Limit max_entries ≤ 5000 — riesige Feeds gehören in einen
Resolver.
Opt-in-API-Anbieter (AbuseIPDB / OTX / VirusTotal) bleiben über
ti_provider + ti_api_key verfügbar — ohne Schlüssel geht nichts raus.
11. Headless- / Daemon-Modus
Die GUI ist optional: das Backend ist das gesamte Produkt. Direkt
(uvicorn api.main:app), unter der mitgelieferten systemd-Unit oder im
Container — alle Funktionen oben laufen ohne Frontend.
SNITCH_DEMO=1 liefert weiterhin einen root-freien synthetischen Feed
für Schulungen und CTFs.