Test des webhooks
Utilisez des récepteurs de webhooks publics pour tester vos webhooks et vous assurer que vous obtenez les données dont vous avez besoin.
En testant les webhooks, vous pouvez vérifier le processus de configuration ainsi qu’inspecter et analyser les messages d’événement que vous recevez de Mist. Si vous n’avez pas de récepteur de webhook à votre disposition, vous pouvez utiliser un service public gratuit. De nombreux services de ce type vous permettent de recevoir et d’inspecter les messages webhook POST entrants de Juniper Mist.
Ces sites publics créent une URL aléatoire que vous pouvez utiliser temporairement. Les données que vous recevez sont éphémères et sont supprimées dès que vous fermez votre navigateur. À l’aide de l’un de ces sites à partir de votre navigateur, vous pouvez identifier les données de paramètres à partir des charges utiles de message pour vous aider à créer votre flux de travail.
Une fois que vous avez configuré votre webhook, vous pouvez le déclencher et afficher ces messages au fur et à mesure qu’ils sont reçus sur le récepteur de webhook public.
Deux de ces récepteurs de webhook à test gratuit sont :
Ces sites ne sont pas gérés par Juniper et peuvent être utilisés à vos risques et périls.
Testeur de webhook
Il existe un outil de test de webhooks que vous pouvez utiliser pour tester et surveiller facilement les webhooks de votre organisation Mist. Le testeur de webhook est disponible ici Mist Webhook Tester. Il s’agit d’une application qui crée et supprime automatiquement la configuration Webhook dans l’organisation Mist pour les recevoir, et affiche les messages Webhook reçus dans un tableau.
-
Seuls les comptes Mist locaux peuvent utiliser cette application (les utilisateurs SSO ne sont pas pris en charge).
-
Seuls les administrateurs ayant le rôle de super utilisateur sont pris en charge (les webhooks au niveau de l’organisation peuvent être configurés par les super utilisateurs).
Vous trouverez ci-dessous un schéma expliquant le fonctionnement de l’application.
Pour utiliser le testeur de webhook, il vous suffit de :
Accédez au Mist Webhook Tester.
Dans la fenêtre contextuelle de configuration, choisissez l’option :
Max Events in Memory (Nombre maximal d'événements en mémoire) : il s'agit du nombre maximal d'événements à stocker dans la mémoire de l'application.
Rubriques : il s’agit des rubriques webhook à recevoir. Seul un sous-ensemble limité de sujets Webhook est pris en charge, et tous les autres messages seront ignorés.
Orgs (Organisations) : une ou plusieurs Mist Orgs. L’application créera automatiquement une nouvelle configuration Webhook sur les organisations sélectionnées pour envoyer les rubriques activées à l’application.
Cliquez sur Save (Enregistrer).
Au fur et à mesure que des événements se produisent, ces webhooks sont envoyés à la table pour que vous puissiez les surveiller et les examiner. Des informations telles que la date, les rubriques, le type d’événement, l’organisation, le site, le nom de l’appareil, l’adresse MAC de l’appareil et les détails de l’événement s’affichent dans le tableau.
Pour plus de détails, voir https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file.
Testez la connectivité de bout en bout
Avec les webhooks, vous pouvez tester la connectivité de bout en bout entre votre instance Mist Cloud et le récepteur de webhook que vous avez défini pour confirmer que vous recevez le webhook et que vous êtes en mesure de le traiter. Il s’agit d’un webhook pour tester le fonctionnement des webhooks. Il remplit la même fonction qu'un ping pour tester la connectivité réseau, mais vous testez votre fonctionnalité de webhook. Cela permet de valider qu’aucun appareil (pare-feu ou routeur) ne bloque les communications entre les deux points de terminaison.
Cela peut être fait à partir de l’API en émettant un POST (à partir de votre client REST) vers, dans ce cas, à votre organisation, le webhook configuré (id) comme illustré dans cet exemple :
POST
/api/v1/orgs/203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx/webhooks/032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx/ping
Un résultat réussi ressemble à ceci :
{
"topic": "ping",
"events": [
{
"id": "032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx",
"name": "my webhook",
"org_id": "203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx",
"timestamp": 1725375149.0829651
}
]
}
Vous pouvez également le faire à partir du portail Juniper Mist :
Accédez à Organization > Admin > Settings.
Recherchez la section Webhooks et cliquez sur le bouton Ajouter un webhook .
Sélectionnez le type de webhook approprié, donnez un nom à votre webhook de test, puis collez l’URL de test que vous avez obtenue sur le site Web gratuit du récepteur de test de webhook (voir les liens fournis ci-dessus) dans le champ URL .
- Choisissez les rubriques webhook pour lesquelles vous souhaitez recevoir des messages et définissez les autres paramètres nécessaires.
- Enfin, sélectionnez Ajouter.
Recherchez votre webhook de test répertorié dans la section Webhooks de la page Paramètres de l’organisation et cliquez sur Afficher pour afficher les événements de diffusion. Vous pouvez vérifier ces événements pour voir l’état de livraison des webhooks afin de confirmer que vous recevez le webhook et que vous êtes en mesure de le traiter.
Informations supplémentaires sur les tests
Pour vérifier que votre serveur web est capable de recevoir et de traiter Mist Webhooks, consultez les informations de la section Valider les diffusions.
Pour savoir comment envoyer un événement ping à un webhook de site, consultez Webhook de site Ping.
Pour savoir comment envoyer un événement ping à un webhook d’organisation, consultez Webhook de l’organisation Ping.