Webhooks : messages directement dans Teams, Slack ou le SIEM
Au lieu de lire des e-mails, les nouveaux constats et modifications apparaissent là où votre équipe travaille déjà – dans le canal, le système de tickets ou le SIEM.
- Nouveau constat
- Notification signée
- Teams, Slack, SIEM
- L’équipe réagit
Événements et contenu
| Événement | Déclencheur | Champs (format JSON) |
|---|---|---|
findings.new | constats nouveaux ou rouverts à partir de la gravité choisie (critique, élevée, moyenne) ; risques acceptés exclus | domain, findings[] avec id, severity, category, check, title, asset, url |
dns.changed | modification de NS, MX, SPF, DMARC, CAA ou des adresses d’un propre domaine | domain, changes[] avec kind, field, from, to |
subdomain.new | sous-domaine nouvellement trouvé | domain, subdomains[] avec name, source |
watch.changed | modification d’un domaine surveillé | changes[] avec domain, kind, from, to |
test | bouton « Envoyer un test » | cadre uniquement |
Chaque message JSON contient en plus v (version 1), event, webhook (identifiant), sent_at (UTC, ISO 8601) et summary. En-têtes : X-EAM-Event, X-EAM-Timestamp, X-EAM-Signature, User-Agent: eam.ch-webhook/1. Teams reçoit une Adaptive Card (version 1.4), Slack un texte avec liens (text).
Signature
X-EAM-Signature = "sha256=" + HMAC-SHA256(secret, X-EAM-Timestamp + "." + contenu). Vérifiez avec une comparaison à temps constant et rejetez les messages de plus de 5 minutes (protection contre la rejoue). Le calcul porte sur le contenu non modifié, tel qu’il arrive. Le secret est affiché une fois à la création et stocké chiffré chez eam.ch.
Distribution
- File d’attente traitée par l’exécution régulière en arrière-plan ; délai de 10 secondes, succès en cas de HTTP 2xx.
- Nouvel essai après 5, 15, 60 et 240 minutes (5 tentatives au maximum) ; après 10 échecs consécutifs, le webhook est désactivé et les utilisateurs principaux sont informés par e-mail.
- Un même message peut arriver plusieurs fois (livré au moins une fois) : reconnaissez les doublons via
webhooketsent_atou le contenu.
Protection contre les abus (SSRF)
Uniquement https sur le port 443 ; le nom doit être résolu publiquement – les adresses privées, locales et réservées (RFC 1918, loopback, link-local, carrier-grade NAT 100.64/10) ; il faut indiquer un nom d’hôte plutôt qu’une adresse IP sont bloquées. La connexion est fixée sur l’adresse vérifiée (pas de seconde résolution, protection contre le DNS rebinding), les redirections ne sont pas suivies, la réponse est limitée à 64 Ko.
Référence : norme minimale TIC DE.CM et RS.CO, ISO/IEC 27001:2022 A 5.24–5.26 (gestion des incidents de sécurité), NIS2 art. 21, par. 2, let. b.
En bref
- Les webhooks signalent immédiatement nouveaux constats et modifications à Teams, Slack ou à vos systèmes.
- Les messages ne contiennent pas de données personnelles ; les messages JSON sont signés.
- L’adresse d’un webhook doit rester secrète comme un mot de passe.
- Configuration sous Compte → Webhooks, puis « Envoyer un test ».
Vérifier soi-même
Commandes de vérification sous Linux ou macOS. Remplacez ihre-domain.ch par votre domaine et ne vérifiez que vos propres systèmes.
printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$GEHEIMNIS"