Webhook 主题
查看可用于瞻博网络 Mist™ 组织和站点的各种 Webhook 主题。
使用下表了解更多信息。
| 主题 | 目的和有效负载详细信息 |
|---|---|
| 警报（报警） | 用户选择的设备和基础架构警报、Marvis作和安全性。若要在瞻博网络Mist门户中查找警报，请从左侧菜单中选择 “监视 > 警报 ”> “警报配置 ”。 示例
根据告警的类型，有效负载可能包括详细信息，例如组织和站点的 ID、事件类型、严重性以及聚合间隔内每种事件类型的计数。 要查看哪些警报可用并获取其有效负载的示例，请从 REST API 客户端发出以下 API 调用：GET /api/v1/const/alarm_defs |
| 审计 | 所有 Mist 配置更改都会触发此主题的主题。 有效负载包括管理员姓名和用户名、设备 ID、更改类型以及更改时间戳等详细信息。 |
| 客户端信息 |
使用此 Webhook 获取无线客户端信息事件。 有效负载包括有关客户端的详细信息，例如主机名、IP 地址、MAC 地址、组织和站点 ID 以及 IP 分配的时间戳。 |
| 客户端加入 | 仅客户端连接。 有效负载包括详细信息，例如组织和站点的 ID;客户端连接的MAC 地址和接入点名称;以及连接的 WLAN ID、频段、SSID、RSSI 和时间戳。 |
| 客户端会话 | 客户端会话信息。 有效负载包括详细信息，例如客户端漫游或断开连接的 MAC 地址和接入点名称、WLAN ID、频段、设备系列（“Mac”、“iPhone”、“Apple Watch”）、客户端制造商和型号、连接和断开连接的时间戳、浮点持续时间、RSSI 和终止原因。 |
| 设备事件 | 使用此 Webhook 可获取影响接入点、交换机和网关的可能事件列表。本主题包括端口启动或关闭、接入点电源更改和通道更改等事件。 此 Webhook 的有效负载可能包括详细信息，例如组织和站点的 ID、设备的 MAC 地址和名称以及事件的时间戳，但可能会因设备事件的确切类型而异。 要查看哪些警报可用并获取其有效负载的示例，请从 REST API 客户端发出以下 API 调用：GET /api/v1/const/device_events |
| 设备宕机 | 设备断开连接、重新连接并重新启动。 有效负载包括组织和站点的 ID、事件类型以及设备的 MAC 地址和名称等详细信息。 若要在瞻博网络Mist门户中进行配置device-updowns ，请从左侧菜单中选择 “监视 > 警报” >“ 警报配置 ”。在这里，您可以对设备类型和警报阈值进行更精细的控制。 |
| mxedge-events | 使用此 Webhook 可获取可能的 Mist Edge 事件列表，包括瞻博网络 Mist Edge 物理和 LACP 链路状态等详细信息。 |
| NAC 记账 | 使用此 Webhook 可获取网络访问控制 （NAC） 帐户事件（ACCOUNTING_START、ACCOUNTING_STOP、ACCOUNTING_UPDATE）的任何可能瞻博网络列表Mist。 有效负载包括时间戳、接入点、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 和名称以及时间戳。 |
| 主题 | 目的和有效负载详细信息 |
|---|---|
| 资产-原始-RSSI | 替换名为 asset-raw 的已弃用主题。 来自命名和过滤资产发出的数据包的原始数据。 有效负载包括组织 ID、站点、映射、接入点、天线和资产等详细信息;接入点位置;RSSI;信标 UUID 和制造商;服务数据包;和数据。 |
| 客户端延迟 |
在站点级别汇总的所有客户端设备的 DHCP、DNS 和身份验证延迟信息。以 10 分钟的间隔提供 10 分钟窗口的延迟数据。我们建议您使用此 Webhook 来接收网络延迟数据，而不是通过 API 进行轮询。
注意：
您需要订阅 Marvis 才能订阅此 Webhook。 |
| 发现-原始-RSSI | 无源 BLE 发出的数据包中的原始数据。 有效负载包括组织 ID、站点、映射、报告接入点和天线等详细信息;MAC 地址;资产/信标的资产 ID、制造商和 UUID;和 RSSI |
| 访客授权 | 访客客户端在 WLAN 上进行授权时的数据。 有效负载包括详细信息，例如 接入点、auth_method、authorized_expiring_time、运营商、客户端、公司、电子邮件、手机、名称、org_id、site_id、短信网关、sponsor_email、ssid 和 wlan_id。 |
| 定位 | 瞻博网络 Mist SDK 客户端、无线客户端和资产的位置数据。 数据包括站点和地图 ID、X 和 Y 坐标、时间戳、客户端类型以及客户端 ID 或 MAC 地址等详细信息。 |
| 位置-资产 |
瞻博网络 Mist 资产（BLE 客户端设备）的位置数据。 数据包括站点和地图 ID、X 和 Y 坐标、时间戳、资产类型和资产的 MAC 地址等详细信息。 |
| 位置中心 |
由 Mist 接入点通过 Webhook 发送到 centrak 服务器的 CenTrak 数据。 数据包括 X、Y 坐标、时间戳、站点 ID 和 Wi-Fi 信标扩展信息。根据告警事件类型，将出现不同的字段。 |
| 位置-客户端 |
瞻博网络 Mist SDK 客户端和无线客户端的位置数据。 数据包括站点和地图 ID、X 和 Y 坐标、时间戳、客户端类型和客户端 MAC 地址等详细信息。 |
| 位置-SDK |
瞻博网络 Mist SDK 客户端的位置数据。 数据包括地图 ID、客户端类型以及 X 和 Y 坐标等详细信息。 |
| 位置-unclient |
当瞻博网络 Mist SDK 客户端或无线客户端断开网络连接或在指定位置不再检测到该客户端设备时的位置数据。 有效负载数据包括地图 ID、X 和 Y 坐标、Wi-Fi 信标扩展信息和客户端 MAC 地址等详细信息。 |
| 占用率警报 | 基于配置的占用限制的占用状态。 有效负载包括详细信息，例如组织、站点、地图和区域的 ID;事件（“COMPLIANCE-VIOLATION”或“COMPLIANCE-OK”）;时间戳;入住人数限制;以及目前的入住率。 |
| RSSI 区段 | 接入点附近的设备。 本主题提供有关进入或退出接入点周围区域的设备的信息，其中 AP 接收的 RSSI 高于可配置的阈值时，接入点。您可以为每个接入点创建一个新的 RSSI 区域，并包括 RSSI 区域名称和 RSSI 区域阈值。 |
| sdkclient-scan-data | 瞻博网络 Mist SDK 客户端的位置数据。数据包括连接的频段、信道、SSID、BSSID 和 RSSI 等详细信息;接入点的 MAC 地址;相邻接入点列表;上次看到客户端的时间戳;和扫描的时间戳。 |
| v信标 | 虚拟信标附近的设备。 本主题提供有关已配置 vbeacon 附近的设备的信息。将此 Webhook 与瞻博网络 Mist SDK 配合使用。 |
wifi-conn-raw wifi-unconn-raw |
来自已连接和未连接设备发出的数据包的原始数据。 有效负载包括组织、站点、地图和报告接入点的 ID 等详细信息;接入点的位置坐标;RSSI 和频段;以及来自 Wi-Fi 信标的有效负载它不包括客户端的位置数据。 |
| 区域 | 平面图上虚拟信标的位置数据，在客户端进入或退出区域时推送。 这些数据包括站点、地图和区域 ID、时间戳、触发器（进入或退出）、客户端类型（SDK 客户端、无线客户端或资产）以及客户端的 ID 或 MAC 地址等详细信息。 |