Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Webhookトピック

ジュニパーMist™の組織およびサイトで利用できるさまざまなWebhookトピックを確認します。

組織、サイト、またはその両方のレベルでWebhookを有効にした後、メッセージを受信するトピックを選択します。

詳細については、以下の表を使用してください。

表1:組織とサイトの両方のトピック
トピック の目的とペイロードの詳細
アラート(アラーム)

デバイスとインフラストラクチャ、Marvisアクション、セキュリティに関するユーザーが選択したアラーム。ジュニパー Mistポータルでアラートを検索するには、左側のメニューから監視>アラート>アラート設定を選択します。

使用例

  • デバイスとインフラストラクチャ:デバイスのダウン、デバイスの再起動、VPNピアのダウン、ARP障害、DNS障害。
  • Marvis:ケーブルの障害、APのヘルスチェックの失敗、Wi-Fiカバレッジの低さ、ポートフラッピング、WANアップリンクの不良。
  • セキュリティ:KRACK攻撃、TKIP ICV攻撃、不正クライアント、不正AP、ハニーポット。

アラームのタイプに応じて、ペイロードには、組織やサイトのID、イベントタイプ、重大度、集約間隔中の各イベントタイプのカウントなどの詳細が含まれる場合があります。

どのアラームが利用可能かを確認し、そのペイロードの例を取得するには、REST API クライアントから次の API 呼び出しを発行します。 GET /api/v1/const/alarm_defs
監査

すべてのMist設定変更がこのトピックをトリガーするトピック。

ペイロードには、管理者の名前とユーザー名、デバイスID、変更のタイプ、変更のタイムスタンプなどの詳細が含まれます。

クライアント情報

このWebhookを使用して、無線クライアント情報イベントを取得します。

ペイロードには、ホスト名、IPアドレス、MACアドレス、組織とサイトID、IP割り当てのタイムスタンプなど、クライアントに関する詳細が含まれます。

クライアント参加

クライアント接続のみ。

ペイロードには、組織やサイトのIDなどの詳細が含まれます。クライアントが接続したAPのMACアドレスと名前。接続用のWLAN ID、帯域、SSID、RSSI、タイムスタンプです。
クライアントセッション

クライアントセッション情報。

ペイロードには、クライアントがローミングまたは切断したAPのMACアドレスと名前、WLAN ID、帯域、デバイスファミリー(「Mac」、「iPhone」、「Apple Watch」)、クライアントのメーカーとモデル、接続と切断のタイムスタンプ、フロート期間、RSSI、終了理由などの詳細が含まれます。
デバイスイベント

このWebhookを使用して、アクセスポイント、スイッチ、ゲートウェイに影響を与える可能性のあるイベントのリストを取得できます。このトピックには、ポートのアップまたはダウン、AP電源の変更、チャネルの変更などのイベントが含まれます。

このWebhookのペイロードには、組織やサイトのID、デバイスのMACアドレスと名前、イベントのタイムスタンプなどの詳細が含まれる場合がありますが、デバイスイベントの正確なタイプによって異なる場合があります。

使用可能なアラームとそのペイロードの例を確認するには、REST API クライアントから次の API 呼び出しを発行します。 GET /api/v1/const/device_events
デバイスのアップダウン

デバイスの切断、再接続、再起動。

ペイロードには、組織とサイトのID、イベントのタイプ、デバイスのMACアドレスと名前などの詳細が含まれます。

ジュニパー Mistポータルでdevice-updownsを設定するには、左側のメニューから監視>アラート>アラート設定を選択します。ここでは、デバイスのタイプとアラートしきい値をより詳細に制御できます。
mxedgeイベント このWebhookを使用して、ジュニパーMist Edgeの物理的ステータスやLACPリンクステータスなどの詳細を含む、可能性のあるMist Edgeイベントのリストを取得できます。
NACアカウンティング このWebhookを使用して、可能性のあるジュニパー Mistネットワークアクセス制御(NAC)アカウントイベント(ACCOUNTING_START、ACCOUNTING_STOP、ACCOUNTING_UPDATE)のリストを取得します。

ペイロードには、タイムスタンプ、AP、client_ip、SSID、ユーザー名、client_type、client_mac、nas_vendor、site_id、rx_pkts、tx_pktsなどの詳細が含まれます。

NACイベント

このWebhookは、ジュニパーMistネットワークアクセス制御(NAC)イベントでトリガーされます。

ペイロードには、auth_type、bssid、idp_role、random_mac、resp_attrsなどの詳細が含まれる場合がありますが、nacイベントのタイプによって異なる場合があります。

ping

Webhook URLに送信されるpingイベント。

ペイロードには、サイトID、Webhook IDと名前、タイムスタンプが含まれます。
表2:サイトのみのトピック
トピック の目的とペイロードの詳細
アセット生RSSI

asset-raw という名前の非推奨のトピックを置き換えます。

名前付きアセットとフィルタリングされたアセットから発行されたパケットからの生データ。

ペイロードには、組織のID、サイト、マップ、AP、アンテナ、アセットなどの詳細が含まれます。APの場所。RSSI;ビーコン UUID とメーカー。サービスパケット。そしてデータ。

クライアント遅延

サイトレベルのすべてのクライアントデバイスに集約されたDHCP、DNS、認証遅延情報。遅延データは、10分間隔で10分間のウィンドウで提供されます。APIを介してポーリングするのではなく、このWebhookを使用してネットワーク遅延データを受信することをお勧めします。

注:

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

discovered-raw-rssi

パッシブ BLE から発信されたパケットからの生データ。

ペイロードには、組織のID、サイト、マップ、レポートAP、アンテナなどの詳細が含まれます。MACアドレス。アセット/ビーコンのアセットID、メーカー、UUID。とRSSI。
ゲスト認証

ゲストクライアントが WLAN で認証するときのデータ。

ペイロードには、AP、auth_method、authorized_expiring_time、キャリア、クライアント、会社、電子メール、モバイル、名前、org_id、site_id、SMSゲートウェイ、sponsor_email、ssid、wlan_idなどの詳細が含まれます。

場所

ジュニパー Mist SDKクライアント、無線クライアント、アセットの位置データ。

データには、サイトおよびマップID、XおよびY座標、タイムスタンプ、クライアントのタイプ、クライアントIDまたはMACアドレスなどの詳細が含まれます。

ロケーションアセット

ジュニパー Mist アセット(BLE クライアント デバイス)の位置データ。

データには、サイトとマップID、X座標とY座標、タイムスタンプ、アセットのタイプ、アセットのMACアドレスなどの詳細が含まれます。

ロケーションセントリック

Mist APがWebhook経由でcentrakサーバーに送信するCenTrakデータ。

データには、X、Y座標、タイムスタンプ、サイトID、Wi-Fiビーコン拡張情報が含まれます。アラームイベントの種類に応じて、異なるフィールドが表示されます。

ロケーションクライアント

ジュニパー Mist SDK クライアントと無線クライアントのロケーション データ。

データには、サイトとマップID、X座標とY座標、タイムスタンプ、クライアントのタイプ、クライアントMACアドレスなどの詳細が含まれます。

ロケーション-SDK

ジュニパー Mist SDK クライアントのロケーション データ。

データには、マップID、クライアントのタイプ、X座標とY座標などの詳細が含まれます。

ロケーションアンクライアント

クライアントデバイスがネットワークから切断されたとき、または指定された場所で検出されなくなったときの、ジュニパー Mist SDKクライアントまたは無線クライアントの位置データ。

ペイロードデータには、マップID、X座標とY座標、Wi-Fiビーコン拡張情報、クライアントMACアドレスなどの詳細が含まれます。

占有アラート

設定された占有制限に基づく占有ステータス。

ペイロードには、組織、サイト、マップ、ゾーンの ID などの詳細が含まれます。イベント(「COMPLIANCE-VIOLATION」または「COMPLIANCE-OK」)。タイムスタンプ。占有制限。そして現在の占有率。
RSSIゾーン

アクセスポイントの近くにあるデバイス

このトピックでは、APが受信したRSSIが設定可能なしきい値を超えているAP周辺のゾーンに出入りするデバイスに関する情報を提供します。各APに新しいRSSIゾーンを作成し、RSSIゾーン名とRSSIゾーンしきい値を含めることができます。
sdkclient-scan-data ジュニパー Mist SDK クライアントのロケーション データ。データには、接続の帯域、チャネル、SSID、BSSID、RSSIなどの詳細が含まれます。APのMACアドレス。隣接するAPのリスト。クライアントが最後に表示されたときのタイムスタンプ。スキャンのタイムスタンプが表示されます。
vビーコン

仮想ビーコンの近くにあるデバイス。

このトピックでは、設定されたvbeaconの近接デバイスに関する情報を提供します。このWebhookをジュニパー Mist SDKと併用します。

wifi-conn-raw

wifi-unconn-raw

接続されたデバイスと未接続のデバイスから発信されたパケットからの生データ。

ペイロードには、組織、サイト、マップ、レポートAPのIDなどの詳細が含まれます。APの位置座標。RSSIとバンド。Wi-Fiビーコンからのペイロード。クライアントの位置データは含まれません。
ゾーン

クライアントがゾーンに出入りしたときにプッシュされる、フロアプラン上の仮想ビーコンの位置データ。

データには、サイト、マップ、ゾーンID、タイムスタンプ、トリガー(開始または終了)、クライアントタイプ(SDKクライアント、無線クライアント、またはアセット)、クライアントのIDまたはMACアドレスなどの詳細が含まれます。