Cambium Networks cnPilot 與 cnMaestro 與 Purple WiFi 整合
本權威指南詳細介紹了 Cambium Networks cnPilot 無線基地台和 cnMaestro 雲端控制器與 Purple WiFi 智慧平台的整合。內容涵蓋架構、Captive Portal 設定、Walled Garden 需求、802.1X 員工 WiFi,以及在多租戶環境中使用 Cambium ePSK 的動態 VLAN 區隔。
收聽此指南
查看播客逐字稿

執行摘要
對於標準化採用 Cambium Networks 基礎架構的企業場所而言,部署生產級的訪客 WiFi 解決方案需要無線存取層與身分識別管理平台之間的緊密整合。本指南為將 Cambium cnPilot 無線基地台和 cnMaestro 雲端控制器與 Purple WiFi 進行整合提供了決定性的藍圖。藉由將 Cambium 的可擴充硬體與 Purple 的 Captive Portal、RADIUS 驗證和分析功能相結合,IT 團隊可以將其無線網路從成本中心轉變為策略性資產。此處詳細介紹的架構支援從基本訪客存取到使用 Cambium 私有預共用金鑰 (PPSK) 的複雜多租戶區隔等所有功能,在餐旅、零售和公共部門環境中提供安全、合規且富含數據的連線能力。
技術深度探討
Cambium Networks 與 Purple 之間的整合依賴於標準的 HTTP 重新導向和 RADIUS 協定。這種與廠商無關的方法可確保強大的安全性、跨平台相容性,以及透過 cnMaestro 進行集中式管理。
整合架構
核心機制涉及由 Cambium AP 管理的 Captive Portal 重新導向,以及由 Purple 管理的 RADIUS 驗證。

當訪客裝置與開放的訪客 SSID 建立關聯時,Cambium AP 會攔截初始的 HTTP 請求。AP 不會將流量路由到網際網路,而是將裝置重新導向至 Purple 代管的 Captive Portal URL。訪客在 Purple 歡迎頁面上完成驗證流程,該頁面支援社群登入、電子郵件註冊和自訂數據收集表單。
驗證成功後,Purple 的後端會在 UDP 連接埠 1812 上向 Cambium AP 傳送 RADIUS Access-Accept 訊息。此訊息指示 AP 將用戶端裝置從驗證前的 Walled Garden 狀態轉換為完整的網路存取狀態。同時,AP 會在 UDP 連接埠 1813 上向 Purple 傳送 RADIUS 計費數據,從而將工作階段持續時間、數據使用量和裝置類型資訊填入 Purple 的分析儀表板。
Walled Garden 需求
Walled Garden 是 Captive Portal 流程的關鍵組成部分。它定義了未驗證裝置可以連線的特定 IP 位址和網域。如果 Walled Garden 設定錯誤,裝置將無法載入 Purple 入口網站,從而導致連線逾時。
為了使整合正常運作,Walled Garden 必須包含 Purple 的入口網站網域、託管入口網站資產的任何內容傳遞網路 (CDN) 端點,以及任何支援的身分識別提供者(例如 Facebook、Google 或 Microsoft Entra ID)的網域。
使用 Cambium ePSK 的多租戶區隔
Cambium 對私有預共用金鑰(品牌名稱為 ePSK)的實現,允許網路架構師在不廣播多個 SSID 的情況下安全地區隔流量。

透過 ePSK,單一 SSID 支援最多 2,000 個唯一的密碼。每個密碼都會對應到特定的 VLAN。當使用者使用其唯一的金鑰連線時,Cambium AP 會自動將其流量放置到分配的 VLAN 上。此功能對於多租戶環境(例如共享工作空間或住宅大樓)非常寶貴,因為在這些環境中,每個租戶都需要一個隔離的網路區段。Purple 透過 cnMaestro API 管理 ePSK 生命週期來與此架構整合,從而自動化租戶憑證的佈署、VLAN 分配和撤銷。
實作指南
部署 Cambium 和 Purple 整合需要在 cnMaestro 雲端主控台中進行精確設定。請按照以下步驟建立基準訪客 WiFi 服務。
1. 設定訪客 WLAN
導覽至 cnMaestro 中的 Configuration(設定)功能表,選取 WiFi Profiles(WiFi 設定檔),然後開啟 WLANs 索引標籤。建立一個新的 WLAN 設定檔。
- Name / SSID:定義訪客網路名稱(例如 "Venue Guest WiFi")。
- Security:設定為 Open(開放)。
- Client Isolation:設定為 Enable(啟用),以防止訪客裝置在本地子網路上互相通訊。
2. 啟用外部熱點
在 WLAN 設定中,找到 Guest Access(訪客存取)區段。
- Enable Guest Access:勾選此方塊。
- Portal Type:選取 External Hotspot(外部熱點)。
- External Page URL:輸入您的 Purple 客戶經理提供的特定 Captive Portal URL。
3. 設定 RADIUS 驗證和計費
在同一個 Guest Access 區段中,設定 RADIUS 參數。
- Authentication Server:輸入 Purple 的主要 RADIUS 伺服器 IP 位址。
- Authentication Port:
1812 - Accounting Server:輸入 Purple 的主要 RADIUS 伺服器 IP 位址。
- Accounting Port:
1813 - Shared Secret:輸入 Purple 提供的複雜共用金鑰。確保這在兩個平台上完全一致。
4. 定義 Walled Garden
在 External Hotspot 設定下,填寫 Walled Garden 清單。您必須新增核心 Purple 網域以及您所選驗證方法(例如社群登入提供者)所需的特定網域。
5. 為員工 WiFi 設定 802.1X
若要保護員工存取安全,請在 cnMaestro 中建立一個獨立的 WLAN 設定檔。
- Security:設定為 WPA2-Enterprise。
- RADIUS Server:指向連接埠 1812 上的 Purple RADIUS 伺服器 IP。
員工透過 Microsoft Entra ID 或 Google Workspace 使用其企業憑證進行驗證,Purple 進行驗測試。Purple 隨後會傳回 Tunnel-Private-Group-ID RADIUS 屬性,指示 Cambium AP 將員工裝置分配到安全的企業 VLAN。
最佳做法
- VLAN Trunking:確保連接到 Cambium AP 的交換器連接埠上已對所有必要的 VLAN(訪客、員工、管理)進行 Trunking 設定。如果 Trunk 中缺少該 VLAN,已驗證的用戶端將無法透過 DHCP 取得 IP 位址。
- 韌體一致性:將您的 AP 設備標準化為 cnPilot 韌體版本 6.0 或更高版本。此版本針對外部熱點重新導向和 ePSK 功能提供了最穩定的支援。
- 必須啟用計費 (Accounting):切勿停用 RADIUS 計費。Purple 完全依賴 UDP 1813 計費串流來產生停留時間指標、造訪頻率數據和合規記錄。
- 避免員工使用本機 PSK:將員工網路的傳統共享密碼替換為 802.1X 驗證。此方法透過將網路存取與可稽核的個人身分綁定,符合 ISO 27001 的要求。
疑難排解與風險降低
當整合出現問題時,通常會表現在初始 Captive Portal 重新導向或 RADIUS 驗證階段。
- Portal 無法載入:這幾乎總是 Walled Garden(圍牆花園)的問題。如果訪客裝置連線到 SSID,但收到連線逾時而非歡迎頁面,則表示 AP 正在封鎖對 Purple Portal 網域的存取。請驗證您在 cnMaestro 中的 Walled Garden 項目,並確保在驗證前允許 DNS 解析。
- 驗證失敗(憑證無效錯誤):檢查 RADIUS 共用金鑰。cnMaestro 與 Purple 之間的不一致會導致 RADIUS 伺服器直接捨棄驗證請求。
- 裝置已驗證但無法存取網際網路:這表示動態 VLAN 分配或 DHCP 程序失敗。請驗證 Purple 是否在 RADIUS 回應中傳回正確的 VLAN ID,並確認交換器連接埠的 Trunking 設定允許該 VLAN。
投資報酬率 (ROI) 與業務影響
在 Cambium Networks 基礎架構上部署 Purple WiFi,能將標準的網路工具轉化為可衡量的商業資產。透過在驗證時收集第一方數據,場所可以建立全面的訪客輪廓並推動精準的行銷活動。
例如,Harrods 實施了 Purple Guest WiFi,並透過將收集到的數據與其會員計劃整合,實現了 57 倍的行銷投資報酬率。同樣地,AGS Airports 透過利用分級頻寬和針對性的旅客互動,創造了 842% 的投資報酬率。藉由標準化採用 Cambium cnMaestro 和 Purple,IT 主管可以提供安全、合規的連線,同時為行銷部門提供推動營收所需的數據。
關鍵定義
Captive Portal
自訂的登入頁面,要求使用者在存取公共或企業 WiFi 網路之前進行驗證或接受條款。
用於訪客 WiFi 部署,在授予網際網路存取權限之前收集第一方數據、執行可接受的使用政策並展示場所品牌。
RADIUS
遠端使用者撥入驗證服務;一種提供集中式驗證、授權和計費 (AAA) 管理的網路協定。
Cambium AP 用於與 Purple 通訊以驗證使用者憑證並回報工作階段數據的協定。
Walled Garden
一個限制性的環境,用於在驗證前控制使用者對網頁內容和服務的存取。
在 cnMaestro 中為必要設定,以便在訪客裝置獲得完整網際網路存取權限之前,允許其連線至 Purple 歡迎頁面和身分識別提供者網域(例如 Facebook 或 Google)。
ePSK
增強型預共用金鑰;Cambium 對私有預共用金鑰的實現方式,允許在單一 SSID 上為個別使用者提供唯一的密碼。
用於為多租戶環境提供安全、隔離的網路區段,而無需廣播多個 SSID。
Dynamic VLAN Assignment
根據 RADIUS 屬性而非實體連接埠或 SSID,將已驗證的裝置分配到特定虛擬區域網路 (VLAN) 的程序。
允許 IT 人員使用單一 SSID,同時安全地將訪客流量與員工或管理流量隔離開來。
802.1X
一項用於基於連接埠之網路存取控制的 IEEE 標準,為希望連線至 LAN 或 WLAN 的裝置提供驗證機制。
用於安全員工 WiFi 的標準,以向身分識別提供者驗證的個人企業憑證取代共用密碼。
cnMaestro
Cambium Networks 的雲端或地端管理平台,用於集中控制無線和有線網路基礎架構。
網路架構師設定 WLAN 設定檔、RADIUS 設定以及 Purple 整合所需之 Walled Garden 的介面。
First-Party Data
公司直接從其客戶收集並完全擁有的資訊。
Purple 訪客 WiFi 部署的主要業務產出,用於推動行銷活動並瞭解訪客行為。
範例
一間擁有 200 間客房的飯店需要為房客、員工和會議中心部署安全的 WiFi。房客需要品牌專屬的 Captive Portal,員工需要安全存取內部系統,而會議中心則需要為不同的活動主辦方提供隔離的網路。網路架構師應如何設定 Cambium cnMaestro環境,以使用 Purple 支援此需求?
架構師應在 cnMaestro 中部署三個不同的 WLAN 設定檔。
- 訪客 WLAN:設定為啟用「外部熱點」的開放式網路。重新導向 URL 指向 Purple Captive Portal。RADIUS 驗證 (UDP 1812) 和計費 (UDP 1813) 指向 Purple 的伺服器。Walled Garden 包含 Purple 的網域。
- 員工 WLAN:設定為 WPA2-Enterprise (802.1X)。RADIUS 指向 Purple,並與飯店的 Microsoft Entra ID 整合。員工使用企業憑證進行驗證,Purple 會將其分配至員工 VLAN。
- 會議 WLAN:設定為啟用 WPA2 預共用金鑰和 Cambium ePSK。Purple 透過 cnMaestro API 為每個活動主辦方佈署唯一的 ePSK 密碼,並將每個金鑰分配至隔離的 VLAN(例如 VLAN 301、302)。
某零售連鎖店部署了 Cambium e410 AP 並設定了 Purple Captive Portal。然而,顧客反映其智慧型手機上從未出現歡迎頁面,而是顯示連線逾時。其根本原因是什麼?該如何解決?
根本原因是 cnMaestro 中的 Walled Garden 設定不完整。Cambium AP 封鎖了在使用者通過驗證前載入 Purple 入口網站所需的 HTTP/HTTPS 流量。
要解決此問題,網路工程師必須登入 cnMaestro,導覽至訪客 WLAN 設定檔,並更新外部熱點的 Walled Garden 清單。他們必須新增 Purple 特定的入口網站網域以及任何關聯的 CDN 端點。套用設定後,未驗證的裝置將能夠連線至入口網站並完成登入流程。
練習題
Q1. 您正在使用 Cambium e505 AP 在 50 家零售店部署 Purple 訪客 WiFi。使用者可以連線至 SSID 並看到歡迎頁面,但在登入後卻無法存取網際網路。您已確認 Purple 正在傳送 Access-Accept 訊息。最可能的基礎架構問題是什麼?
提示:考慮驗證後裝置嘗試取得 IP 位址時,在交換器層級會發生什麼事。
查看標準答案
最可能的問題是連接到 Cambium AP 的交換器連接埠上缺少 VLAN Trunking。雖然 AP 已授權該裝置,但如果交換器 Trunk 上不允許分配的訪客 VLAN,則該裝置將無法連線至 DHCP 伺服器以取得 IP 位址,從而導致無法存取網際網路。
Q2. 大學校園希望為宿舍內的所有學生使用單一 SSID,但要求將每位學生的裝置隔離到各自的私有網路區段中,以便能夠投放畫面到他們特定的智慧電視。您如何使用 Cambium 和 Purple 實現此需求?
提示:查看 Cambium 對私有預共用金鑰的實現方式。
查看標準答案
在宿舍 WLAN 上實作 Cambium ePSK(增強型預共用金鑰)。Purple 將透過 cnMaestro API 管理 ePSK 生命週期,為每位學生產生唯一的密碼。當學生使用其特定金鑰連線其裝置時,Cambium AP 會將其分配到唯一的 VLAN,從而建立一個隔離的私有區域網路。
Q3. 在試點部署期間,儘管使用者已成功驗證並瀏覽網際網路,但 Purple 的分析儀表板顯示 Cambium 測試站點的停留時間或數據使用量指標為零。cnMaestro 中遺漏了哪個設定步驟?
提示:分析需要工作階段數據,這由 AAA 設定中的特定 UDP 連接埠處理。
查看標準答案
未設定 RADIUS 計費 (RADIUS Accounting)。網路工程師必須在 cnMaestro 訪客 WLAN 設定檔中啟用 RADIUS 計費,並將其指向 UDP 連接埠 1813 上的 Purple RADIUS 伺服器。若無此設定,Purple 僅處理驗證,而不會收到任何工作階段生命週期數據。
繼續閱讀本系列
CommScope Ruckus 與 Purple WiFi 整合:安裝與設定指南
本技術參考指南為 CommScope Ruckus 架構與 Purple WiFi 的整合提供了權威的設定指南。其中詳細介紹了使用 Guest WiFi Captive Portal、透過 802.1X 的安全員工 WiFi,以及使用 Ruckus Dynamic PSK 的多租戶網路隔離的逐步部署步驟。
Allied Telesis Access Points Integration with Purple WiFi
本指南提供將 Allied Telesis TQ 系列無線基地台與 Purple WiFi 整合的完整設定指南。內容涵蓋外部 Captive Portal 重新導向、802.1X RADIUS 驗證,以及使用私有預共用金鑰 (PPSK) 進行動態 VLAN 導向,以實現安全的多租戶部署。
Grandstream GWN Access Points Integration with Purple WiFi
本權威技術參考指南詳細說明如何將 Grandstream GWN 基地台與 Purple 的 Guest WiFi 及分析平台進行整合。內容涵蓋 Grandstream Captive Portal 設定、RADIUS AAA 設定、Walled Garden(圍牆花園)設定、支援動態 VLAN 導向的安全員工 802.1X 驗證,以及多租戶 PPSK 分割,為大規模部署訪客與員工 WiFi 的 MSP 和 IT 團隊提供具體可行的逐步指引。