Webhook para notificaciones de alerta

Puedes usar webhooks para enviar notificaciones de alerta de Citrix Analytics a cualquier aplicación de terceros que tenga configuradas URL de webhook entrantes. Los webhooks son devoluciones de llamada HTTP que permiten la mensajería en tiempo real entre las aplicaciones del proveedor de servicios y las aplicaciones del consumidor. Dado que las notificaciones de alerta se envían en tiempo real, recibirás una notificación cuando ocurran los eventos.

Cuando Citrix Analytics activa una alerta, el webhook asociado envía el mensaje de alerta a la URL de la aplicación de destino. La alerta se envía en forma de carga útil JSON a través de la solicitud HTTP POST o PUT. Por ejemplo, cuando un usuario activa un indicador de riesgo o el rendimiento de una máquina VDI disminuye, puedes configurar un webhook para enviar las notificaciones de alerta a tu canal de Slack. La configuración de webhooks para la gestión de alertas te ayuda a obtener notificaciones en tiempo real en tus aplicaciones. Puedes tomar medidas oportunas para mitigar el riesgo de seguridad o mejorar el rendimiento de tu implementación de Citrix Virtual Apps and Desktops™.

Crear perfil de webhook

Para crear los perfiles de webhook en Citrix Analytics:

1. Inicia sesión en Citrix Analytics.
2. Según tu oferta de suscripción, haz clic en Administrar para acceder a Security Analytics o Performance Analytics.
3. En la barra superior, haz clic en Configuración > Configuración de alertas > Webhook.

4. Selecciona Crear webhook.

   

5. Introduce un nombre de perfil y una descripción del webhook para identificar su propósito.

6. Selecciona el método HTTP y la URL del webhook de tu aplicación para enviar el mensaje de alerta.

   Nota: Normalmente, los webhooks salientes se envían a través de la solicitud HTTP POST. También puedes incluir un token de autenticación en la URL del webhook de tu aplicación.

7. Introduce el mensaje sobre la alerta que quieres enviar a la URL del webhook. El mensaje debe estar estructurado en formatos como JSON o XML, según lo defina la aplicación de destino. Para obtener más información, consulta los ejemplos de webhook.
8. (Opcional) Introduce las claves y los valores de encabezado para el mensaje. El encabezado puede incluir tokens de autenticación u otros pares clave-valor personalizados para enviar la carga útil de forma segura a tu aplicación.
9. Para validar la configuración del webhook, haz clic en Probar. La prueba valida la URL del webhook saliente, la estructura de la carga útil y las claves de encabezado. Si no se encuentran problemas en tu configuración, recibirás el mensaje “Prueba correcta”.

Ejemplos de configuración de webhook

Esta sección proporciona ejemplos de configuración de webhooks para enviar alertas a aplicaciones de terceros como Slack y Microsoft Teams.

Nota: Consulta la documentación del producto de las aplicaciones de terceros para saber cómo obtener la URL del webhook y las configuraciones necesarias para el webhook.

Envío de mensajes de alerta a Slack

En Slack, asegúrate de haber completado las siguientes tareas antes de enviar una alerta:

1. Crea una aplicación de Slack para Citrix Analytics si aún no tienes una.
2. Para la aplicación, habilita la función de webhook entrante y crea un webhook entrante.
3. Selecciona un canal al que la aplicación publicará el mensaje.
4. Cuando autorices la aplicación, obtendrás la URL del webhook para enviar el mensaje. Para obtener más información, consulta Introducción a los webhooks entrantes.

Formato de mensaje de ejemplo

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

Salida

Envío de mensajes de alerta a Microsoft Teams

En Microsoft Teams, asegúrate de haber completado las siguientes tareas antes de enviar una alerta:

1. Crea un grupo de Teams dentro de Teams si aún no tienes uno.
2. Crea un conector de webhook. Consulta los pasos descritos en el artículo Crear y enviar mensajes.
3. Obtén la URL para el webhook.

Formato de mensaje de ejemplo

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

Salida