Jerarquía de webhooks

Descripción general de la jerarquía de webhooks

Juniper Mist tiene dos jerarquías de configuración para webhooks: el nivel de organización y el nivel de sitio. El método de configuración es el mismo para ambos; Sin embargo, no todos los webhooks están disponibles en ambos niveles.

Todos los webhooks que están disponibles a nivel de organización también están disponibles para webhooks específicos a nivel de sitio.
Los webhooks disponibles a nivel de sitio no están disponibles a nivel de organización.

Tenga en cuenta la jerarquía al configurar webhooks.

Por ejemplo, si tiene dos sitios y configura el webhook de alertas en el nivel de la organización, recibirá todas las alertas de nivel de organización para ambos sitios.

Por el contrario, si no configura el webhook de alertas en el nivel de organización y solo configura el webhook de alertas en uno de los dos sitios, recibirá alertas solo para ese único sitio.

Por último, si configura el webhook de alertas en el nivel de organización y en un solo sitio, el receptor del webhook recibirá mensajes duplicados (suponiendo que se envíen a la misma URL del receptor).

Puede configurar varios receptores de webhook para un solo webhook (y sus temas) desde la API. Se recomienda tener un único webhook que incluya todos los temas disponibles y, a continuación, analizar la información que desee de los mensajes recibidos por el receptor del webhook.

Webhooks de organización

Un Webhook de organización es una configuración que permite insertar datos de la organización en una URL especificada. Puede personalizar los webhooks de la organización mediante la API RESTful de Mist, que le permite obtener datos de una organización específica.

Puede configurar estos temas a nivel de organización:

Tabla 1: Webhooks de organización
Tema	Descripción
Alertas	Eventos de alarma definidos por Juniper Mist configurables por sitio en el marco de alertas.
Auditorías	Un tema que realiza un seguimiento de los cambios de configuración realizados desde el panel de Juniper Mist.
Unirse al cliente	El webhook que Juniper Mist activa cada vez que un cliente se une a una red inalámbrica.
Sesiones de cliente	El webhook que incluye información sobre cada cliente específico.
Eventos del dispositivo	Un tema específico de los eventos que ocurren en dispositivos (actualmente AP, conmutador y puerta de enlace)
Activa/baja del dispositivo	El tema que genera un mensaje cuando un dispositivo se inicia o deja de funcionar.
Eventos de Juniper Mist Edge	El tema que genera mensajes para un puerto de Juniper Mist Edge y cambios de estado de vínculo y puerto del protocolo de control de agregación de vínculos (LACP).

Webhooks del sitio

Un webhook de sitio es una configuración que permite insertar datos y eventos del sitio en una dirección URL especificada. Puedes personalizar webhooks de sitio mediante la API de Mist para poder obtener datos de un sitio determinado.

Puede configurar estos temas en el nivel de sitio:

Webhooks de ubicación
Webhooks de servicio de red
Webhooks de infraestructura

Webhooks de ubicación

Para usar webhooks de ubicación, debe cargar un plano de planta con una ubicación precisa de AP a través del portal de Juniper Mist para correlacionar los datos del cliente. Para obtener más información, consulte la Descripción general de la configuración de planos de planta en la Guía de servicios de ubicación de Juniper Mist.

Tabla 2: Webhooks de ubicación
Tema	Descripción
Coordenadas de ubicación	Datos enviados a intervalos regulares de menos de uno por segundo.
Zonas	Datos enviados cada vez que un cliente entra o sale de una de las áreas definidas. Alertas de ocupación: alertas sobre un umbral de ocupación de zona configurado que se supera. Zonas RSSI: alertas basadas en el valor RSSI mínimo de una WLAN de la intensidad de la señal de un cliente en relación con los puntos de acceso del sitio. Datos de análisis de cliente del SDK: datos específicos sobre un cliente que no están disponibles sin instalar una aplicación (mediante el SDK) en el propio cliente. Eventos de entrada y salida de balizas virtuales: datos enviados cada vez que un cliente entra o sale de una de estas áreas. Eventos de entrada y salida de zona: datos enviados cada vez que un cliente entra o sale de una de estas áreas.

Webhooks de servicio de red

Tabla 3: Webhooks de servicios de red
Tema	Descripción
Latencia	Un webhook que proporciona DHCP, DNS e información de latencia de autenticación agregada en todos los dispositivos cliente en el nivel de sitio.

Nota:

Necesitará una suscripción a Marvis para suscribirse a este webhook.

Webhooks de infraestructura

Tabla 4: Webhooks de infraestructura
Tema	Descripción
Alertas	Eventos de alarma definidos por Juniper Mist configurables por sitio en el marco de alertas.
Auditorías	Un tema que realiza un seguimiento de los cambios de configuración realizados desde el panel de Juniper Mist.
Unirse al cliente	El webhook que Juniper Mist activa cada vez que un cliente se une a una red inalámbrica.
Sesiones de cliente	El webhook que incluye información sobre cada cliente específico.
Eventos del dispositivo	Un tema específico de los eventos que ocurren en dispositivos (actualmente AP, conmutador y puerta de enlace)
Activa/baja del dispositivo	El tema que genera un mensaje cuando un dispositivo se inicia o deja de funcionar.
Eventos de Juniper Mist Edge	El tema que genera mensajes para un puerto de Juniper Mist Edge y cambios de estado de vínculo y puerto del protocolo de control de agregación de vínculos (LACP).