Probar webhooks

Usa receptores de webhooks públicos para probar tus webhooks y asegurarte de que estás obteniendo los datos que necesitas.

Al probar los webhooks, puede verificar el proceso de configuración, así como inspeccionar y analizar los mensajes de eventos que recibe de Mist. Si no tiene un receptor de webhook disponible, puede utilizar un servicio público y gratuito. Muchos de estos servicios le permiten recibir e inspeccionar los mensajes de webhook POST entrantes de Juniper Mist.

Estos sitios públicos crean una URL aleatoria que puede usar de forma temporal. Los datos que recibe son efímeros y se eliminan tan pronto como cierra su navegador. Al usar uno de estos sitios desde su navegador, puede identificar datos de parámetros de las cargas de mensajes para ayudar a crear su flujo de trabajo.

Después de configurar el webhook, puede activarlo y ver los mensajes a medida que se reciben en el receptor de webhook público.

Dos de estos receptores de webhook de prueba gratuitos son:

Estos sitios no son mantenidos por Juniper y deben usarse bajo su propia responsabilidad.

Nota: Asegúrate de eliminar todos los webhooks de prueba de Mist cuando ya no estén en uso. De lo contrario, Mist seguirá enviando webhooks a la URL del webhook de destino y, como resultado, los receptores de las pruebas de webhooks podrán incluir direcciones IP de Mist en la lista negra.

Probador de webhooks

Existe una herramienta de prueba de webhooks que puede utilizar para probar y supervisar fácilmente los webhooks de su organización de Mist. El probador de webhooks está disponible aquí: Mist Webhook Tester. Esta es una aplicación que crea y elimina automáticamente la configuración de webhook en la organización de Mist para recibirlos y muestra los mensajes de webhook recibidos en una tabla.

Nota:

Solo las cuentas locales de Mist pueden usar esta aplicación (no se admiten usuarios de ISU).
Solo se admiten administradores con un rol de superusuario (los webhooks a nivel de organización pueden ser configurados por superusuarios).

A continuación se muestra un diagrama que explica cómo funciona la aplicación.

Para usar el probador de webhooks, simplemente:

Navegue hasta el Probador de webhooks de Mist.
En la ventana emergente de configuración, elija:
1. Número máximo de eventos en la memoria: este es el número máximo de eventos que se almacenarán en la memoria de la aplicación.
2. Temas: estos son los temas de webhook que se van a recibir. Solo se admite un subconjunto limitado de temas de webhook y se descartarán todos los demás mensajes.
3. Organizaciones: una o varias organizaciones de Mist. La aplicación creará automáticamente una nueva configuración de Webhook en las organizaciones seleccionadas para enviar los temas habilitados a la aplicación.
4. Haga clic en Guardar.
A medida que ocurren eventos, esos webhooks se envían a la tabla para que los supervise y revise. En la tabla se muestra información como la fecha, los temas, el tipo de evento, la organización, el sitio, el nombre del dispositivo, la MAC del dispositivo y los detalles del evento.

Nota: Es posible que la Aplicación ocasionalmente no pueda eliminar la configuración del webhook al final de la sesión. Por lo tanto, se recomienda confirmar que se eliminó la configuración del webhook.

Para obtener más información, consulte https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file.

Pruebe la conectividad de extremo a extremo

Con los webhooks, puede probar la conectividad de extremo a extremo desde su instancia de nube de Mist a su receptor de webhook definido para confirmar que está recibiendo el webhook y que puede procesarlo. Este es un webhook para probar que los webhooks están funcionando. Cumple la misma función que un ping para probar la conectividad de la red, pero está probando la funcionalidad de su webhook. Esto valida que ningún dispositivo (un firewall o un enrutador) esté bloqueando las comunicaciones entre los dos puntos de conexión.

Esto se puede hacer desde la API emitiendo un POST (desde su cliente REST) a, en este caso, su organización, el webhook configurado (id) como se ve en este ejemplo:

Un resultado exitoso se ve así:

Esto también se puede hacer desde el portal de Juniper Mist:

Vaya a Configuración de > de administración de > de la organización.
Busque la sección Webhooks y haga clic en el botón Agregar webhook .
Seleccione el tipo de webhook apropiado, asigne un nombre a su webhook de prueba y, a continuación, pegue la URL de prueba que obtuvo del sitio web del receptor de prueba de webhook gratuito (consulte los enlaces proporcionados anteriormente) en el campo URL .
Elija los temas de webhook para los que desea recibir mensajes y establezca cualquier otra configuración necesaria.
Por último, seleccione Agregar.
Busque su webhook de prueba en la sección Webhooks de la página Configuración de la organización y haga clic en Ver para ver los eventos de entrega. Puede comprobar estos eventos para ver el estado de entrega de los webhooks y confirmar que está recibiendo el webhook y que puede procesarlo.

Información adicional sobre pruebas

Para revisar información adicional sobre pruebas de webhooks, como la forma en que probar que su servidor web puede recibir y procesar webhooks de Mist, consulte la información en Validar envíos.

Para ver cómo enviar un evento ping a un webhook del sitio, consulte Ping Site Webhook.

Para ver cómo enviar un evento ping a un webhook de organización, consulte Ping Org Webhook.