Zum Inhalt springen
Bexxo Hilfe

Hilfe PhishTrainer Meldungen

PhishTrainer-Daten per Webhook an Ihre Werkzeuge senden

Für Administratoren PhishTrainer Aktualisiert am 13. November 2026

Unter Einstellungen › Webhooks einen Webhook anlegen, um PhishTrainer-Daten an eine andere Anwendung zu senden, und die Signatur der Sendungen prüfen.
Auf dieser Seite
  1. Wozu ein Webhook dient
  2. Webhook anlegen
  3. Format der Sendungen
  4. Signatur prüfen
  5. Fehlerbehebung

Wozu ein Webhook dient

Ein Webhook ist eine Webadresse (URL) Ihrer Anwendung, an die PhishTrainer im Verlauf Ihrer Kampagnen Daten sendet, zum Beispiel für ein SIEM, ein Ticketsystem oder einen Team-Kanal.

Die Seite Webhooks ist PhishTrainer-Administratoren vorbehalten.
Die von Ihren Mitarbeitenden gemeldeten E-Mails empfangenMeldungen empfangen: Postfächer und Melde-SchaltflächenGemeldete E-Mails im Portal klassifizierenVerdächtige E-Mails sichten und klassifizieren

Webhook anlegen

Der Webhook wird unter Einstellungen › Webhooks angelegt, mit einem Namen von mindestens 5 Zeichen. Geben Sie die vollständige Adresse der empfangenden Anwendung mit https:// an, zum Beispiel https://siem.ihre-domain.ch/phishtrainer.

Das Secret ist freiwillig, aber ohne es werden die Sendungen nicht signiert und Ihre Anwendung kann nicht prüfen, ob sie von PhishTrainer stammen. Geben Sie eine lange Zufallszeichenfolge ein, die nur PhishTrainer und Ihre Anwendung kennen.

Nur Webhooks, bei denen Ist aktiv? eingeschaltet ist, erhalten Daten: Prüfen Sie das vor dem Speichern.

Um Sendungen auszusetzen, ohne die Konfiguration zu verlieren, schalten Sie Ist aktiv? aus, statt den Webhook zu löschen: Das Löschen ist endgültig.

Format der Sendungen

Jede Sendung ist eine HTTP-Anfrage POST, deren Inhalt ein JSON-Dokument ist. Ihre Anwendung muss mit einem HTTP-Code unter 400 antworten: Ein Code ab 400 oder keine Antwort innert 10 Sekunden gilt als Fehlschlag. Weiterleitungen werden nicht verfolgt. Gesendete Kopfzeilen:

Kopfzeilen der Anfrage

Signatur prüfen

Ist ein Secret hinterlegt, fügt PhishTrainer die Kopfzeile X-Gophish-Signature hinzu, in der Form sha256= gefolgt von einer hexadezimalen Signatur. Diese Signatur ist der HMAC-SHA256 des unveränderten Anfrageinhalts, berechnet mit dem Secret als Schlüssel. Zur Prüfung berechnet Ihre Anwendung diesen HMAC über den empfangenen Inhalt, vor jeder JSON-Dekodierung, und vergleicht ihn mit dem Wert der Kopfzeile. Weisen Sie jede Anfrage ohne diese Kopfzeile oder mit abweichender Signatur zurück.

Vergleichen Sie Signaturen mit einer Funktion in konstanter Zeit (zum Beispiel hash_equals in PHP, hmac.compare_digest in Python) und schreiben Sie das Secret nie in ein Protokoll.

Fehlerbehebung

Meldung oder SymptomWas tun
Webhook: keine Daten empfangenPrüfen Sie, dass Ist aktiv? eingeschaltet ist, dass die URL aus dem Internet erreichbar ist und dass Ihre Anwendung innert 10 Sekunden mit einem Code unter 400 antwortet, ohne Weiterleitung.
Bleibt eine Sendung unklar? Schreiben Sie an info@bexxo.ch mit dem Namen des Webhooks und dem beobachteten Verhalten.

Keine Antwort gefunden? Kontakt aufnehmen