Eine HTTP Webhook-Integration ist eine gängige Methode zum Verbinden von Onlinekonten, um automatische Nachrichten zu empfangen, wenn ein auslösendes Ereignis eintritt. Mit Dotcom-Monitor können Sie eine Nutzlast mit Warnbenachrichtigungen von Ihrem Dotcom-Monitor-Konto mithilfe einer eindeutigen Webhook-URL an eine andere Anwendung übertragen. Jedes Mal, wenn Dotcom-Monitor einen Überwachungsalarm generiert, sendet das Alarmsystem automatisch eine Warnungsbenachrichtigung an die bereitgestellte Webhook-URL.

Sie können Ihre Anforderungsparameter anpassen, um den spezifischen Inhalt der Warnmeldungen zu definieren. Sie können entweder eine statische Textnachricht senden, eine dynamische Nutzlast basierend auf der Razor-Syntax pushen oder vordefinierte Warnungsvorlagen verwenden. Darüber hinaus können Sie die Razor-Syntax und vordefinierte Vorlagen verwenden, um zusätzliche Informationen zusammen mit HTTP-Headern zu senden und die Authentifizierungsanmeldeinformationen anzupassen.

Konfigurieren der HTTP-Webhook-Benachrichtigungsadresse

Lassen Sie uns den Einrichtungsprozess der HTTP-Webhook-Adresse aufschlüsseln.

Erstellen Sie zunächst einen neuen Webhook in Ihrer Anwendung. Wählen Sie als Nächstes in den Warnungsgruppeneinstellungen Ihres Dotcom-Monitor-Kontos den HTTP-Webhook-Adresstyp aus. Geben Sie in den Adresseinstellungen die Webhook-URL an, und wählen Sie die HTTP-Methode aus, die das System verwenden soll, um eine Nutzlast mit einer Warnmeldung an die Webhook-URL zu übertragen.

Authentifizierung

Wenn Ihr Empfängerserver die Authentifizierung aller eingehenden Anforderungen erfordert, können Sie im Abschnitt Authentifizierung Anmeldeinformationen angeben. Die Anmeldeinformationen werden zusammen mit den Anforderungen an die Webhook-URL übergeben.

Die folgenden Arten der Webhook-Authentifizierung sind verfügbar:

  • Automatisch – Der Authentifizierungstyp wird automatisch ausgewählt, abhängig von der Antwort des Empfängerservers.
  • NTLM – ermöglicht die Authentifizierung von Anforderungen an Netzwerke, die das NTLM-Authentifizierungsprotokoll verwenden.
  • Digest – ermöglicht die Authentifizierung von Anforderungen an Webserver, die eine Digestauthentifizierung erfordern.
  • Basic – ermöglicht das Senden von Anmelde- und Kennwortfeldern zusammen mit dem Header der HTTP-Anforderung.

Beachten Sie, dass Dotcom-Monitor die ausgewählte Methode unabhängig von den Anforderungen des Empfängerservers verwendet, sobald eine andere Authentifizierungsmethode als Auto ausgewählt wurde. Bevor Sie eine bestimmte Methode auswählen, stellen Sie sicher, dass Ihr Webserver diese unterstützt.

Beachten Sie, dass Sie dynamische Anmeldeinformationen sowie ein statisches Login-Passwort-Paar übergeben können. Um Ihre Anmeldeinformationen für die Authentifizierung anzupassen, klicken Sie auf das Dropdown-Menüsymbol am Anfang des entsprechenden Eingabefelds und wählen Sie den Inhaltstyp aus, den Sie hinzufügen möchten. Weitere Informationen zum Konfigurieren benutzerdefinierter Authentifizierungsparameter finden Sie im Abschnitt Festlegen von HTTP-Webhook-Anforderungsparametern in diesem Artikel.

Header

Um benutzerdefinierte Header zusammen mit der Anforderung zu senden, erweitern Sie den Abschnitt Header, klicken Sie auf Hinzufügen und geben Sie einen neuen Header-Parameter an.

Wenn Sie benutzerdefinierte Informationen in der Kopfzeile übergeben müssen, z. B. Serverzeit benachrichtigen, klicken Sie auf das Dropdown-Menüsymbol am Anfang des Parameterwertfelds, und wählen Sie den Inhaltstyp aus, den Sie hinzufügen möchten.

Post-Daten

Um eine Benachrichtigung zu erstellen, wählen Sie den Datentyp des Anforderungstextinhalts aus:

  • Keine – Wählen Sie diese Option, um Anfragen ohne Nutzlast im Text zu senden.
  • Formulardaten: Wählen Sie diese Option aus, um eine Benachrichtigung als statische Name-Wert-Auflistung zu senden.
  • Formular-URL-codiert: Wählen Sie diese Option aus, um URL-codierte Nachrichten innerhalb eines HTTP-Anforderungstexts zu senden.
  • Raw – Wählen Sie, ob eine Nachricht im HTTP-Anforderungstext als “rohe” Daten (JSON, XML, HTML, TXT) gesendet werden soll. Fahren Sie mit dem Inhaltstyp fort.

Standardmäßig verwenden wir die folgenden Content-Type-Headerwerte:

Formular-URL codiert: application/x-www-form-urlencoded
Formulardaten: mehrteilige/Formulardaten; Grenze={Dynamically-Generated-Boundary}

Roh:

HTML: text/html
Json: Anwendung / JSON
Text: Text/plain
XML: application/xml

Wenn Sie Ihre Benachrichtigung mit einem benutzerdefinierten Inhaltstypheader senden müssen, geben Sie ihn im Abschnitt Header der Webhook-Adresseinstellungen an.

Um den Inhalt der Nachricht anzupassen, klicken Sie auf das Dropdown-Menüsymbol am Anfang des Eingabefelds für den Anforderungstext, wählen Sie den Datentyp aus, den Sie im Textkörper senden möchten, und fügen Sie den Nachrichteninhalt hinzu, der per Push an die Zielwebanwendung übertragen wird.

Anpassen von HTTP-Webhook-Anforderungsparametern

Dotcom-Monitor bietet Benutzern eine Vielzahl von Optionen, um die Anpassung von Benachrichtigungsanforderungen zu unterstützen. Abhängig von Ihren Zielen und Ihren Anforderungen an den Webanwendungsserver können Sie Ihre Benachrichtigungsnachricht und andere Anforderungsparameter flexibel personalisieren, indem Sie einen der angebotenen Datentypen verwenden.

Alert Template

Die Warnungsvorlage kann nicht nur den Inhalt der Warnmeldung, sondern jede Art von Inhalt, den Sie verwenden möchten, in den Parametern mehrerer Webhook-Adressen speichern. Wenn Sie eine neue wiederverwendbare Vorlage erstellen müssen, erstellen Sie bitte eine, wie im Artikel Alert Template: Setup and Configuration (Text & HTML & JSON) dieses Wikis beschrieben.

Um eine vorkonfigurierte Vorlage auszuwählen, klicken Sie auf das Eingabefeld und wählen Sie die Vorlage aus der Liste aus.

Statischer Inhalt

Wenn Sie statische Daten zusammen mit Ihren Anforderungsparametern übergeben müssen, wählen Sie die Option Statisch aus. Sie können den Inhalt in das Eingabefeld eingeben.

Dynamische Inhalte

Warnmeldungen und andere Anforderungsparameterwerte können mithilfe dynamischer Variablen personalisiert werden. Dotcom-Monitor übergibt die aktuellen Systemwerte an die zugehörigen Variablen beim Senden einer Alert-Benachrichtigung. Dynamische Dotcom-Monitor-Vorlagen werden mit der Razor-Parsing-Engine von Microsoft implementiert und können aus dem Nachrichteneingabefeld heraus erstellt werden. Im Knowledge Base-Artikel Hinzufügen dynamischer Variablen zur Warnungsvorlage erfahren Sie, wie Sie mit dynamischen Variablen arbeiten.

Wenn Sie zuvor erstellte Warnungsvorlagen nutzen oder unsere vordefinierten HTML-Snippets verwenden möchten, erweitern Sie das Nachrichteneingabefeld und verwenden Sie den Nachrichteneditor, wie im Artikel Alert Template: Setup and Configuration (Text & HTML & JSON) unserer Knowledge Base beschrieben.