Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Agregar un webhook en el portal de Juniper Mist

  1. En el portal de Juniper Mist™, vaya a la configuración de la organización o del sitio:
    • Para webhooks a nivel de organización, seleccione Configuración del > de la organización.

    • Para webhooks de nivel de sitio, seleccione Configuración de organización > sitio y, a continuación, seleccione el sitio.

      Nota:

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

  2. Desplázate hacia abajo hasta la sección Webhooks y haz clic en Agregar webhook.
    Location of the Add Webhooks button
  3. Introduzca la información:
    • Nombre: introduce 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 anexará a los encabezados de autorización de Webhook.

    • URL: introduce la URL de destino a la que quieres que Mist envíe los webhooks.

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

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

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

    • Temas: selecciona los temas para los que quieres 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 compruebe 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 del 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) utilizado para calcular un par de encabezados HTTP. Un secreto le permite comprobar que el mensaje proviene de Juniper Mist y que no se ha modificado.

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

    Nota:

    Tenga en cuenta estas precauciones cuando considere 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.