Vérifier la signature d'un webhook
Construisez la chaîne t.body à partir de l'en-tête X-CalcLib-Signature, calculez le HMAC-SHA256 avec votre secret, puis comparez avant de traiter la livraison.
Un point de terminaison webhook ajouté dans Webhooks reçoit une requête POST signée chaque fois que quelqu'un utilise votre intégration. Chaque livraison comporte un en-tête X-CalcLib-Signature de la forme t=<unix time>,v1=<signature>.
Vérifier avant d'analyser
- Lisez le corps brut de la requête. Analyser puis resérialiser le JSON modifie les octets, et la signature ne correspondra jamais.
- Prenez
tdans l'en-tête et construisez la chaînet.body: l'horodatage, un point, puis le corps brut. - Calculez le HMAC-SHA256 de cette chaîne avec le secret de votre point de terminaison, en hexadécimal.
- Comparez-le à chaque valeur
v1en temps constant. Pendant le renouvellement d'un secret, l'en-tête peut contenir deux valeursv1: l'une ou l'autre peut correspondre. - Rejetez la livraison si
ts'écarte de plus de 5 minutes de votre horloge.
Livraisons en échec
Elles sont renvoyées après 1 minute, 5 minutes, 30 minutes, 2 heures et 8 heures. Un point de terminaison qui échoue 20 fois de suite est désactivé et nous vous envoyons un e-mail, selon le réglage produit de Notifications.