AUF DIESER SEITE
Testen von Webhooks
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 erhalten, überprüfen und analysieren. Wenn Ihnen kein Webhookempfänger zur Verfügung steht, können Sie einen öffentlichen, kostenlosen Dienst verwenden. Viele dieser Dienste ermöglichen es Ihnen, die eingehenden Webhook-Nachrichten POST
von Juniper Mist zu empfangen und zu überprüfen.
Diese öffentlichen Websites erstellen eine zufällige URL, die Sie vorübergehend verwenden können. Die Daten, die Sie erhalten, sind flüchtig 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 kostenlosen Webhook-Empfänger zum Testen sind:
Diese Websites werden nicht von Juniper gepflegt und die Nutzung erfolgt auf eigenes Risiko.
Webhook-Tester
Es gibt ein Webhook-Tester-Tool, mit dem Sie die Webhooks für Ihre Mist Organisation einfach testen und überwachen können. Den Webhook-Tester finden Sie hier Mist Webhook-Tester. Dabei handelt es sich um eine Anwendung, die die Webhook-Konfiguration in der Mist-Organisation automatisch erstellt und löscht, um sie zu empfangen, und die empfangenen Webhook-Nachrichten in einer Tabelle anzeigt.
-
Diese Anwendung kann nur von lokalen Mist Konten verwendet werden (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, in dem die Funktionsweise der Anwendung erläutert wird.
Um den Webhook-Tester zu verwenden, gehen Sie einfach wie folgt vor:
Navigieren Sie zum Mist Webhook-Tester.
Wählen Sie im Pop-up-Fenster "Konfiguration" Folgendes aus:
Max. Ereignisse im Arbeitsspeicher: Dies ist die maximale Anzahl von Ereignissen, die im Arbeitsspeicher der Anwendung gespeichert werden sollen.
Themen: Dies sind die Webhook-Themen, die empfangen werden sollen. Es wird nur eine begrenzte Teilmenge der Webhook-Themen unterstützt, und alle anderen Nachrichten werden verworfen.
Organisationen: Eine oder mehrere Mist-Organisationen. Die Anwendung erstellt automatisch eine neue Webhook-Konfiguration für die ausgewählten Organisationen, um die aktivierten Themen an die Anwendung zu senden.
Klicken Sie auf Speichern.
Wenn Ereignisse auftreten, werden diese Webhooks zur Überwachung und Überprüfung an die Tabelle gesendet. Informationen wie Datum, Themen, Ereignistyp, Organisation, Website, Gerätename, Geräte-MAC und Ereignisdetails werden in der Tabelle für Sie angezeigt.
Weitere Informationen finden Sie unter https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file.
End-to-End-Konnektivität testen
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, um zu 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 sichergestellt, dass keine Geräte (eine Firewall oder ein Router) die Kommunikation zwischen den beiden Endgeräten blockieren.
Dies kann über die API erfolgen, indem ein POST (von Ihrem REST-Client) an Ihre Organisation, den konfigurierten Webhook (id
) ausgegeben wird, wie in diesem Beispiel zu sehen:
POST /api/v1/orgs/203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx/webhooks/032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx/ping
Ein erfolgreiches Ergebnis sieht folgendermaßen aus:
{ "topic": "ping", "events": [ { "id": "032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx", "name": "my webhook", "org_id": "203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx", "timestamp": 1725375149.0829651 } ] }
Dies kann auch über das Juniper Mist Portal erfolgen:
Navigieren Sie zu Organisations - > 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 (siehe Links oben) erhalten haben, in das URL-Feld ein.
- Wählen Sie die Webhook-Themen aus, für die Sie Nachrichten erhalten möchten, und legen Sie alle anderen erforderlichen Einstellungen fest.
- Wählen Sie abschließend Hinzufügen aus.
Suchen Sie Ihren Testwebhook, der auf der Seite "Organisationseinstellungen" im Abschnitt "Webhooks" aufgeführt ist, und klicken Sie auf "Anzeigen ", um die Übermittlungsereignisse anzuzeigen. Sie können diese Ereignisse überprüfen, um den Übermittlungsstatus von Webhooks anzuzeigen, um zu bestätigen, dass Sie den Webhook empfangen und verarbeiten können.
Zusätzliche Testinformationen
Um zu testen, ob Ihr Webserver in der Lage ist, Mist Webhooks zu empfangen und zu verarbeiten, überprüfen Sie die Informationen unter Sendungen validieren.
Informationen zum Senden eines Ping-Ereignisses an einen Website-Webhook finden Sie unter Ping-Site-Webhook.
Informationen zum Senden eines Ping-Ereignisses an einen Organisations-Webhook finden Sie unter Ping-Organisations-Webhook.