Auf der Unterregisterkarte Webhook in den PhishER-Einstellungen können Sie Webhooks erstellen und mit Ihrer PhishER-Plattform oder mit anderen von Ihnen verwendeten Plattformen verbinden. Über einen Webhook (auch als HTTP-Push-API bezeichnet) können Anwendungen anderen Anwendungen Informationen in Echtzeit zur Verfügung stellen. Wenn Nachrichten durch bestimmte PhishER-Aktionen ausgelöst werden, können Sie mithilfe von Webhooks Daten aus den Nachrichten an eine andere Anwendung senden.

Nach der Integration von Webhooks in Ihre PhishER-Plattform können Sie eine PhishER-Aktion erstellen und die Option Send to Webhook auswählen. Diese Option ermöglicht es PhishER, die gemeldeten Nachrichten, die von dieser Aktion betroffen sind, an den Webhook Ihrer Organisation zu senden. Nachdem die Aktion ausgelöst wurde, können Sie in Ihrer PhishER Inbox auf die zugehörige Nachricht klicken und anzeigen, an welchen Webhook die Nachricht gesendet wird.

Erstellen eines neuen Webhooks

Gehen Sie wie folgt vor, um einen neuen Webhook mit Ihrer PhishER-Plattform zu verbinden:

1. Melden Sie sich bei der PhishER-Plattform an.
2. Navigieren Sie zu Settings > Webhook.
3. Klicken Sie oben rechts auf der Seite auf die Schaltfläche New Webhook, um das Pop-up-Fenster Add Webhook Settings zu öffnen.
4. Konfigurieren Sie im daraufhin angezeigten Pop-up-Fenster Add Webhook Settings Ihre Webhook-Servereinstellungen. Weitere Informationen zu diesen Einstellungen finden Sie im Screenshot und in der folgenden Liste:
   1. Name: Geben Sie in diesem Feld einen benutzerdefinierten Namen für Ihren Webhook ein.
   2. URL: Geben Sie in diesem Feld die URL für die Rückruffunktion ein. Eine Liste aller mit PhishER kompatiblen URL Rewriter und Shortener finden Sie im Artikel PhishER – FAQ.
   3. Authorization: Wählen Sie im Drop-down-Menü eines der folgenden Protokolle aus: No Auth, API Key, Bearer Token oder Basic Auth.
   4. Available Data: Wählen Sie eine oder mehrere Datentypen aus, die an den Webhook gesendet werden.
      Hinweis: Mit dem Datentyp Addresses werden alle E-Mail-Adressen in den Webhook-Nutzdaten gesendet, auch E-Mail-Adressen in den Feldern From, To, CC, Reply To und Reported By.
   5. Custom Data: Um zu den Nutzdaten Ihres Webhooks benutzerdefinierte Daten hinzuzufügen, klicken Sie auf das Pluszeichen. Füllen Sie dann die Felder key und value aus. Wenn für Ihre Anwendung beispielsweise „{ "System" : "PhishER" }“ in den Nutzdaten erforderlich ist, um Daten empfangen zu können, können Sie „System“ und „PhishER“ eingeben.
   6. Custom Headers: Wenn Sie eine benutzerdefinierte Kopfzeile hinzufügen möchten, klicken Sie auf das Pluszeichen. Füllen Sie dann die Felder key und value aus. Wenn für Ihre Firewall beispielsweise „{ "Header" : "PhishER" }“ in der Kopfzeile erforderlich ist, damit Daten diese passieren, können Sie „Header“ und „PhishER“ eingeben.
   7. Message Tags: Aktivieren Sie in diesem Abschnitt die Kontrollkästchen Success oder Failure, wenn PhishER ein Tag zuweisen soll, sofern Daten über den Webhook gesendet werden. Geben Sie dann im Feld neben dem ausgewählten Kontrollkästchen einen Namen für das Tag ein. 
   
5. Klicken Sie auf Create.

Verwalten von Webhooks

Sie können in den PhishER-Einstellungen auf der Unterregisterkarte Webhook Ihre Webhooks verbinden und verwalten. Um einen Webhook zu aktualisieren, können Sie auf den Namen eines Webhooks klicken, um das Pop-up-Fenster Update Webhook Settings zu öffnen. Anschließend können Sie die Webhook-Einstellungen aktualisieren.

Weitere Informationen zur Unterregisterkarte Webhook finden Sie im Screenshot und in der Liste weiter unten:

1. New Webhook: Mit dieser Schaltfläche können Sie einen Webhook hinzufügen. Weitere Informationen zum Hinzufügen eines neuen Webhooks finden Sie in den vorherigen Unterabschnitten dieses Artikels.
2. Name: Diese Spalte enthält den Namen des Webhooks.
3. URL: Diese Spalte enthält die URL, die der Webhook per Rückruf erreichen soll.
4. Selected Data: Diese Spalte enthält die Datentypen, die Sie an den Webhook senden möchten.
5. Success Tag: Diese Spalte enthält das Tag, das PhishER einer Nachricht zuweist, wenn der Webhook erfolgreich Daten gesendet und eine Rückruf-URL empfangen hat.
6. Failure Tag: Diese Spalte enthält das Tag, das PhishER einer Nachricht zuweist, wenn der Webhook keine Daten senden konnte und keine Rückruf-URL empfangen hat.
7. Actions: Diese Spalte enthält die Aktionen, die für einen Webhook-Eintrag ausgeführt werden können. Klicken Sie auf das Papierkorbsymbol, um den Eintrag zu löschen.