Webhooks testen

Verwenden Sie öffentliche Webhookempfänger, um Ihre Webhooks zu testen und sicherzustellen, dass Sie die benötigten Daten erhalten.

Durch das Testen von Webhooks können Sie den Konfigurationsprozess überprüfen sowie die Ereignismeldungen, die Sie von Mist Systems erhalten, untersuchen und analysieren. Wenn Ihnen kein Webhook-Empfänger zur Verfügung steht, können Sie einen öffentlichen, kostenlosen Dienst nutzen. Viele dieser Services ermöglichen es Ihnen, die eingehenden Webhook-Nachrichten POST von Juniper Mist Systems zu empfangen und zu überprüfen.

Diese öffentlichen Websites erstellen eine zufällige URL, die Sie temporär verwenden können. Die Daten, die Sie erhalten, sind kurzlebig und werden gelöscht, sobald Sie Ihren Browser schließen. Wenn Sie eine dieser Websites in Ihrem Browser verwenden, können Sie Parameterdaten aus den Nachrichtennutzlasten identifizieren, um Ihren Workflow zu erstellen.

Nachdem Sie Ihren Webhook konfiguriert haben, können Sie ihn auslösen und diese Nachrichten anzeigen, sobald sie auf dem öffentlichen Webhookempfänger empfangen werden.

Zwei dieser kostenlos getesteten Webhook-Empfänger sind:

Diese Websites werden nicht von Juniper unterhalten und dürfen auf eigenes Risiko genutzt werden.

Hinweis: Stellen Sie sicher, dass Sie alle Test-Webhooks aus Mist Systems löschen, wenn sie nicht mehr verwendet werden. Andernfalls überträgt Mist Systems weiterhin Webhooks an die Ziel-Webhook-URL, woraufhin die Webhook-Testempfänger die IP-Adressen von Mist Systems auf die schwarze Liste setzen können.

Webhook-Tester

Es gibt ein Webhook-Tester-Tool, mit dem Sie die Webhooks für Ihr Unternehmen von Mist Systems einfach testen und überwachen können. Der Webhook-Tester ist hier Mist Systems Webhook-Tester verfügbar. Dies ist eine Anwendung, die automatisch die Webhook-Konfiguration in der Mist Systems Organisation erstellt und löscht, um sie zu empfangen, und die empfangenen Webhook-Nachrichten in einer Tabelle anzeigt.

Hinweis:

Nur lokale Mist Systems-Konten können diese Anwendung verwenden (SSO-Benutzer werden nicht unterstützt).
Es werden nur Administratoren mit der Rolle "Superuser" unterstützt (Webhooks auf Organisationsebene können von Superusern konfiguriert werden).

Nachfolgend finden Sie ein Diagramm, das die Funktionsweise der Anwendung erklärt.

Um den Webhook-Tester zu verwenden, gehen Sie einfach wie folgt vor:

Navigieren Sie zum Mist Systems Webhook Tester.
Wählen Sie im Konfigurations-Popupfenster Folgendes aus:
1. Max. Ereignisse im Arbeitsspeicher: Dies ist die maximale Anzahl von Ereignissen, die im Speicher der Anwendung gespeichert werden sollen.
2. Themen: Dies sind die Webhook-Themen, die empfangen werden sollen. Nur eine begrenzte Teilmenge der Webhook-Themen wird unterstützt, und alle anderen Nachrichten werden verworfen.
3. Orgs: Eine oder mehrere Mist Systems Orgs. Die Anwendung erstellt automatisch eine neue Webhook-Konfiguration für die ausgewählten Organisationen, um die aktivierten Themen an die Anwendung zu senden.
4. Klicken Sie auf Speichern.
Wenn Ereignisse eintreten, werden diese Webhooks an den Tisch gesendet, damit Sie sie überwachen und überprüfen können. Informationen wie Datum, Themen, Veranstaltungstyp, Organisation, Website, Gerätename, Geräte-MAC und Ereignisdetails werden in der Tabelle für Sie angezeigt.

Hinweis: Die Anwendung kann die Webhook-Konfiguration am Ende der Sitzung gelegentlich nicht löschen. Daher wird empfohlen, dass Sie bestätigen, dass die Webhookkonfiguration gelöscht wurde.

Weitere Informationen finden Sie unter https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file.

Testen Sie End-to-End-Konnektivität

Mit Webhooks können Sie die End-to-End-Konnektivität von Ihrer Juniper Mist Cloud-Instanz zu Ihrem definierten Webhook-Empfänger testen, um zu bestätigen, dass Sie den Webhook empfangen und verarbeiten können. Dies ist ein Webhook zum Testen, ob Webhooks funktionieren. Er erfüllt die gleiche Funktion wie ein Ping zum Testen der Netzwerkkonnektivität, aber Sie testen Ihre Webhook-Funktionalität. Dadurch wird überprüft, ob keine Geräte (eine Firewall oder ein Router) die Kommunikation zwischen den beiden Endpunkten blockieren.

Dies kann über die API erfolgen, indem ein POST (von Ihrem REST-Client) an in diesem Fall an Ihre Organisation, den konfigurierten Webhook (id), ausgegeben wird, wie in diesem Beispiel gezeigt:

Ein erfolgreiches Ergebnis sieht so aus:

Dies kann auch über das Juniper Mist Systems Portal erfolgen:

Navigieren Sie zu Organization > Admin > Einstellungen.
Suchen Sie den Abschnitt Webhooks und klicken Sie auf die Schaltfläche Webhook hinzufügen .
Wählen Sie den entsprechenden Webhook-Typ aus, geben Sie Ihrem Test-Webhook einen Namen und fügen Sie dann die Test-URL, die Sie von der kostenlosen Webhook-Testempfänger-Website erhalten haben (siehe Links oben), in das URL-Feld ein.
Wählen Sie die Webhook-Themen aus, für die Sie Nachrichten empfangen möchten, und legen Sie alle anderen erforderlichen Einstellungen fest.
Wählen Sie abschließend Hinzufügen aus.
Suchen Sie Ihren Testwebhook im Abschnitt Webhooks der Seite Organisationseinstellungen und klicken Sie auf Anzeigen , um die Übermittlungsereignisse anzuzeigen. Sie können diese Ereignisse überprüfen, um den Übermittlungsstatus von Webhooks anzuzeigen und zu bestätigen, dass Sie den Webhook erhalten und verarbeiten können.

Zusätzliche Testinformationen

Weitere Informationen zu Webhook-Tests, z. B. wie getestet wird, ob Ihr Webserver in der Lage ist, Mist Systems Webhooks zu empfangen und zu verarbeiten, finden Sie in den Informationen unter Sendungen validieren.

Informationen zum Senden eines Pingereignisses an einen Websitewebhook finden Sie unter Ping-Sitewebhook.

Informationen zum Senden eines Ping-Ereignisses an einen Organisations-Webhook finden Sie unter Ping-Organisations-Webhook.