Hilfe PhishTrainer Meldungen
PhishTrainer-Daten per Webhook an Ihre Werkzeuge senden
Auf dieser Seite
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.
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:
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.
hash_equals in PHP, hmac.compare_digest in Python) und schreiben Sie das Secret nie in ein Protokoll.Fehlerbehebung
| Meldung oder Symptom | Was tun |
|---|---|
| Webhook: keine Daten empfangen | Prü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. |
Keine Antwort gefunden? Kontakt aufnehmen