如何在 Omada 控制器設定 Webhook

目錄

簡介

需求

設定

驗證

結論

簡介

Webhook 功能讓 Omada 基地台控制器能在預設事件發生時，例如設備連線或觸發警報，自動將即時通知推播到使用者指定的網址。透過消除持續輪詢的需要，它能立即顯示網路狀態變化，有助於實現無縫監控、警示和工作流程自動化。

需求

• Omada 軟體/硬體控制器或 Omada Central
• Webhook 伺服器

設定

本示範將按照以下步驟驗證 Webhook 的正常運作：準備一個 Webhook 伺服器，在 Omada 基地台控制器中啟用 Webhook 功能，觸發一個事件以便將相應的日誌傳輸到伺服器，然後在 Webhook 伺服器上檢查收到的資料。

步驟 1. 準備一個 Webhook 伺服器

您需要一個能夠接收並處理 Webhook 資料的伺服器。在本示範中，我們將使用 https://webhook.site/ 提供的臨時 URL 服務。請進入該網站，點擊產生的 URL，並將其複製到剪貼簿中。

步驟 2. 在基地台控制器中設定 Webhook 伺服器的位址。

接下來，在 Omada 基地台控制器中設定 Webhook 伺服器的位址。在 Global (全域) 檢視下，前往 Settings (設定) > Platform Integration (平台整合) > Webhooks。輸入您從 Webhook 網站獲得的 URL，選擇所需的 Payload (負載) 格式，並可選擇性地定義重試策略，以管理傳輸失敗時的重傳嘗試。

注意:

• 負載範本: 指的是您希望 Omada 基地台控制器在傳送 Webhook 通知時使用的資料格式和結構。目前支援兩種選項：Omada 和 Google Chat。
• 重試策略: 決定了當 Omada 基地台控制器嘗試向指定的 Webhook 伺服器位址傳送事件通知但因網路問題等原因失敗時應如何回應。None (無) 表示只傳送 Webhook 通知一次，無論成功或失敗。Important (重要) 表示控制器將在最長 60 分鐘內重試最多 5 次。Critical (關鍵) 表示控制器將在最長 24 小時內重試最多 5 次。

步驟 3. 為特定的警報或事件設定 Webhook 通知。

在基地台控制器的站點檢視中，前往 Logs (日誌) 標籤頁並找到 Notifications (通知)。依照下圖所示的步驟，根據您的需求設定是否為不同的警報或事件啟用 Webhook 通知。此時，在基地台控制器中設定 Webhooks 的過程已完成。

驗證

在為 Device Connected (設備已連線) 和 Device Disconnected (設備已離線) 事件設定 Webhook 通知後，我們按照步驟 1-3 的說明，斷開了控制器中顯示為「已連線」的設備的電源。過了一會兒，該設備重新上電並成功被控制器重新納管。檢查 Webhook 伺服器後，觀察到兩個通知：一個報告設備已離線，另一個報告設備已連線。

結論

透過設定 Omada 基地台控制器的 Webhook 功能，您可以將網路管理從「被動查詢」無縫轉換為「主動感知」。此功能設定簡單但功能強大，是建構智慧化和自動化網路運作系統的關鍵組成部分。

要了解每個功能和設定的更多詳細資訊，請前往 下載中心 下載您產品的手冊。