Die Signatur eines Webhooks prüfen

2 Schritte·ca. 10 Min.·Stand: September 2026

Für Ihren eigenen Server. Vendority signiert jede Anfrage, Ihr Server rechnet die Signatur nach und verwirft alles, was nicht passt.

ab Professional Teil des Plugins „Webhooks“. Ein Plugin installieren · Tarife vergleichen

Schritt 1 von 2

Schritt 1 von 2

The webhook detail panel with the target address and the truncated „Signaturschlüssel“ next to a copy button.

Signaturschlüssel kopieren

Jeder Webhook hat seinen eigenen Signaturschlüssel.

  1. 1

    Öffnen Sie Einstellungen → „Webhooks“ und klicken Sie auf den Webhook.

  2. 2

    Klicken Sie unter „Sicherheit“ bei „Signaturschlüssel“ auf „Anzeigen“.

  3. 3

    Klicken Sie auf „Schlüssel kopieren“. Der Schlüssel beginnt mit whsec_.

  4. 4

    Hinterlegen Sie ihn auf Ihrem Server, etwa als Umgebungsvariable.

Schritt 2 von 2

A PHP file comparing the HMAC signature header against the request body and rejecting old requests.

Signatur auf dem Server prüfen

Ihr Server berechnet mit dem Schlüssel dieselbe Signatur und vergleicht sie mit der mitgeschickten.

  1. 1

    Lesen Sie den Body der Anfrage unverändert ein, bevor Sie ihn als JSON auswerten.

  2. 2

    Lesen Sie die Header X-Vendority-Timestamp und X-Vendority-Signature aus.

  3. 3

    Berechnen Sie die Signatur aus Zeitstempel, Punkt und Body, in PHP etwa so: $expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $body, $secret);

  4. 4

    Die Anfrage ist echt, wenn Ihr Ergebnis mit einem der Werte in X-Vendority-Signature übereinstimmt. Mehrere Werte sind durch Leerzeichen getrennt.

  5. 5

    Verwerfen Sie Anfragen, deren Zeitstempel älter als fünf Minuten ist. So kann niemand eine mitgeschnittene Anfrage erneut abspielen.

  6. 6

    Antworten Sie innerhalb von 10 Sekunden mit einem Statuscode zwischen 200 und 299. Alles andere wertet Vendority als abgelehnt.

Geschafft.

Sie haben „Die Signatur eines Webhooks prüfen“ von Anfang bis Ende durchgearbeitet.

Zurück zu „Webhooks“

Blättern auch mit ← und →