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 をカスタマイズできます。
これらのトピックは、組織レベルで構成できます。
話題 |
形容 |
---|---|
アラート |
アラートフレームワークでサイトごとに設定可能な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データのみを送信できることを意味します。
話題 |
形容 |
---|---|
入口/退出イベント
|
クライアントがこれらのエリアの 1 つに出入りするたびにプッシュされるデータ。 |
占有アラート | 構成されたゾーン占有しきい値を超えた場合にアラートを発します。 |
SDK クライアント スキャン データ | クライアント自体に (SDK を使用して) アプリケーションをインストールしないと使用できないクライアントに関する特定のデータ。 |
X/Y座標
|
以下の一定の間隔で送信されるデータ:
|
Asset Raw | このトピックは非推奨になります。「 BLE アセット RSSI 」トピックを使用します。 |
ネットワークサービスWebhook
話題 |
形容 |
---|---|
潜在 |
サイトレベルですべてのクライアントデバイスに集約されたDHCP、DNS、認証レイテンシ情報を提供するWebhook。 |
このWebhookを購読するには、Marvisのサブスクリプションが必要です。
インフラストラクチャ 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 データを送信します。