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 的配置层次结构:组织级别和站点级别。两者的配置方法是相同的;但是,并非所有 Webhook 在这两个级别都可用。

  • 在组织级别可用的所有 Webhook 也可用于特定的站点级别 Webhook。

  • 可用的站点级别 Webhook 在组织级别不可用。

配置 Webhook 时请注意层次结构。

例如,如果您有两个站点,并且在组织级别配置了警报 Webhook,则您将收到这两个站点的所有组织级别警报。

相反,如果未在组织级别配置警报 Webhook,而仅在两个站点之一上配置警报 Webhook,则将仅收到该单个站点的警报。

最后,如果在组织级别和单个站点配置警报 Webhook,则 Webhook 接收方将收到重复的消息(假设它们被发送到相同的接收方 URL)。

您可以从 API 为单个 Webhook(及其主题)配置多个 Webhook 接收器。建议使用一个包含所有可用主题的 Webhook,然后从 Webhook 接收方收到的消息中解析所需的信息。

组织 Webhook

组织 Webhook 是一种配置,用于将组织数据推送到指定的 URL。您可以使用 Mist RESTful API 自定义组织 Webhook,它使您能够从特定组织获取数据。

您可以在组织级别配置以下主题:

表 1:组织 Webhook

主题

描述

警报

Juniper Mist定义的报警事件,可在警报框架中按站点配置。

审计

跟踪从 Juniper Mist 仪表板进行的配置更改的主题。

客户端加入

每当客户端加入无线网络时Juniper Mist触发的 Webhook。

客户端信息

一个主题,其中包含有关每个客户端的信息。

客户端会话

包含有关客户端会话的信息的主题。

设备事件

特定于设备(当前是接入点、交换机和网关)上发生的事件的主题

设备启动/故障

在设备启动或关闭时生成消息的主题。

Juniper Mist Edge 活动

为Juniper Mist Edge 端口和链路状态更改以及链路聚合控制协议 (LACP) 端口和链路更改生成消息的主题。

站点 Webhook

站点 Webhook 是一种配置,可将站点数据和事件推送到指定 URL。您可以使用 Mist API 自定义站点 Webhook,以便从特定站点获取数据。

您可以在站点级别配置这些主题。这些主题分为两类:标准和高级。您可以在“高级”类别下选择一个主题,也可以在“标准”类别下选择多个主题作为 Webhook。您不能同时从两个类别中选择主题。

位置 Webhook

要使用位置 Webhook,您必须通过 Juniper Mist 门户上传包含准确接入点放置的平面图,以关联客户端数据。有关详细信息,请参阅 Juniper Mist 定位服务 指南中的 平面图设置概述

请注意,当您选择“位置坐标”主题时,将显示一个新的“WiFi 客户端”主题,其中包括“已连接”、“未连接”和 Centrak Webhook 的子主题。对于 Centrak 用户,这意味着您可以将未连接的 Wi-Fi 与 Centrak Wi-Fi 位置标签 (OUI: 00:12:b8) 分离,即仅发送 Centrak 数据,而不是每个未连接的 Wi-Fi 客户端。

表 2:位置 Webhook

主题

描述

进入/退出事件
  • 定位区域

  • 邻近区域

  • 虚拟信标

每当客户端进入或退出其中一个区域时,都会推送数据。
入住警报 有关超过已配置区域占用阈值的警报。
SDK 客户端扫描数据 有关客户端的特定数据,如果不在客户端本身上安装应用程序(使用 SDK),则该数据将不可用。
X/Y 坐标
  • 命名资产

  • SDK 客户端

定期发送以下数据:
  • 对于命名资产,大约需要 2 秒。

  • 对于 SDK 客户端,大约需要 1 秒。

资产原始

本主题将被弃用。使用 BLE 资产 RSSI 主题。

网络服务 Webhook

表 3:网络服务 Webhook

主题

描述

延迟

一个 Webhook,提供在站点级别跨所有客户端设备聚合的 DHCP、DNS 和身份验证延迟信息。

注意:

您需要订阅 Marvis 才能订阅此 Webhook。

基础架构 Webhook

表 4:基础架构 Webhook

主题

描述

警报

Juniper Mist定义的报警事件,可在警报框架中按站点配置。

审计

跟踪从 Juniper Mist 仪表板进行的配置更改的主题。

客户端信息

包含有关每个客户端的信息的 Webhook。

客户端加入

每当客户端加入无线网络时Juniper Mist触发的 Webhook。

客户端会话

包含有关客户端会话的信息的 Webhook。

设备事件

特定于设备(当前是接入点、交换机和网关)上发生的事件的主题

设备启动/故障

在设备启动或关闭时生成消息的主题。

Mist Edge 事件

为Juniper Mist Edge 端口和链路状态更改以及链路聚合控制协议 (LACP) 端口和链路更改生成消息的主题。

BLE 资产 RSSI

BLE 资产 RSSI 主题基于命名资产发送遥测 BLE 数据。