Jerarquía de webhooks

RESUMEN Comprender la relación entre los webhooks a nivel de organización y de sitio. Familiarícese con los temas de webhook que puede configurar en cada nivel.

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.
Información del cliente	Un tema que incluye información sobre cada cliente.
Sesiones de cliente	El tema que incluye información sobre las sesiones de cliente.
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. Los temas se clasifican en dos categorías: estándar y avanzado. Puede seleccionar un tema en la categoría Avanzado o varios temas en la categoría Estándar para un webhook. No puede seleccionar temas de ambas categorías.

Webhooks de ubicación
Webhooks de servicio de red
Webhooks de infraestructura
Activo BLE RSSI

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
Eventos de entrada/salida Zona de Ubicación Zona de proximidad Baliza virtual	Datos enviados cada vez que un cliente entra o sale de una de estas áreas.
Alertas de ocupación	Alertas sobre un umbral de ocupación de zona configurado que se está superando.
Datos de análisis del cliente del SDK	Datos específicos sobre un cliente que no está disponible sin instalar una aplicación (mediante el SDK) en el propio cliente.
Coordenadas X/Y Activos con nombre Clientes del SDK	Datos enviados a intervalos regulares de: Aproximadamente 2 segundos para los activos con nombre. Aproximadamente 1 segundo para clientes SDK.
Activos en bruto	Este tema quedará obsoleto. Utilice el tema RSSI de activos BLE .

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.
Información del cliente	El webhook que incluye información sobre cada cliente.
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 las sesiones del cliente.
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 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).

Activo BLE RSSI

El tema RSSI del activo BLE envía datos BLE de telemetría basados en el activo con nombre.