Signieren von Webhook-Übermittlungen

Jede ausgehende Webhook-Übermittlung wird mit HMAC-SHA256 signiert. Ein Webhook, der ohne Geheimnis gespeichert wird, erhält ein Geheimnis, das einmal angezeigt wird; ein Webhook ohne Geheimnis wird als „Nicht signiert“ angezeigt – es ist kein Geheimnis festgelegt, und seine Übermittlungen werden erst gesendet, wenn ein Geheimnis festgelegt wurde.

• Plattform › Ereignisse & Webhooks › Webhooks › Neu: Ein Webhook, der ohne Signaturschlüssel gespeichert (oder ohne einen solchen erneut als aktiv gespeichert) wurde, erhält einen starken Signaturschlüssel, der Ihnen einmalig mit einer Kopierfunktion angezeigt wird. Kopieren Sie ihn anschließend an den Empfänger; er wird danach nicht mehr angezeigt.
• Mit dem Befehl „Signaturgeheimnis für Webhook festlegen“ kann das Signaturgeheimnis entweder neu definiert oder ersetzt werden: Geben Sie ein Geheimnis mit mindestens 32 Zeichen ein oder lassen Sie das Feld leer, um ein neues Geheimnis zu generieren, das einmalig angezeigt wird. Kürzere Geheimnisse werden nicht akzeptiert.
• HMAC-SHA256 ist die einzige Signatur, die für ausgehende Webhooks angeboten wird.
• Webhooks und Webhook-Übermittlungen verfügen über eine Spalte „Signatur“. Ein Webhook ohne geheimes Signaturzeichen wird als „Nicht signiert – kein geheimes Signaturzeichen festgelegt“ angezeigt, und jede seiner Übermittlungen schlägt mit der Meldung „Nicht gesendet: Für diesen Webhook ist kein Signaturzeichen festgelegt“ fehl, anstatt unsigniert gesendet zu werden. Legen Sie ein geheimes Signaturzeichen fest (oder speichern Sie den Webhook erneut, während er aktiv ist), dann werden Übermittlungen signiert versendet.

Eine Zustellung, die fehlschlägt, weil der Name des Empfängers nicht aufgelöst werden konnte (DNS-Fehler), wird bis zum Wiederholungslimit des Webhooks wiederholt, ähnlich wie bei einer fehlgeschlagenen Verbindung. Ein Ziel, das die Plattform direkt ablehnt (eine private Adresse oder Metadatenadresse, ein Schema, das sie nicht verwendet), schlägt dennoch beim ersten Versuch fehl.