Ein Webhook-Secret erstellen oder ersetzen
Ein Webhook wird auf einem Formular erstellt, nimmt aber nichts an, bis er ein Secret hat. Du erzeugst das Secret im Panel des Webhooks, kopierst es in das aufrufende System und ersetzt es, wenn es durchsickert oder das andere System es verliert. Das Secret wird einmal gezeigt und lässt sich nicht erneut auslesen.
Bevor du beginnst
Abschnitt betitelt „Bevor du beginnst“- Du bist Admin oder Owner.
- Der Webhook existiert. Falls nicht, öffne das Formular in Forms, wähle Settings in der Leiste und dann Add Webhook.
- Du hast einen sicheren Ort, um das Secret einzufügen, etwa den Zugangsdaten-Speicher des aufrufenden Systems.

Schritte
Abschnitt betitelt „Schritte“-
Öffne in Pyn Settings in der linken Navigation, dann Webhooks unter General.
-
Wähle den Webhook. Sein Panel öffnet sich; ohne Secret sagt es „This webhook accepts nothing until it has a secret.“
-
Wähle Create Secret. Das Panel zeigt das Secret mit „Copy this secret now. It is shown once and cannot be retrieved later.“ Lässt sich das Secret nicht erzeugen, zeigt ein Toast Could not create the secret und das Panel bleibt, wie es war.
-
Kopiere es, speichere es im aufrufenden System und wähle dann Done.
-
Kopiere die URL, die unter „Post a JSON body here, with the secret as a bearer token.“ gezeigt wird, und konfiguriere den Aufrufer so, dass er
Authorization: Bearer <secret>mit einem JSON-Body sendet. -
Um später zu rotieren, wähle Replace Secret. Die Bestätigung warnt „The current secret stops working immediately. Anything calling this webhook will need the new one.“ Wähle Replace und kopiere den neuen Wert. Lässt sich das Secret nicht ersetzen, zeigt ein Toast Could not replace the secret und das alte funktioniert weiter.
Was du sehen solltest
Abschnitt betitelt „Was du sehen solltest“Mit einem Secret zeigt das Panel „This webhook already has a secret. Replace it if the old one has been lost.“ Sende eine Test-Payload aus dem anderen System: Der Tab History listet sie innerhalb weniger Sekunden mit ihrem Ergebnis, submitted für eine Payload, die zu einer Einsendung wurde, oder einen Grund-Code wie unknown-subject. Eine Payload mit falschem oder fehlendem Secret wird mit 404 beantwortet und erscheint nicht im Protokoll.