Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Test des webhooks

Utilisez des récepteurs webhook 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, mais aussi inspecter et analyser les messages d’événement que vous recevez de Mist. Si vous n’avez pas de récepteur webhook à votre disposition, vous pouvez utiliser un service public gratuit. Beaucoup de ces services 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ètre des charges utiles des messages pour vous aider à créer votre flux de travail.

Après avoir configuré votre webhook, vous pouvez le déclencher et afficher ces messages tels qu’ils sont reçus sur le récepteur webhook public.

Deux de ces récepteurs webhook de test gratuits sont :

Ces sites ne sont pas gérés par Juniper et doivent être utilisés à vos propres risques.

Remarque : Assurez-vous de supprimer tous les webhooks de test de Mist lorsqu’ils ne sont plus utilisés. Sinon, Mist continuera à pousser les webhooks vers l’URL du webhook cible, et les récepteurs de test de webhook peuvent donc mettre les adresses IP Mist sur liste noire.

Testeur de Webhook

Il existe un outil de test de webhook que vous pouvez utiliser pour tester et surveiller facilement les webhooks de votre organisation Mist. Le testeur 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.

Remarque :

  • Seuls les comptes Mist locaux peuvent utiliser cette application (les utilisateurs SSO ne sont pas pris en charge).

  • Seuls les administrateurs ayant un 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 suffit de :

  1. Accédez au testeur Webhook Mist.

  2. Dans la fenêtre contextuelle de configuration, choisissez l’option :

    1. Nombre maximal d'événements en mémoire : nombre maximal d'événements à stocker dans la mémoire de l'application.

    2. Rubriques : ce sont les rubriques webhook à recevoir. Seul un sous-ensemble limité de sujets Webhook est pris en charge, et tous les autres messages seront ignorés.

    3. Orgs : une ou plusieurs organisations Mist. L’application créera automatiquement une nouvelle configuration Webhook sur les organisations sélectionnées pour envoyer les rubriques activées à l’application.

    4. Cliquez sur Enregistrer.

  3. Au fur et à mesure que des événements se produisent, ces webhooks sont envoyés à la table pour que vous les surveilliez et les examiniez. Des informations telles que la date, les sujets, 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 sont affichées dans le tableau pour vous.

Remarque : L’application peut parfois ne pas être en mesure de supprimer la configuration du webhook à la fin de la session. Par conséquent, il est recommandé de confirmer que la configuration du webhook a été supprimée.

Pour plus de détails, voir https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file.

Tester la connectivité de bout en bout

Avec les webhooks, vous pouvez tester la connectivité de bout en bout de votre instance Mist Cloud au récepteur webhook que vous avez défini pour confirmer que vous recevez le webhook et que vous êtes capable 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 valide qu’aucun équipement (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) à, dans ce cas, votre organisation, le webhook configuré (id) comme indiqué dans cet exemple :

Un résultat réussi ressemble à ceci :

Vous pouvez également le faire depuis le portail Juniper Mist :

  1. Accédez à Organisation > Admin > Paramètres.

  2. Trouvez la section Webhooks et cliquez sur le bouton Ajouter un webhook .

  3. 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 webhook (voir les liens fournis ci-dessus) dans le champ URL .

  4. Choisissez les sujets du webhook pour lesquels vous souhaitez recevoir des messages et définissez les autres paramètres nécessaires.
  5. Enfin, sélectionnez Ajouter.

  6. 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 consulter d’autres informations de test de webhook, telles que la façon dont votre serveur web est capable de recevoir et de traiter les webhooks Mist, consultez les informations de la section Valider les diffusions.

Pour savoir comment envoyer un événement ping à un webhook de site, consultez Webhook ping de site.

Pour savoir comment envoyer un événement ping à un webhook d’organisation, consultez Webhook Ping Org.