easm.chCapire la superficie d’attacco esterna

Webhook: messaggi direttamente in Teams, Slack o SIEM

Invece di leggere e-mail, nuovi riscontri e modifiche compaiono dove il suo team lavora già – nel canale, nel sistema di ticket o nel SIEM.

2 min di lettura · spiegato in modo semplice e per specialisti

Schema
  1. Nuovo riscontro
  2. Notifica firmata
  3. Teams, Slack, SIEM
  4. Il team reagisce

Eventi e contenuto

EventoAttivazioneCampi (formato JSON)
findings.newriscontri nuovi o riaperti dalla gravità scelta (critica, alta, media); rischi accettati esclusidomain, findings[] con id, severity, category, check, title, asset, url
dns.changedmodifica di NS, MX, SPF, DMARC, CAA o indirizzi di un proprio dominiodomain, changes[] con kind, field, from, to
subdomain.newsottodominio trovato di recentedomain, subdomains[] con name, source
watch.changedmodifica di un dominio osservatochanges[] con domain, kind, from, to
testpulsante «Invia test»solo struttura

Ogni messaggio JSON contiene inoltre v (versione 1), event, webhook (identificativo), sent_at (UTC, ISO 8601) e summary. Intestazioni: X-EAM-Event, X-EAM-Timestamp, X-EAM-Signature, User-Agent: eam.ch-webhook/1. Teams riceve una Adaptive Card (versione 1.4), Slack un testo con link (text).

Firma

X-EAM-Signature = "sha256=" + HMAC-SHA256(segreto, X-EAM-Timestamp + "." + contenuto). Verifichi con un confronto a tempo costante e scarti i messaggi più vecchi di 5 minuti (protezione dalla ripetizione). Il calcolo avviene sul contenuto non modificato, così come arriva. Il segreto viene mostrato una volta alla creazione e salvato cifrato presso eam.ch.

Consegna

  • Coda elaborata dall’esecuzione periodica in background; tempo limite 10 secondi, successo con HTTP 2xx.
  • Nuovo tentativo dopo 5, 15, 60 e 240 minuti (al massimo 5 tentativi); dopo 10 errori consecutivi il webhook viene disattivato e gli utenti principali vengono informati via e-mail.
  • Lo stesso messaggio può arrivare più volte (consegna almeno una volta): riconosca i doppioni tramite webhook e sent_at o il contenuto.

Protezione dagli abusi (SSRF)

Solo https sulla porta 443; il nome deve essere risolvibile pubblicamente – indirizzi privati, locali e riservati (RFC 1918, loopback, link-local, carrier-grade NAT 100.64/10); al posto di un indirizzo IP va indicato un nome host sono bloccati. La connessione è fissata sull’indirizzo verificato (nessuna seconda risoluzione, protezione da DNS rebinding), i reindirizzamenti non vengono seguiti, la risposta è limitata a 64 KB.

Riferimento: standard minimo TIC DE.CM e RS.CO, ISO/IEC 27001:2022 A 5.24–5.26 (gestione degli incidenti di sicurezza), NIS2 art. 21 par. 2 lett. b.

In breve

  • I webhook segnalano subito nuovi riscontri e modifiche a Teams, Slack o sistemi propri.
  • I messaggi non contengono dati personali; i messaggi JSON sono firmati.
  • L’indirizzo di un webhook va tenuto segreto come una password.
  • Configurazione sotto Account → Webhook, poi «Invia test».

Verificare da sé

Comandi per verificare su Linux o macOS. Sostituite ihre-domain.ch con il vostro dominio e verificate solo sistemi propri.

printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$GEHEIMNIS"