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.
- Nuovo riscontro
- Notifica firmata
- Teams, Slack, SIEM
- Il team reagisce
Eventi e contenuto
| Evento | Attivazione | Campi (formato JSON) |
|---|---|---|
findings.new | riscontri nuovi o riaperti dalla gravità scelta (critica, alta, media); rischi accettati esclusi | domain, findings[] con id, severity, category, check, title, asset, url |
dns.changed | modifica di NS, MX, SPF, DMARC, CAA o indirizzi di un proprio dominio | domain, changes[] con kind, field, from, to |
subdomain.new | sottodominio trovato di recente | domain, subdomains[] con name, source |
watch.changed | modifica di un dominio osservato | changes[] con domain, kind, from, to |
test | pulsante «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
webhookesent_ato 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"