Webhook-Trigger

Ein Webhook stellt eine eindeutige HTTPS-URL pro Workflow (oder Umgebung) bereit. Ein gültiger POST erstellt einen Lauf mit dem Anforderungstext im Trigger-Kontext.

⚡ URL und Methode

Nach der Aktivierung zeigt Knot:

die vollständige URL (von der Benutzeroberfläche kopieren; nicht erraten);
erwartete Methode (POST in den meisten Fällen);
Körperformat (JSON empfohlen).

Beispiel für eine Partnernutzlast:

{
  "event": "order.paid",
  "order_id": "ORD-2026-0042"
}

Greifen Sie über „{{ trigger.body.order_id }}“ auf Felder zu (genaue Namen werden im Simulieren-Inspektor angezeigt).

⚡ HMAC-Signatur

Um die Identität des Anrufers nachzuweisen:

Knot bietet ein Geheimnis (auf der Absenderseite gespeichert).
Der Absender berechnet „HMAC-SHA256“ des Rohkörpers mit diesem Geheimnis.
Es sendet den Digest in einem Header („X-Knot-Signatur“ oder in Ihrer Version dokumentierter Name).

Knot lehnt Anfragen ohne gültige Signatur ab – typischerweise 401/403.

⚡ Härten

Measure	Why
HTTPS only	Payload confidentiality
Strong secret	Anti-spoofing
Rate limiting	Abuse protection (version / reverse proxy)
Optional IP allowlist	Fixed partner only

Testen Sie mit „curl“ von einem autorisierten Host, bevor Sie das SaaS-Tool verbinden.

⚡ vs. HTTP-Connector

Webhook (diese Seite) = eingehend an Knot (Trigger).
HTTP-Connector = ausgehend von Knot an eine externe API.