Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configurar webhooks para recibir notificaciones de eventos

Los webhooks se utilizan para automatizar el envío de notificaciones de eventos desde una aplicación de origen a una aplicación de destino. Puede configurar webhooks para permitir que Paragon Automation envíe notificaciones a aplicaciones de terceros, como Slack, cuando los eventos a los que se ha suscrito se activen en los dispositivos administrados.

Nota:

Se requiere conectividad a Internet para que Paragon Automation se conecte a aplicaciones de terceros.

En la siguiente sección se describe cómo configurar webhooks para recibir notificaciones de eventos en Slack.

Para recibir notificaciones de webhook en un formato compatible con Slack, debe configurar un intermediario que pueda interactuar con las aplicaciones de envío y recepción, en este caso, Paragon Automation y Slack. La plataforma intermediaria recomendada es Make. Para procesar las notificaciones, Make usa un flujo de trabajo denominado Scenario, que convierte las notificaciones a un formato compatible con Slack. Cada notificación de evento se envía a una dirección URL que se genera para el escenario en Make. Luego, la notificación se convierte a un formato compatible con Slack y se entrega al canal de Slack configurado.

Para obtener información acerca de Scenario in Make, consulte Scenario.

Para configurar webhooks en Paragon Automation para enviar notificaciones a un canal de Slack:

  1. Inicie sesión para realizar https://www.make.com/en/login. Desde la página de inicio, vaya a Escenario en el menú de navegación izquierdo.
  2. Configure las opciones del escenario como se describe, consulte Creación de un escenario.

    Make genera una URL. Cada vez que se activa un evento, Paragon Automation envía notificaciones de webhook a esta URL.

  3. En la GUI de Paragon Automation, vaya a Configuración de la organización (menú Configuración > Configuración del sistema).

    Aparecerá la página Configuración de la organización.

  4. En el icono Webhooks, habilite Webhooks.
  5. Configure los ajustes de webhooks. Consulte la Tabla 1 para obtener descripciones de los campos de webhooks.
    Nota:

    En el campo URL, escriba la URL generada en el paso 2.
  6. (Opcional) Verifique la integración de Webhook-Slack iniciando sesión en la CLI de un dispositivo y generando un evento.

    Por ejemplo, ejecute los siguientes comandos en la CLI del dispositivo para generar una alerta.

  7. (Opcional) Verifique que:

    • El evento que generó aparece en la página Eventos (Observabilidad > eventos).

    • Has recibido una notificación del evento en el canal de Slack.

      Nota:

      • Debe tener acceso al canal de Slack para ver notificaciones de eventos en Slack.

      • Debe ser un administrador con el rol Administrador de red para realizar acciones correctivas.
    Tabla 1: Parámetros para configurar webhooks
    Descripción del campo
    Nombre

    Introduce un nombre para el webhook. El nombre puede contener caracteres alfanuméricos y especiales.
    URL

    Escriba la dirección URL generada en Hacer para el escenario.
    Secreto

    Escriba el secreto para validar que las notificaciones recibidas proceden de hosts válidos.

    El secreto puede contener una cadena de caracteres alfanuméricos y especiales.
    Encabezado de webhook

    Los encabezados personalizados de Webhook son pares clave-valor que proporcionan información adicional sobre las notificaciones.

    Puede agregar varios encabezados personalizados a:

    • Proporcione información adicional en texto sin formato, junto con los encabezados predeterminados, sobre las notificaciones de webhook que se envían al punto de conexión configurado.

    • Proporcionar seguridad, como claves de API, para verificar la integridad de los datos de extremo a extremo, para la autorización, etc.

    Haga clic en el icono Agregar (+) para agregar encabezados de webhook.

    Aparecerá la página Encabezado de Webhook.

    • Header Key (Header Key): introduce una clave única.

    • Valor de encabezado (Header Value): introduce un valor único para la clave. El valor puede contener caracteres alfanuméricos.

    Haga clic en el icono Eliminar (papelera) para eliminar los encabezados del webhook.
    API de streaming

    Habilite los eventos para los que desea recibir notificaciones.

    Puede suscribirse a eventos como alertas, auditorías, estado del dispositivo y alarmas de dispositivos para recibir notificaciones en tiempo real cuando ocurra el evento.

    • Alertas: haga clic para activar o desactivar la recepción de notificaciones cuando se generen alertas suscritas en los dispositivos administrados. La notificación de alertas está deshabilitada de forma predeterminada.

    • Auditorías: haga clic para activar o desactivar la recepción de notificaciones cuando un usuario acceda a una organización o modifique su configuración. La notificación de auditorías está deshabilitada de forma predeterminada.

    • Estado del dispositivo: haga clic para activar o desactivar la recepción de notificaciones cuando el estado del dispositivo cambie debido a eventos como un vínculo que sube o baja, o que el dispositivo se desconecta de Paragon Automation, etc. La notificación de estado del dispositivo está deshabilitada de forma predeterminada.

    • Alarmas de dispositivo: haga clic para activar o desactivar la recepción de notificaciones cuando se generen alarmas suscritas en los dispositivos administrados. La notificación de alarma de dispositivo está desactivada de forma predeterminada.

Documentación relacionada