easm.chWissen zur Angriffsfläche von aussen

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.

1 Min. Lesezeit · einfach erklärt und für Fachleute

Schema
  1. Neuer Befund
  2. Signierte Meldung
  3. Teams, Slack, SIEM
  4. Team reagiert

Ereignisse und Inhalt

EreignisAuslöserFelder (Format JSON)
findings.newneue bzw. wieder geöffnete Befunde ab gewählter Schwere (Kritisch, Hoch, Mittel); akzeptierte Risiken ausgenommendomain, findings[] mit id, severity, category, check, title, asset, url
dns.changedÄnderung an NS, MX, SPF, DMARC, CAA oder Adressen einer eigenen Domaindomain, changes[] mit kind, field, from, to
subdomain.newneu gefundene Subdomaindomain, subdomains[] mit name, source
watch.changedÄnderung bei einer beobachteten Domainchanges[] mit domain, kind, from, to
testKnopf «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 webhook und sent_at bzw. 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"