Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

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 テスターを使用するには、次のようにします。

  1. Mist Webhook テスターに移動します。

  2. 設定ポップアップウィンドウで、次を選択します。

    1. [メモリ内の最大イベント数(Max Events in Memory)]:アプリケーションのメモリに保存されるイベントの最大数です。

    2. トピック - 受信する Webhook トピックです。Webhook トピックの限られたサブセットのみがサポートされ、他のすべてのメッセージは破棄されます。

    3. 組織 — 1 つまたは複数の Mist 組織。アプリケーションは、選択した組織に新しい Webhook 設定を自動的に作成し、有効なトピックをアプリケーションに送信します。

    4. 保存」をクリックします。

  3. イベントが発生すると、これらの Webhook がテーブルに送信され、監視および確認できます。日付、トピック、イベントタイプ、組織、サイト、デバイス名、デバイスMAC、イベントの詳細などの情報がテーブルに表示されます。

手記:アプリケーションは、セッションの終了時に Webhook 構成を削除できない場合があります。そのため、Webhook 設定が削除されたことを確認することをお勧めします。

詳細については、「 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 から実行できます。

成功する結果は次のようになります。

これは、Juniper Mistポータルから行うこともできます。

  1. [Organization > Admin > Settings] に移動します。

  2. [ Webhook] セクションを見つけて、[ Webhook の追加 ] ボタンをクリックします。

  3. 適切な Webhook タイプを選択し、テスト Webhook に名前を付けてから、無料の Webhook テスト レシーバーの Web サイト (上記のリンクを参照) から取得したテスト URL を [URL ] フィールドに貼り付けます。

  4. メッセージを受信する Webhook トピックを選択し、その他の必要な設定を行います。
  5. 最後に、 [追加] を選択します。

  6. 「組織の設定」ページの「 Webhook」 セクションにリストされているテスト Webhook を見つけ、「 表示 」をクリックして配信イベントを表示します。これらのイベントを確認して Webhook の配信状態を確認し、Webhook を受信していて処理できることを確認できます。

テストに関する追加情報

Web サーバーが Mist Webhook を受信して処理できることをテストするには、 配信の検証の情報を確認します。

サイトの Webhook に ping イベントを送信する方法については、「 Ping サイト Webhook」を参照してください。

組織の Webhook に ping イベントを送信する方法については、「 Ping Org Webhook」を参照してください。