Webhooks: Meldungen direkt in Teams, Slack oder SIEM
Statt E-Mails zu lesen, erscheinen neue Befunde und Änderungen dort, wo Ihr Team ohnehin arbeitet – im Kanal, im Ticketsystem oder im SIEM.
- Neuer Befund
- Signierte Meldung
- Teams, Slack, SIEM
- Team reagiert
Ereignisse und Inhalt
| Ereignis | Auslöser | Felder (Format JSON) |
|---|---|---|
findings.new | neue bzw. wieder geöffnete Befunde ab gewählter Schwere (Kritisch, Hoch, Mittel); akzeptierte Risiken ausgenommen | domain, findings[] mit id, severity, category, check, title, asset, url |
dns.changed | Änderung an NS, MX, SPF, DMARC, CAA oder Adressen einer eigenen Domain | domain, changes[] mit kind, field, from, to |
subdomain.new | neu gefundene Subdomain | domain, subdomains[] mit name, source |
watch.changed | Änderung bei einer beobachteten Domain | changes[] mit domain, kind, from, to |
test | Knopf «Test senden» | nur Rahmen |
Jede JSON-Nachricht enthält zusätzlich v (Version 1), event, webhook (Kennung), sent_at (UTC, ISO 8601) und summary. Kopfzeilen: X-EAM-Event, X-EAM-Timestamp, X-EAM-Signature, User-Agent: eam.ch-webhook/1. Für Teams wird eine Adaptive Card (Version 1.4) gesendet, für Slack ein Text mit Links (text).
Signatur
X-EAM-Signature = "sha256=" + HMAC-SHA256(Geheimnis, X-EAM-Timestamp + "." + Inhalt). Prüfen Sie mit einem zeitkonstanten Vergleich und verwerfen Sie Nachrichten, die älter als 5 Minuten sind (Schutz vor Wiedereinspielung). Gerechnet wird über den unveränderten Inhalt, wie er ankommt. Das Geheimnis wird beim Erstellen einmal angezeigt und bei eam.ch verschlüsselt gespeichert.
Zustellung
- Warteschlange, abgearbeitet durch den regelmässigen Hintergrundlauf; Zeitgrenze 10 Sekunden, Erfolg bei HTTP 2xx.
- Wiederholung nach 5, 15, 60 und 240 Minuten (höchstens 5 Versuche); nach 10 Fehlschlägen in Folge wird der Webhook ausgeschaltet und die Hauptbenutzer werden per E-Mail informiert.
- Gleiche Nachricht kann mehrfach ankommen (mindestens einmal zugestellt): Doppelte anhand von
webhookundsent_atbzw. Inhalt erkennen.
Schutz vor Missbrauch (SSRF)
Nur https auf Port 443; der Name muss öffentlich auflösen – private, lokale und reservierte Adressen (RFC 1918, Loopback, Link-Local, Carrier-Grade-NAT 100.64/10); statt einer IP-Adresse ist ein Hostname anzugeben sind gesperrt. Die Verbindung wird auf die geprüfte Adresse festgelegt (kein zweites Auflösen, Schutz vor DNS-Rebinding), Weiterleitungen werden nicht verfolgt, die Antwort ist auf 64 KB begrenzt.
Bezug: IKT-Minimalstandard DE.CM und RS.CO (Erkennen, Kommunikation), ISO/IEC 27001:2022 A 5.24–5.26 (Umgang mit Sicherheitsvorfällen), NIS2 Art. 21 Abs. 2 lit. b.
Kurz zusammengefasst
- Webhooks melden neue Befunde und Änderungen sofort an Teams, Slack oder eigene Systeme.
- Die Meldungen enthalten keine Personendaten; JSON-Nachrichten sind signiert.
- Die Adresse eines Webhooks ist geheim zu halten wie ein Passwort.
- Einrichten unter Konto → Webhooks, dann «Test senden».
Selbst prüfen
Befehle zum Nachprüfen auf Linux oder macOS. Ersetzen Sie ihre-domain.ch durch Ihre Domain und prüfen Sie nur eigene Systeme.
# Signatur einer Meldung prüfen: HMAC-SHA256 über Zeitstempel + "." + Inhalt (Geheimnis aus eam.ch)
printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$GEHEIMNIS"