Webhook-Signatur überprüfen
Bilden Sie aus dem Header X-CalcLib-Signature den String t.body, berechnen Sie HMAC-SHA256 mit Ihrem Secret und vergleichen Sie, bevor Sie die Zustellung verarbeiten.
Ein Webhook-Endpunkt, den Sie unter Webhooks hinzufügen, erhält jedes Mal einen signierten POST, wenn jemand Ihre Einbettung verwendet. Jede Zustellung enthält einen X-CalcLib-Signature-Header der Form t=<unix time>,v1=<signature>.
Prüfen, bevor Sie parsen
- Lesen Sie den rohen Request-Body. Wenn Sie das JSON parsen und erneut serialisieren, ändern sich die Bytes, und die Signatur stimmt nie überein.
- Entnehmen Sie
tdem Header und bilden Sie den Stringt.body: den Zeitstempel, einen Punkt, dann den rohen Body. - Berechnen Sie den HMAC-SHA256 dieses Strings mit dem Secret Ihres Endpunkts, als Hex-Wert.
- Vergleichen Sie ihn in konstanter Zeit mit jedem
v1-Wert. Während Sie ein Secret rotieren, kann der Header zweiv1-Werte enthalten; jeder von ihnen kann passen. - Weisen Sie die Zustellung ab, wenn
tmehr als 5 Minuten von Ihrer Systemzeit abweicht.
Zustellungen, die fehlschlagen
Sie werden nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 8 Stunden erneut versucht. Ein Endpunkt, der 20-mal hintereinander fehlschlägt, wird deaktiviert, und wir senden Ihnen eine E-Mail, sofern der Schalter „Produkt“ unter Benachrichtigungen aktiviert ist.