Agregar un webhook en el portal de Juniper Mist

Siga estas instrucciones para configurar un nuevo webhook mediante el portal de Juniper Mist™.

1. En el portal de Juniper Mist™, vaya a la configuración de la organización o del sitio:

   • En webhooks a nivel de organización, seleccione Configuración de > de la organización.

   • En el caso de los webhooks de nivel de sitio, seleccione Configuración de la organización > sitio y, a continuación, seleccione el sitio.

     Nota:

     En el siguiente ejemplo, se muestra la configuración de webhooks a nivel de sitio. Al configurar webhooks a nivel de organización, las opciones que se mostrarán serán diferentes, como la lista de temas de webhook disponibles para elegir.

2. Desplácese hacia abajo hasta la sección Webhooks y haga clic en Agregar webhook.
   
3. Ingrese la información:

   • Nombre: introduzca un nombre para identificar este webhook.

   • Tipo de webhook: seleccione HTTP Post, OAuth2 o Splunk. Para OAuth2, la nube de Mist actuará como cliente para el tipo seleccionado y se autenticará en un servidor de autorización para obtener un token, que luego se anexará a los encabezados de autorización de webhook.

   • URL: introduce la URL del destino al que quieres que Mist envíe los webhooks.

   • Tipos de concesión: (solo OAuth2) Hay dos maneras de solicitar tokens de acceso del sistema del cliente:

     • Basada en contraseña, que requiere el nombre de usuario y la contraseña del propietario del recurso.

     • Basada en credenciales de cliente, que requiere el ID de cliente y el secreto de cliente proporcionados por el DPI de OAuth.

   • Temas: seleccione los temas para los que desea recibir webhooks. Debe seleccionar al menos uno.

   
4. (Opcional) Haga clic en Configuración avanzada para ver opciones adicionales.

   • Verificar certificado: esta opción está activada de forma predeterminada. Si no desea que Mist verifique que el certificado del receptor del webhook es válido, haga clic en No. Aunque este método no es seguro, proporciona cierta flexibilidad si el receptor de webhook no tiene un certificado firmado válido. No recomendamos este método, por razones de seguridad.

   • Secreto (solo HTTP-POST): el uso de un secreto le permite especificar un secreto (como una contraseña) que se utiliza para calcular un par de encabezados HTTP. Un secreto le permite verificar que el mensaje proviene de Juniper Mist y no se modificó.

   • Encabezados personalizados: la configuración Encabezados personalizados le permite especificar los encabezados personalizados necesarios para el receptor de webhook. Algunos receptores (o sus proxies) requieren un método de autenticación basado en tokens, autenticación basada en usuarios o un método para presentar encabezados personalizados para indicar el tipo de datos que se envían.

   Nota:

   Tenga en cuenta estas precauciones al considerar si debe usar encabezados secretos o personalizados:

   • Cuando se proporciona un secreto, se agregarán dos encabezados HTTP:
     • X-Mist-Signature: HMAC_SHA1 (secreto, cuerpo)
     • X-Mist-Signature-v2: HMAC_SHA256 (secreto, cuerpo)
   • Si el formato de los encabezados no es válido, se enviará "X-Mist-Error": "formato de encabezados no válido".
   • Si el total de bytes de los encabezados supera los 1000, se enviará "X-Mist-Error": "encabezados demasiado grandes".
   • Si algún valor de encabezado no es una cadena, se enviará "X-Mist-Error": "header[%s] not a string".
5. Haga clic en Agregar.