Webhook pour les notifications d’alerte

Vous pouvez utiliser des webhooks pour envoyer des notifications d’alerte Citrix Analytics à toute application tierce disposant d’URL de webhook entrantes configurées. Les webhooks sont des rappels HTTP qui permettent une messagerie en temps réel entre les applications du fournisseur de services et les applications clientes. Étant donné que les notifications d’alerte sont envoyées en temps réel, vous êtes averti lorsque les événements se produisent.

Lorsqu’une alerte est déclenchée par Citrix Analytics, le webhook associé envoie le message d’alerte à l’URL de l’application cible. L’alerte est envoyée sous la forme d’une charge utile JSON via une requête HTTP POST ou PUT. Par exemple, lorsqu’un utilisateur déclenche un indicateur de risque ou que les performances d’une machine VDI diminuent, vous pouvez configurer un webhook pour envoyer les notifications d’alerte à votre canal Slack. La configuration de webhooks pour la gestion des alertes vous aide à recevoir des notifications en temps réel dans vos applications. Vous pouvez prendre des mesures rapides pour atténuer le risque de sécurité ou améliorer les performances de votre déploiement Citrix Virtual Apps and Desktops™.

Créer un profil de webhook

Pour créer les profils de webhook sur Citrix Analytics :

1. Connectez-vous à Citrix Analytics.
2. Selon votre offre d’abonnement, cliquez sur Gérer pour accéder à Security Analytics ou Performance Analytics.
3. Dans la barre supérieure, cliquez sur Paramètres > Paramètres d’alerte > Webhook.
4. Sélectionnez Créer un webhook.
5. Saisissez un nom de profil et une description du webhook pour identifier son objectif.

6. Sélectionnez la méthode HTTP et l’URL du webhook de votre application pour envoyer le message d’alerte.

   Remarque : Généralement, les webhooks sortants sont envoyés via la requête HTTP POST. Vous pouvez également inclure un jeton d’authentification dans l’URL du webhook de votre application.

7. Saisissez le message d’alerte que vous souhaitez envoyer à l’URL du webhook. Le message doit être structuré dans des formats tels que JSON ou XML, tels que définis par l’application cible. Pour plus d’informations, consultez les exemples de webhook.
8. (Facultatif) Saisissez les clés et les valeurs d’en-tête pour le message. L’en-tête peut inclure des jetons d’authentification ou d’autres paires clé-valeur personnalisées pour envoyer la charge utile en toute sécurité à votre application.
9. Pour valider la configuration du webhook, cliquez sur Tester. Le test valide l’URL du webhook sortant, la structure de la charge utile et les clés d’en-tête. Si aucun problème n’est détecté dans votre configuration, vous recevez le message « Test réussi ».

Exemples de configuration de webhook

Cette section fournit des exemples de configuration de webhooks pour envoyer des alertes à des applications tierces telles que Slack et Microsoft Teams.

Remarque : Reportez-vous à la documentation produit des applications tierces pour savoir comment obtenir l’URL du webhook et les configurations requises pour le webhook.

Envoi d’un message d’alerte à Slack

Sur Slack, assurez-vous d’avoir effectué les tâches suivantes avant d’envoyer une alerte :

1. Créez une application Slack pour Citrix Analytics si vous n’en avez pas déjà une.
2. Pour l’application, activez la fonctionnalité Webhook entrant et créez un webhook entrant.
3. Sélectionnez un canal vers lequel l’application publie le message.
4. Lorsque vous autorisez l’application, vous obtenez l’URL du webhook pour l’envoi du message. Pour plus d’informations, consultez Démarrer avec les webhooks entrants.

Format de message d’exemple

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

Sortie

Envoi d’un message d’alerte à Microsoft Teams

Sur Microsoft Teams, assurez-vous d’avoir effectué les tâches suivantes avant d’envoyer une alerte :

1. Créez un groupe Teams au sein de Teams si vous n’en avez pas déjà un.
2. Créez un connecteur de webhook. Reportez-vous aux étapes décrites dans l’article Créer et envoyer des messages.
3. Obtenez l’URL du webhook.

Format de message d’exemple

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

Sortie