Webhook のテスト
パブリック Webhook レシーバーを使用して Webhook をテストし、必要なデータを取得していることを確認します。
Webhook をテストすることで、構成プロセスを検証するだけでなく、Mist から受信したイベント メッセージを検査して解析できます。利用可能なWebhookレシーバーがない場合は、パブリックの無料サービスを使用できます。このようなサービスの多くを使用すると、Juniper Mist からの受信 Webhook POST
メッセージを受信して検査できます。
これらのパブリック サイトでは、一時的に使用できるランダムな URL が作成されます。受信するデータは一時的なもので、ブラウザを閉じるとすぐに削除されます。ブラウザーからこれらのサイトの 1 つを使用して、メッセージ ペイロードからパラメーター データを識別し、ワークフローの作成に役立てることができます。
Webhook を構成したら、それをトリガーし、パブリック Webhook レシーバーで受信されたメッセージを表示できます。
これらの無料のテストWebhookレシーバーのうちの2つは次のとおりです。
これらのサイトはジュニパーが管理していないため、ご自身の責任でご利用ください。
Webhook テスター
Mist組織の Webhook を簡単にテストおよび監視するために使用できる Webhook テスター ツールがあります。Webhook テスターは、 Webhook Tester Mistこちらから入手できます。これは、Mist組織で Webhook 設定を自動的に作成および削除して受信し、受信した Webhook メッセージをテーブルに表示するアプリケーションです。
-
ローカルMistアカウントのみがこのアプリケーションを使用できます(SSOユーザーはサポートされていません)。
-
スーパーユーザーの役割を持つ管理者のみがサポートされます(組織レベルのWebhookはスーパーユーザーが構成できます)。
以下は、アプリケーションがどのように機能するかを説明する図です。
Webhook テスターを使用するには、次のようにします。
Mist Webhook テスターに移動します。
設定ポップアップウィンドウで、次を選択します。
[メモリ内の最大イベント数(Max Events in Memory)]:アプリケーションのメモリに保存されるイベントの最大数です。
トピック - 受信する Webhook トピックです。Webhook トピックの限られたサブセットのみがサポートされ、他のすべてのメッセージは破棄されます。
組織 — 1 つまたは複数の Mist 組織。アプリケーションは、選択した組織に新しい Webhook 設定を自動的に作成し、有効なトピックをアプリケーションに送信します。
「 保存」をクリックします。
イベントが発生すると、これらの Webhook がテーブルに送信され、監視および確認できます。日付、トピック、イベントタイプ、組織、サイト、デバイス名、デバイスMAC、イベントの詳細などの情報がテーブルに表示されます。
詳細については、「 https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file」を参照してください。
エンドツーエンドの接続をテストする
Webhook を使用すると、Mist Cloud インスタンスから定義済みの Webhook レシーバーへのエンドツーエンドの接続をテストして、Webhook を受信していて処理できることを確認できます。これは、Webhookが動作していることをテストするためのWebhookです。これは、ネットワーク接続をテストするための ping と同じ機能を提供しますが、Webhook 機能をテストします。これにより、2つのエンドポイント間の通信をブロックしているデバイス(ファイアウォールまたはルーター)がないことを検証します。
これは、次の例に示すように、設定済みの Webhook (id
) に対して (REST クライアントから) POST を発行することで、API から実行できます。
POST /api/v1/orgs/203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx/webhooks/032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx/ping
成功する結果は次のようになります。
{ "topic": "ping", "events": [ { "id": "032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx", "name": "my webhook", "org_id": "203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx", "timestamp": 1725375149.0829651 } ] }
これは、Juniper Mistポータルから行うこともできます。
[Organization > Admin > Settings] に移動します。
[ Webhook] セクションを見つけて、[ Webhook の追加 ] ボタンをクリックします。
適切な Webhook タイプを選択し、テスト Webhook に名前を付けてから、無料の Webhook テスト レシーバーの Web サイト (上記のリンクを参照) から取得したテスト URL を [URL ] フィールドに貼り付けます。
- メッセージを受信する Webhook トピックを選択し、その他の必要な設定を行います。
- 最後に、 [追加] を選択します。
「組織の設定」ページの「 Webhook」 セクションにリストされているテスト Webhook を見つけ、「 表示 」をクリックして配信イベントを表示します。これらのイベントを確認して Webhook の配信状態を確認し、Webhook を受信していて処理できることを確認できます。
テストに関する追加情報
Web サーバーが Mist Webhook を受信して処理できることをテストするには、 配信の検証の情報を確認します。
サイトの Webhook に ping イベントを送信する方法については、「 Ping サイト Webhook」を参照してください。
組織の Webhook に ping イベントを送信する方法については、「 Ping Org Webhook」を参照してください。