Temas de webhook

Examine los diversos temas de webhook que están disponibles para las organizaciones y los sitios de Juniper Mist™.

Después de habilitar los webhooks en la organización, el sitio o en ambos niveles, seleccione los temas para los que desea recibir mensajes.

Use las siguientes tablas para obtener más información.

Tabla 1: Organización y temas del sitio
Propósito del tema	y detalles de la carga
alertas (alarmas)	Alarmas seleccionadas por el usuario para dispositivos e infraestructura, acciones de Marvis y seguridad. Para buscar alertas en el portal de Juniper Mist, seleccione Monitorear alertas > > Configuración de alertas en el menú de la izquierda. Ejemplos Dispositivos e infraestructura: dispositivo inactivo, dispositivo reiniciado, emparejamiento VPN inactivo, error de ARP, error de DNS. Marvis: cable defectuoso, comprobación del estado del AP fallida, mala cobertura de Wi-Fi, oscilación de puertos, enlace ascendente de WAN defectuoso. Seguridad: ataque KRACK, ataque ICV TKIP, cliente fraudulento, AP no autorizado, honeypot. Según el tipo de alarma, la carga útil puede incluir detalles como los ID de la organización y el sitio, el tipo de evento, la gravedad y el recuento de cada tipo de evento durante el intervalo de agregación. Para ver qué alarmas están disponibles y obtener ejemplos de sus cargas útiles de un cliente de API de REST, emita la siguiente llamada a la API: `GET /api/v1/const/alarm_defs`
auditorías	Un tema que todos los cambios de configuración de Mist activan este tema. La carga incluye detalles como el nombre y el nombre de usuario del administrador, el ID del dispositivo, el tipo de cambio y la marca de tiempo del cambio.
información-cliente	Utilice este webhook para obtener eventos de información de clientes inalámbricos. La carga incluye detalles sobre el cliente, como el nombre de host, la dirección IP, la dirección MAC, el ID de organización y sitio, y la marca de tiempo de la asignación de IP.
unión de cliente	Solo conexiones de cliente. La carga incluye detalles como los ID de la organización y el sitio; la dirección MAC y el nombre del AP al que se conectó el cliente; y el ID de WLAN, la banda, el SSID, el RSSI y la marca de tiempo de la conexión.
sesiones de clientes	Información de la sesión del cliente. La carga incluye detalles como la dirección MAC y el nombre del AP al que el cliente se desconectó o del que se desconectó, el ID de WLAN, la banda, la familia de dispositivos ("Mac", "iPhone", "Apple Watch"), el fabricante y el modelo del cliente, las marcas de tiempo para la conexión y desconexión, la duración de la flotación, el RSSI y el motivo de la terminación.
eventos de dispositivo	Utilice este webhook para obtener una lista de posibles eventos que afecten a puntos de acceso, conmutadores y puertas de enlace. Este tema incluye eventos como puerto activo o inactivo, cambios de energía de AP y cambios de canal. La carga de este webhook puede incluir detalles como los ID de la organización y el sitio, la dirección MAC y el nombre del dispositivo, y la marca de hora del evento, pero puede variar según el tipo exacto de evento del dispositivo. Para ver qué alarmas están disponibles y obtener ejemplos de sus cargas, emita la siguiente llamada a la API desde un cliente de REST API: `GET /api/v1/const/device_events`
updowns de dispositivos	El dispositivo se desconecta, se vuelve a conectar y se reinicia. La carga incluye detalles como los ID de la organización y el sitio, el tipo de evento y la dirección MAC y el nombre del dispositivo. Para configurar `device-updowns` en el portal de Mist Juniper, seleccione Monitorear alertas de > > Configuración de alertas en el menú de la izquierda. Aquí puede configurar un control más granular de los tipos de dispositivos y umbrales de alerta.
mxedge-events	Utilice este webhook para obtener una lista de posibles eventos de Mist Edge, incluyendo detalles como el estado físico de Juniper Mist Edge y el estado del vínculo LACP.
Contabilidad NAC	Utilice este webhook para obtener una lista de cualquier posible Juniper Mist eventos de cuenta de control de acceso a la red (NAC) (ACCOUNTING_START, ACCOUNTING_STOP, ACCOUNTING_UPDATE). La carga incluye detalles como la marca de tiempo, el AP, el client_ip, el SSID, el nombre de usuario, el client_type, el client_mac, el nas_vendor, el site_id, el rx_pkts y el tx_pkts.
Eventos NAC	Este webhook se activa con cualquier evento de control de acceso a la red (NAC) de Juniper Mist. La carga puede incluir detalles como auth_type, bssid, idp_role, random_mac, resp_attrs, pero puede variar según el tipo de evento nac.
Señal	Un evento ping que va a la URL del webhook. La carga incluye el ID del sitio, el ID y el nombre del webhook, y la marca de hora.

Tabla 2: Temas solo para el sitio
Propósito del tema	y detalles de la carga
rssi sin procesar de activos	Reemplaza el tema obsoleto denominado asset-raw. Datos sin procesar de paquetes emitidos por activos nombrados y filtrados. La carga incluye detalles como los ID de la organización, el sitio, el mapa, el AP, la antena y el activo; la ubicación de AP; el RSSI; la baliza UUID y fabricante; los paquetes de servicio; y datos.
latencia del cliente	Información de DHCP, DNS y latencia de autenticación agregada en todos los dispositivos del cliente a nivel de sitio. Los datos de latencia se proporcionan para una ventana de 10 minutos a intervalos de 10 minutos. Le recomendamos que use este webhook para recibir datos de latencia de red en lugar de sondear a través de la API. Nota: Necesitará una suscripción a Marvis para suscribirse a este webhook.
rssi sin procesar descubierto	Datos sin procesar de paquetes emitidos por BLE pasivo. La carga incluye detalles como los ID de la organización, el sitio, el mapa, el AP de informes y la antena; la dirección MAC; el ID del activo, el fabricante y el UUID del activo o la baliza; y el RSSI.
autorizaciones de invitados	Datos para clientes invitados cuando autorizan en una WLAN. La carga incluye detalles como AP, auth_method, authorized_expiring_time, operador, cliente, empresa, correo electrónico, móvil, nombre, org_id, site_id, puerta de enlace de SMS, sponsor_email, SSID y wlan_id.
Ubicación	Datos de ubicación de clientes Juniper Mist SDK, clientes inalámbricos y activos. Los datos incluyen detalles como los ID del sitio y del mapa, las coordenadas X e Y, la marca de tiempo, el tipo de cliente y el ID del cliente o la dirección MAC.
ubicación-activo	Datos de ubicación de activos de Juniper Mist (dispositivos de cliente de BLE). Los datos incluyen detalles como los ID del sitio y del mapa, las coordenadas X e Y, la marca de tiempo, el tipo de activo y la dirección MAC del activo.
location-centrak	Los datos de CenTrak enviados por los AP de Mist a los servidores de Centrak a través de webhooks. Los datos incluyen coordenadas X, Y, marca de tiempo, ID del sitio e información extendida de la baliza de Wi-Fi. Habrá diferentes campos según el tipo de evento de alarma.
ubicación-cliente	Datos de ubicación para clientes Juniper Mist SDK y clientes inalámbricos. Los datos incluyen detalles como el ID del sitio y del mapa, las coordenadas X e Y, la marca de tiempo, el tipo de cliente y la dirección MAC del cliente.
SDK de ubicación	Datos de ubicación de clientes del SDK de Juniper Mist. Los datos incluyen detalles como el ID del mapa, el tipo de cliente y las coordenadas X e Y.
ubicación-unclient	Datos de ubicación para clientes Juniper Mist SDK o clientes inalámbricos cuando el dispositivo cliente se desconecta de la red o ya no se detecta en una ubicación especificada. Los datos de la carga incluyen detalles como el ID del mapa, las coordenadas X e Y, la información extendida de la baliza Wi-Fi y la dirección MAC del cliente.
alertas de ocupación	Estado de ocupación basado en los límites de ocupación configurados. La carga incluye detalles como los ID de la organización, el sitio, el mapa y la zona; el evento ("COMPLIANCE-VIOLATION" o "COMPLIANCE-OK"); la marca de tiempo; el límite de ocupación; y la ocupación actual.

zona rssi	Dispositivos cerca de un punto de acceso. En este tema se proporciona información acerca de los dispositivos que entran o salen de una zona alrededor de un AP en la que el RSSI recibido por el AP está por encima de un umbral configurable. Puede crear una nueva zona RSSI para cada AP e incluir el nombre de zona RSSI y un umbral de zona RSSI.
sdkclient-scan-data	Datos de ubicación de clientes del SDK de Juniper Mist. Los datos incluyen detalles como la banda, el canal, SSID, BSSID y RSSI para la conexión; la dirección MAC del AP; lista de AP vecinos; la marca de tiempo en que se vio por última vez al cliente; y la marca de tiempo del análisis.
vBeacon	Dispositivos cerca de una baliza virtual. En este tema, se proporciona información acerca de los dispositivos cercanos a un vBeacon configurado. Utilice este webhook con el SDK de Juniper Mist.
wifi-conn-raw wifi-unconn-raw	Datos sin procesar de paquetes emitidos por dispositivos conectados y no conectados. La carga incluye detalles como los ID de la organización, el sitio, el mapa y el AP de informes; las coordenadas de ubicación del AP; el RSSI y la banda; y la carga útil de la baliza de Wi-Fi. No incluye los datos de ubicación del cliente.
zona	Datos de ubicación para balizas virtuales en su planta, enviados cuando un cliente entra o sale de una zona. Los datos incluyen detalles como los ID del sitio, el mapa y la zona, la marca de tiempo, el desencadenante (entrada o salida), el tipo de cliente (cliente SDK, cliente inalámbrico o activo) y el ID o la dirección MAC del cliente.