Ga naar inhoud
PynPyn

Een webhook-secret maken of vervangen

Een webhook wordt op een formulier gemaakt maar neemt niets aan totdat hij een secret heeft. Je maakt het secret aan vanuit het paneel van de webhook, kopieert het naar het aanroepende systeem, en vervangt het als het lekt of het andere systeem het kwijtraakt. Het secret wordt één keer getoond en kan niet worden teruggelezen.

  • Je bent admin of owner.
  • De webhook bestaat. Zo niet, open dan het formulier in Forms, selecteer Settings in de balk en dan Add Webhook.
  • Je hebt een veilige plek om het secret te plakken, zoals de credential store van het aanroepende systeem.
The Webhooks view in Settings, listing the workspace's inbound webhooks.
Settings > General > Webhooks lists every inbound webhook created on a form.
  1. Open in Pyn Settings in de linkernavigatie, dan Webhooks onder General.

  2. Selecteer de webhook. Zijn paneel opent; zonder secret zegt het “This webhook accepts nothing until it has a secret.”

  3. Selecteer Create Secret. Het paneel toont het secret met “Copy this secret now. It is shown once and cannot be retrieved later.” Kan het secret niet worden aangemaakt, dan meldt een toast Could not create the secret en blijft het paneel zoals het was.

  4. Kopieer het, bewaar het in het aanroepende systeem, en selecteer dan Done.

  5. Kopieer de URL onder “Post a JSON body here, with the secret as a bearer token.” en stel de aanroeper zo in dat die Authorization: Bearer <secret> met een JSON-body meestuurt.

  6. Wil je later roteren, selecteer dan Replace Secret. De bevestiging waarschuwt “The current secret stops working immediately. Anything calling this webhook will need the new one.” Selecteer Replace en kopieer de nieuwe waarde. Kan het secret niet worden vervangen, dan meldt een toast Could not replace the secret en blijft het oude werken.

Is er een secret, dan leest het paneel “This webhook already has a secret. Replace it if the old one has been lost.” Stuur een testpayload vanuit het andere systeem: het tabblad History toont hem binnen een paar seconden met zijn uitkomst, submitted voor een payload die een inzending werd, of een redencode zoals unknown-subject. Een payload die met een verkeerd of ontbrekend secret is verstuurd krijgt 404 als antwoord en verschijnt niet in het log.

  • Webhooks voor de vorm van de payload en de uitkomstcodes.
  • Forms om de webhook te maken en zijn subject in te stellen.