Signature des livraisons par webhook

Chaque envoi de webhook sortant est signé avec HMAC-SHA256. Un webhook enregistré sans secret en reçoit un, affiché une seule fois ; un webhook sans secret est affiché comme non signé — aucun secret n’est défini et ses envois ne sont pas effectués tant qu’un secret n’est pas défini.

• Plateforme › Événements et webhooks › Webhooks › Nouveau : un webhook enregistré sans clé de signature (ou enregistré à nouveau comme actif sans clé) reçoit une clé forte, affichée une seule fois, avec un bouton de copie. Copiez-la ensuite sur le destinataire ; elle ne sera plus jamais affichée.
• La commande « Définir le secret de signature » sur un webhook permet de le définir ou de le remplacer : saisissez un code d’au moins 32 caractères, ou laissez le champ vide pour en générer un et l’afficher une seule fois. Un code plus court sera refusé.
• HMAC-SHA256 est la seule signature proposée pour les webhooks sortants.
• Les webhooks et leurs envois comportent une colonne « Signature ». Un webhook sans clé secrète apparaît comme « Non signé » (aucune clé secrète définie) et chacun de ses envois échoue avec le message « Non envoyé : aucune clé secrète de signature n'est définie pour ce webhook », au lieu d'être envoyé sans signature. Définissez une clé secrète (ou enregistrez à nouveau le webhook lorsqu'il est actif) pour que les envois soient signés.

Une livraison qui échoue parce que le nom du destinataire est introuvable (erreur DNS) est relancée jusqu'à la limite de tentatives du webhook, comme pour une connexion ayant échoué. Une cible refusée d'emblée par la plateforme (une adresse privée ou de métadonnées, un schéma qu'elle n'utilise pas) échoue également lors de la première tentative.