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.
Sicherheitsfunktionen
English | Français | Español | Deutsch | Русский | 日本語 | Português | 中文
Snitch bringt eine Threat-Hunting-Schicht über der passiven Beobachtung. Was sie tut — und ebenso wichtig, was sie nicht tut:
Orchestrierung der Ausgangs-Firewall
Snitch filtert keine Pakete im User-Space. Regeln werden best-effort an die OS-native Firewall übergeben:
| OS | Mechanismus |
|---|---|
| Windows | ausgehende Blockregeln via netsh advfirewall |
| Linux | iptables -A OUTPUT -j DROP (eigene SNITCH_LOCK-Chain für Lockdown) |
| macOS | generierter pf-Anchor, geladen mit pfctl |
Regelarten: ip, cidr, domain (einmalig beim Anwenden aufgelöst),
process, port. Regeln persistieren in snitch.db und werden beim
Start erneut angewendet.
Ehrliche Grenzen:
- Das Anwenden braucht dieselben Privilegien wie die Capture. Ohne
Erhöhung wird
applied=Falseauf der Regel vermerkt — die UI zeigt „nur Sichtbarkeit“. Das Matching läuft trotzdem: Pakete, die eine Regel verletzen, lösenBLOCKED_ATTEMPT-Alarme mit Zählern pro Regel. pfauf macOS kann keinen Prozess matchen — Prozessregeln sind dort bewusst nur Sichtbarkeit.domain-Regeln lösen den Namen einmalig auf; eine CDN mit wechselnden IPs entkommt der Regel bis zur Neuanlage.- Lockdown unterbricht Ausgangstraffic nur zu öffentlichen IPs — Loopback und LAN bleiben offen, damit die UI erreichbar bleibt.
Incident Response
POST /processes/kill/POST /processes/suspend— per PID, lehnt PIDs ≤ 3 und Snitch selbst ab. Übliche OS-Privilegien gelten.POST /firewall/rules,DELETE /firewall/rules/{id},POST /firewall/rules/{id}/toggle,POST /firewall/lockdown— authentifiziert wie jeder Endpoint.GET /forensics/export?process=<name>&ip=<ip>— Ermittlungspaket: Prozessbaum (bis 8 Ahnen), SHA-256 der Exe, Kommandozeile, passende Alarme, Minuten-Historie.format=json|csv|stixwählt die Ausgabe (STIX = minimales 2.1-Bundle für SIEM). Nur lokale Daten; Export ist ein Download, nie ein Upload.
Threat Intelligence — Opt-in, standardmäßig aus
Einstellungen → Threat Intelligence akzeptiert einen Anbieter
(abuseipdb, otx, virustotal) plus deinen eigenen API-Key.
Aktiviert wird jede neue öffentliche IP einmal pro 24-h-TTL geprüft;
Urteile werden gecacht und suspicious/malicious löst THREAT_HIT
aus. Ohne Anbieter oder Key: null ausgehende Aufrufe.
GET /security/ti zeigt die maskierte Konfiguration;
POST /security/threat_check startet eine manuelle Prüfung (ebenfalls
cache-bewusst).
Webhooks — Opt-in, standardmäßig aus
Einstellungen → Externer Webhook nimmt URL + Schalter. Warn- und
Kritik-Alarme werden live gePOSTet: Discord/Slack {content}, Telegram
{chat_id, text} (Chat-ID-Feld bei Telegram-URL), sonstige Endpoints
bekommen {alert, source, text}. Fehler werden geloggt, nie fatal.
Erkennungs-Neuerungen
DNS_TUNNEL— überlange DNS-Namen/-Labels (>60 Zeichen / Label >40), klassisches Exfiltrationsmuster; einmal pro Host pro 10 min.CLEARTEXT— ausgehendes TCP zu natürlich unverschlüsselten Ports (80, 21, 23, 25, 110, 143…), Stufe INFO, speist das Audit.BASELINE_DEVIATION— jeder Prozess lernt in den ersten Paketen seine üblichen Zielländer, danach warnt er einmalig bei einem neuen. Baselines persistieren (app_baselines).BEACON— bereits geliefert: Regelintervall-Erkennung (CV der Inter-Arrival-Zeiten) auch bei minimalem Traffic.BLOCKED_ATTEMPT,LOCKDOWN,THREAT_HIT— neue Alarmtypen aus den Modulen oben.
Security-Audit
GET /security/audit berechnet einen Score 0–100 aus den letzten 500
Alarmen und dem Live-Graphen: Zählungen pro Typ, Kontakte in
Risikoländer, unaufgelöste Hosts, Firewall-Haltung — plus Empfehlungen
in Klartext. Ein Befundbericht, keine Zertifizierung.
Neu in v1.2 / Nouveautés v1.2
- Aktion
sinkhole—domain-/ip-Regeln können auf Loopback umleiten statt blockieren: Domains über einen markierten# snitch-sinkhole-Block in der hosts-Datei (alle OS), IPs/CIDRs über iptables-DNAT(nur Linux).sinkholebeiprocess/portwird abgelehnt; nicht unterstützte Plattformen → ehrlichesapplied=False. - Domain-Re-Auflösung —
domain-Regeln werden alle ~10 Min neu aufgelöst; das IP-Delta wird je OS angewendet, damit CDN-Rotation einen Namen nicht stillschweigend freigibt. - Integritätswache (standardmäßig an, schreibgeschützt, lokal) — SHA-256-Baselines vernetzter Executables (
BINARY_CHANGED), Name/Exe-Mismatches (NAME_MISMATCH),rwxp-Scan nur Linux (MEM_RWX, Info-Stufe für bekannte JIT-Apps).GET /security/integrity,POST /security/integrity/check. - Alert-Erklärungen —
GET /security/explain?type=Xliefert handgeschriebene zweisprachige (EN/FR) Erklärungen; deterministisch und offline — kein Modell. Die UI zeigt sie hinter der „Warum?“-Schaltfläche.
Optionale Sonden (v1.3)
Alle sind standardmäßig aus oder selbstlimitierend, degradieren ehrlich und senden nie Daten von der Maschine:
- eBPF-Connect-Sonde (Linux,
ebpf_probe) — BCC-tcpconnect-Kprobe ordnetconnect()zu kurzlebiger Prozesse zu. Brauchtpython3-bcc+ root; mehrdeutige Ziele werden nie geraten.GET /security/ebpf. - Frida-Inspektion —
POST /security/deep_inspect {pid,seconds}hängt ≤60 s an EINEN pid und meldet, welches geladene Modul jedesconnect()auslöste. Staging-Pfade →INJECT_SUSPECT. - Sinkhole-Responder — bei aktiver
sinkhole-Regel verwandeln Loopback-Listener auf :80/:443 jeden Versuch in einenSINKHOLE_HIT-Alarm mit Host/URI oder SNI + Prozess. - Modul-Integrität — Merkle-Wurzel über ausführbare Mappings →
MODULE_CHANGED; Pfade unter/tmp/memfd →MODULE_SUSPECT. - Mining-Erkennung — Stratum-JSON im Payload-Kopf →
MINING_STRATUM; Pool-Ports + anhaltende CPU →MINING_SUSPECT. - Hardware-Zähler —
POST /security/perfsampelt Zyklen/Instruktionen viaperf_event_open(Linux). - Lokales LLM — opt-in (
slm_enabled):/security/explainruft einen Ollama-Endpunkt nur Loopback — Remote-Endpunkte abgelehnt. - IOC-Pakete —
GET /security/iocpackexportiert Bloom + randomized response (nie Klartext);POST /security/iocpack/importprüft Ziele probabilistisch.
Policy- & Reaktions-Neuerungen (v1.4)
- Benannte Profile —
POST /firewall/profile:permissive(sauberer Tisch),balanced(vorsichtige Egress-Basis) oderstrict(Basis + Lockdown); werden mit Dedup in gewöhnliche Regeln ausgerollt. - Eigene Alarmregeln —
GET/POST/DELETE /alerts/rules: Feld + Operator + Wert →CUSTOM_RULE-Alarme (nur Alarm, nie Blockierung). - Blocklisten-Import —
POST /firewall/blocklist: lokale Datei (rein lokal) oder opt-in URL (HTTPS-Fetch ≤4 MiB, alsremote_fetchmarkiert) →domain-Regeln, dedupliziert, Limit 500–5000. - PCAP-Export —
GET /forensics/pcap(Filterip/process): ~4-MiB-Ringpuffer als Wireshark-.pcap. - Fernkopplung —
POST /remote/pairingpersistiertlan_bindfür den nächsten Start; Token bleibt Pflicht.GET /remote/pairingmeldet Bind + LAN-IPs. - Sandbox ohne Netzwerk —
POST /security/sandboxführt Binärdateien mit null Egress aus (unshare -nLinux,sandbox-execmacOS;contrib/snitch-containmanuell). - Eingebettetes Modell —
slm_mode=embeddedlädt ein Nutzer-.ggufviallama-cpp-python— null Netzwerk. - Native Skelette —
contrib/wfp-callout/(WFP-Callout in C + Signierung) undcontrib/macos-filter/(NEFilterDataProviderSwift + Entitlements): Forschungs-Scaffolding, nicht ausgeliefert. - ASN — mit
GeoLite2-ASN.mmdb/dbip-asn-lite.mmdbtragen Knotenasnnebenorg.
v1.5 — Passive Inspektion, Kernel-Verdicts & Flotten-Sync
- Passive TLS-Zertifikatsinspektion — begrenzte TCP-Reassembly (≤16 KiB/Flow, 30 s TTL) liest die
Certificate-Nachricht: Issuer/Subject CN+O, Self-Signed, SANs, Validität,san_mismatch→TLS_CERT. TLS 1.3 bleibt opak — ehrlich unbeobachtbar statt geraten. - High-Entropy-Wache — Payloads ≥48 B auf Nicht-TLS-Kanälen mit ≥4,7 Bit/Byte →
HIGH_ENTROPY; 10-Min-Cooldown pro Host. - ICMP-Tunnel-Heuristik — Echo-Typen mit ≥24 B Payload, ≥3× in 5 Min →
ICMP_TUNNEL. - ML-Flow-Anomalie — Isolation Forest pur Python (64 Bäume, null Deps) über eigene Flow-Summaries; inert <384 Flows,
ML_ANOMALYab 0,62. Baseline-Abweichung, kein Malware-Klassifikator. - Ask-on-Connect (Linux, opt-in) —
ask_enabled+ root + iptables: neue Ausgangsflüsse werden auf NFQUEUE 7 gehalten bisPOST /security/ask/verdict— der NFQUEUE-Client ist reines Python (detection/nfqueue.py, AF_NETLINK), keinpython-netfilterqueuenötig; Timeout 15 s, fail-closed (ask_failopen=1umgekehrt). Windows/macOS brauchen die signierten Callout-/NetworkExtension-Skelette auscontrib/. - eBPF-Cgroup-Enforcement (Linux, opt-in) —
POST /security/ebpf/isolate {pid}+/security/ebpf/block {ip}: Programm an den snitch-Cgroup attachiert — Kernel-Drops gelten NUR für isolierte Prozesse. - Hollowing-Check (Linux) —
POST /security/hollow {pid}diff't ausführbare file-backed Seiten aus/proc/<pid>/memgegen Disk. - IOC-Peer-Sync (opt-in) —
gossip_peers≤32 +gossip_enabled: Merkle-Proof-Pakete alle 5 Min per authentifiziertem HTTP(S) — kein Discovery, kein ZK-Protokoll. - Syslog (opt-in) —
syslog_addr(host:portUDP odertcp://) → RFC 3164local4. - Firejail-Containment —
firejail --net=nonebevorzugt,unshareals Fallback. - nftables-Backend — eigene
inet snitch-Tabelle statt iptables, wonftexistiert. - Actionable Alerts — strukturierte
actions(Block IP, Kill/Suspend, Ask-Verdict) als Ein-Klick-Buttons. asn/countryin Custom Rules — lokale Geo-DB, kombinierbar mitaction=blockals Geo-Fence.- DGA-Heuristik — aufgelöste DNS-Namen und TLS-SNIs werden lexikalisch
bewertet (Entropie, Vokale, Konsonantenläufe, Ziffern) →
DGA_SUSPECT. Reine lokale Heuristik; kein WHOIS, kein Domain-Alter. - Getarntes Protokoll — der ≤64-Byte-Payload-Head muss zum Port passen
(HTTP/80, DNS/53, SSH/22, TLS/443+853, Mail-ASCII) →
PROTO_MISMATCH, Cooldown pro Flow. - Volumen-Kill-Switch (opt-in) —
kill_switch_enabledverwandelt einenUPLOAD_SPIKEin eine echte Firewall-Blockade der Remote-IP (dedupliziert, best-effort). Standardmäßig aus.