Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Webhook 階層

組織レベルの Webhook とサイトレベルの Webhook の関係を理解します。各レベルで構成できる Webhook トピックについて理解します。

Webhook 階層の概要

Juniper Mist Webhook には、組織レベルとサイト レベルの 2 つの構成階層があります。設定方法は両方で同じです。ただし、すべての Webhook が両方のレベルで使用できるわけではありません。

  • 組織レベルで使用できるすべての Webhook は、特定のサイトレベルの Webhook でも使用できます。

  • 使用可能なサイトレベルの Webhook は、組織レベルでは使用できません。

Webhook を構成するときは、階層に注意してください。

たとえば、2 つのサイトがあり、組織レベルでアラート Webhook を構成すると、両方のサイトのすべての組織レベルのアラートを受信します。

逆に、組織レベルでアラート Webhook を構成せず、2 つのサイトのいずれかでのみアラート Webhook を構成した場合、その 1 つのサイトに対してのみアラートを受信します。

最後に、組織レベルでアラート Webhook を構成し、1 つのサイトを構成すると、Webhook レシーバーは重複するメッセージを受信します (同じレシーバー URL に送信されると仮定)。

API から 1 つの Webhook (およびそのトピック) に対して複数の Webhook レシーバーを設定できます。使用可能なすべてのトピックを含む 1 つの Webhook を用意し、Webhook 受信者が受信したメッセージから必要な情報を解析することをお勧めします。

組織の Webhook

組織 Webhook は、組織のデータを指定された URL にプッシュできるようにする構成です。特定の組織からデータを取得できる Mist RESTful API を使用して組織の Webhook をカスタマイズできます。

これらのトピックは、組織レベルで構成できます。

表 1: 組織の Webhook

話題

形容

アラート

アラートフレームワークでサイトごとに設定可能なJuniper Mist定義のアラームイベント。

監査

Juniper Mistダッシュボードから行われた構成変更を追跡するトピック。

クライアント参加

クライアントがワイヤレス ネットワークに参加するたびにトリガー Juniper Mist Webhook。

クライアント情報

各クライアントに関する情報を含むトピック。

クライアントセッション

クライアント・セッションに関する情報を含むトピック。

デバイスイベント

デバイス(現在は AP、スイッチ、ゲートウェイ)で発生するイベントに固有のトピック

デバイスアップ/ダウン

デバイスが起動または停止したときにメッセージを生成するトピック。

Juniper Mist Edge イベント

Juniper Mist Edge のポートとリンクの状態の変更、および Link Aggregation Control Protocol (LACP) のポートとリンクの変更に関するメッセージを生成するトピック。

サイト Webhook

サイト Webhook は、サイトのデータとイベントを指定された URL にプッシュできるようにする構成です。Mist API を使用してサイトの Webhook をカスタマイズし、特定のサイトからデータを取得できるようにすることができます。

これらのトピックは、サイト レベルで構成できます。トピックは、標準と高度な 2 つのカテゴリに分類されます。Webhook の [詳細] カテゴリで 1 つのトピックを選択するか、[標準] カテゴリで複数のトピックを選択できます。両方のカテゴリからトピックを選択することはできません。

ロケーション Webhook

ロケーション Webhook を使用するには、Juniper Mist ポータルから正確な AP 配置を含むフロアプランをアップロードし、クライアント データを関連付ける必要があります。詳細については、Juniper Mist 屋内位置情報サービス: ガイドの「 フロアプラン設定の概要 」を参照してください。

[場所の座標] トピックを選択すると、接続済み、未接続、および Centrak Webhook のサブトピックを含む新しい WiFi クライアント トピックが表示されます。Centrakユーザーの場合、これは、接続されていないWi-FiをCentrak Wi-Fiロケーションタグ(OUI:00:12:b8)から切り離すことができる、つまり、接続されていないすべてのWi-Fiクライアントではなく、Centrakデータのみを送信できることを意味します。

表 2:ロケーション Webhook

話題

形容

入口/退出イベント
  • ロケーションゾーン

  • 近接ゾーン

  • 仮想ビーコン

クライアントがこれらのエリアの 1 つに出入りするたびにプッシュされるデータ。
占有アラート 構成されたゾーン占有しきい値を超えた場合にアラートを発します。
SDK クライアント スキャン データ クライアント自体に (SDK を使用して) アプリケーションをインストールしないと使用できないクライアントに関する特定のデータ。
X/Y座標
  • 名前付きアセット

  • SDK クライアント

以下の一定の間隔で送信されるデータ:
  • 名前付きアセットの場合は約 2 秒です。

  • SDK クライアントの場合は約 1 秒です。

Asset Raw

このトピックは非推奨になります。「 BLE アセット RSSI 」トピックを使用します。

ネットワークサービスWebhook

表 3:ネットワーク サービス Webhook

話題

形容

潜在

サイトレベルですべてのクライアントデバイスに集約されたDHCP、DNS、認証レイテンシ情報を提供するWebhook。

手記:

このWebhookを購読するには、Marvisのサブスクリプションが必要です。

インフラストラクチャ Webhook

表 4:インフラストラクチャ Webhook

話題

形容

アラート

アラートフレームワークでサイトごとに設定可能なJuniper Mist定義のアラームイベント。

監査

Juniper Mistダッシュボードから行われた構成変更を追跡するトピック。

クライアント情報

各クライアントに関する情報を含む Webhook。

クライアント参加

クライアントがワイヤレス ネットワークに参加するたびにトリガー Juniper Mist Webhook。

クライアントセッション

クライアント セッションに関する情報を含む Webhook。

デバイスイベント

デバイス(現在は AP、スイッチ、ゲートウェイ)で発生するイベントに固有のトピック

デバイスアップ/ダウン

デバイスが起動または停止したときにメッセージを生成するトピック。

Mist Edgeイベント

Juniper Mist Edge のポートとリンクの状態の変更、および Link Aggregation Control Protocol (LACP) のポートとリンクの変更に関するメッセージを生成するトピック。

BLEアセットRSSI

BLE アセット RSSI トピックは、指定されたアセットに基づいてテレメトリ BLE データを送信します。