Webhook für Alert-Benachrichtigungen

Sie können Webhooks verwenden, um Citrix Analytics-Warnbenachrichtigungen an alle Anwendungen von Drittanbietern zu senden, für die eingehende Webhook-URLs konfiguriert sind. Webhooks sind HTTP-Callbacks, die Echtzeitnachrichten zwischen den Dienstanbieteranwendungen und Verbraucheranwendungen ermöglichen. Da die Warnmeldungen in Echtzeit gesendet werden, werden Sie benachrichtigt, wenn die Ereignisse eintreten.

Wenn Citrix Analytics eine Warnung auslöst, sendet der zugehörige Webhook die Warnmeldung an die URL der Zielanwendung. Die Warnung wird in Form einer JSON-Nutzlast über die HTTP POST- oder PUT-Anforderung gesendet. Wenn ein Benutzer beispielsweise einen Risikoindikator auslöst oder die Leistung einer VDI-Maschine sinkt, können Sie einen Webhook einrichten, um die Warnbenachrichtigungen an Ihren Slack-Kanal zu senden. Durch das Einrichten von Webhooks für das Alert-Management können Sie Benachrichtigungen in Echtzeit in Ihren Anwendungen erhalten. Sie können rechtzeitig Maßnahmen ergreifen, um das Sicherheitsrisiko zu verringern oder die Leistung Ihrer Citrix Virtual Apps and Desktops-Bereitstellung zu verbessern.

Webhook-Profil erstellen

So erstellen Sie die Webhook-Profile in Citrix Analytics:

  1. Melden Sie sich bei Citrix Analytics an.
  2. Klicken Sie je nach abonniertem Angebot auf Verwalten, um auf Security Analytics oder Performance Analytics zuzugreifen.
  3. Klicken Sie in der oberen Leiste auf Einstellungen > Warnungseinstellungen > Webhook.
  4. Wählen Sie Webhook erstellen aus. Webhook-Profil erstellen
  5. Geben Sie einen Profilnamen und eine Beschreibung des Webhooks ein, um seinen Zweck zu identifizieren.
  6. Wählen Sie die HTTP-Methode und die Webhook-URL Ihrer Anwendung aus, um die Warnmeldung zu senden.

    Hinweis: Normalerweise werden die ausgehenden Webhooks über die HTTP POST-Anforderung gesendet. Sie können auch ein Authentifizierungstoken in die Webhook-URL Ihrer Anwendung aufnehmen.

  7. Geben Sie die Nachricht über die Warnung ein, die Sie an die Webhook-URL senden möchten. Die Nachricht muss in den von der Zielanwendung definierten Formaten wie JSON oder XML strukturiert sein. Weitere Informationen finden Sie in den Webhook-Beispielen.
  8. (Optional) Geben Sie die Header-Schlüssel und -Werte für die Nachricht ein. Der Header kann Authentifizierungstoken oder andere benutzerdefinierte Schlüssel-Wert-Paare enthalten, um die Nutzlast sicher an Ihre Anwendung zu senden.
  9. Um die Webhook-Konfiguration zu überprüfen, klicken Sie auf Test. Der Test validiert die ausgehende Webhook-URL, die Payload-Struktur und die Header-Schlüssel. Wenn in Ihrer Konfiguration keine Probleme gefunden werden, erhalten Sie die Meldung “Test erfolgreich”.

Beispiele für Webhook-Konfigurationen

Der Abschnitt enthält Beispiele für die Konfiguration von Webhooks, um Warnungen an Anwendungen von Drittanbietern wie Slack und Microsoft Teams zu senden.

Hinweis: Informationen zum Abrufen der Webhook-URL und der erforderlichen Konfigurationen für den Webhook finden Sie in der Produktdokumentation der Drittanbieteranwendungen.

Warnmeldung an Slack senden

Stelle sicher, dass du in Slack die folgenden Aufgaben erledigt hast, bevor du eine Benachrichtigung sendest:

  1. Erstellen Sie eine Slack-App für Citrix Analytics, falls Sie noch keine haben.
  2. Aktivieren Sie für die App die Funktion Eingehender Webhook und erstellen Sie einen eingehenden Webhook.
  3. Wählen Sie einen Kanal aus, in dem die App die Nachricht veröffentlicht.
  4. Wenn Sie die App autorisieren, erhalten Sie die Webhook-URL zum Senden der Nachricht. Weitere Informationen finden Sie unter Erste Schritte mit eingehenden Webhooks.

Beispiel für ein Nachrichtenformat

curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}

Ausgabe

Beispiel für eine Warnmeldung in Slack

Warnmeldung an Microsoft Teams senden

Stellen Sie in Microsoft Teams sicher, dass Sie die folgenden Aufgaben ausgeführt haben, bevor Sie eine Warnung senden:

  1. Erstellen Sie eine Teams-Gruppe innerhalb von Teams, falls Sie noch keine haben.
  2. Erstellen Sie einen Webhook-Connector. Weitere Informationen finden Sie in den Schritten, die im Artikel Erstellen und Senden von Nachrichten beschrieben werden.
  3. Holen Sie sich die URL für den Webhook.

Beispiel für ein Nachrichtenformat

curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}

Ausgabe

Beispiel für eine Warnmeldung in Teams

Webhook für Alert-Benachrichtigungen