Creando una Integración de Alerta de Webhooks

Este artículo explica cómo crear una integración para tu cuenta de Cato que use Webhooks para alertas y notificaciones del sistema.

Visión general

La Aplicación de Gestión de Cato admite una variedad de alertas y notificaciones para diferentes casos de uso y condiciones relacionadas con tu cuenta. Puedes definir una integración de Webhook para enviar alertas a plataformas de terceros como ServiceNow, Jira y Slack, y crear flujos de automatización basados en alertas. Los Webhooks de Cato admiten encabezados HTTP personalizables y mensajes en la alerta para satisfacer las necesidades específicas de tu organización.

Creando Integraciones de Webhooks

Crea una integración de Webhook para el servicio de tickets relevante. Necesitas proporcionar la URL para el servicio que recibe la alerta a través del Webhook con la información de autenticación relevante. Los siguientes métodos de autenticación están disponibles:

  • Básico - Autenticación básica con Nombre de usuario y Contraseña.

  • Bearer - Autenticación Bearer con Token de Bearer.

  • Personalizado - Algunos servicios usan autenticación personalizada y pueden requerir encabezados de autenticación y autorización personalizados. Para estos servicios, elige Autenticación Personalizada y proporciona la clave y el valor relevantes para cada Encabezado Personalizado.

Tienes la opción de configurar encabezados HTTP personalizados para el Webhook. Puedes usar el cuerpo predeterminado del mensaje de alerta o personalizar una de estas plantillas JSON:

Nota

Nota: Si el acceso al servicio de terceros está limitado a direcciones IP específicas, por favor consulta este artículo para la lista de direcciones IP de Cato que necesitas permitir (debes estar registrado para ver este artículo).

  • Básico - ID de cuenta, nombre de cuenta, título, asunto, tipo de alerta y el contenido de la alerta

    Los campos en la plantilla Básica están incluidos en la mayoría de las alertas de Cato

  • Todos los campos - todos los campos predefinidos están incluidos en la plantilla

  • ServiceNow - work_notes (contenido de la alerta), short_description (nombre de cuenta y título)

  • Jira - resumen (nombre de cuenta y título), descripción (contenido de la alerta)

  • Personalizado - Define el contenido para el cuerpo del Webhook, puedes comenzar con una de las plantillas anteriores y hacer cambios

Personalizando el Contenido de la Alerta

El campo content en la plantilla contiene el resumen legible generado de la alerta, similar al contenido de la alerta por correo electrónico. Puedes elegir estos formatos para el contenido: contentText, contentMarkdown, o contentHTML.

Si eliges personalizar el cuerpo, hay una serie de campos de datos que puedes usar en el contenido del mensaje. Así puedes definir el cuerpo personalizado (o estructura), y luego incrustar los campos de datos de Cato. Cuando ingresas $, se muestran los campos de datos disponibles y luego selecciona el campo requerido. Los campos usan auto-completar para filtrar la lista. Para más información sobre los campos de Cato, consulta Understanding the JSON Fields for Alert Integrations.

Página de Webhooks

Para crear una integración de Webhook:

  1. Desde el menú de navegación, haz clic en Cuenta > Suscripciones y selecciona la pestaña Integraciones.

  2. Haz clic en Nueva Integración > Webhook. Se abre el panel Nueva Integración de Webhook.

  3. Configura estos ajustes de integración:

    1. Introduce el Nombre de la integración.

    2. Haz clic en el control deslizante para habilitar (verde) o deshabilitar (gris) la integración (está habilitada por defecto).

  4. Configura los Detalles de Conexión:

    1. Introduce la URL para el servicio que está recibiendo el Webhook.

    2. Si es necesario, configura el Método de Autenticación y los ajustes para el servicio.

    3. Haz clic en Probar. Si la integración puede conectarse al servicio, entonces se muestra un mensaje de Prueba exitosa.

      Si hay un error de conexión, la página muestra el código de error HTTP y el mensaje reportado por el servicio.

  5. (Opcional) En Encabezados Personalizados, define la Clave y el Valor para cada encabezado HTTP adicional para la integración.

  6. En Cuerpo Personalizado, define el contenido de la alerta de Webhook:

    1. En Iniciar desde plantilla, selecciona la plantilla JSON para el mensaje de alerta.

    2. (Opcional) En Editar Plantilla, personaliza el contenido de la alerta.

      • Introduce $ para incrustar otros campos

      • Introduce / como el carácter de escape

      Después de editar y guardar el contenido de una plantilla predefinida, la integración se define como una plantilla Personalizada.

  7. Haz clic en Guardar. La integración de Webhook se guarda y se añade a la página de Integraciones.

Definiendo Notificaciones de Políticas con Webhooks

Las políticas de Seguridad de Cato te permiten enviar notificaciones cuando se cumple una regla. Puedes configurar los ajustes de Seguimiento para enviar notificaciones a una integración específica o a un Grupo de Suscripción que contenga la integración.

rule_webhook.png

Para definir una notificación de Webhook para una regla:

  1. En la política relevante, edita la regla y expande la sección de Acciones.

  2. Selecciona Enviar Notificación.

  3. Define la Frecuencia para determinar con qué frecuencia se envía la alerta.

  4. En Enviar notificación a, selecciona Grupo de Suscripción o Integración y selecciona el elemento relevante.

  5. Haz clic en Aplicar.

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 1

0 comentarios