easm.chComprendre votre surface d’attaque externe

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.

2 min de lecture · en termes simples et pour les spécialistes

Schéma
  1. Nouveau constat
  2. Notification signée
  3. Teams, Slack, SIEM
  4. L’équipe réagit

Événements et contenu

ÉvénementDéclencheurChamps (format JSON)
findings.newconstats nouveaux ou rouverts à partir de la gravité choisie (critique, élevée, moyenne) ; risques acceptés exclusdomain, findings[] avec id, severity, category, check, title, asset, url
dns.changedmodification de NS, MX, SPF, DMARC, CAA ou des adresses d’un propre domainedomain, changes[] avec kind, field, from, to
subdomain.newsous-domaine nouvellement trouvédomain, subdomains[] avec name, source
watch.changedmodification d’un domaine surveilléchanges[] avec domain, kind, from, to
testbouton « 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 webhook et sent_at ou 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"