Huawei AirEngine 與 CloudCampus 與 Purple WiFi 整合
本指南提供將 Huawei AirEngine 基地台和 iMaster NCE-Campus 與 Purple WiFi 整合的逐步說明。內容涵蓋企業網路的 Captive Portal 設定、802.1X 員工驗證以及 PPSK 動態 VLAN 導向。
收聽此指南
查看播客逐字稿

執行摘要
企業網路需要可靠的硬體與智慧型身分識別管理相結合。Huawei AirEngine 基地台和 iMaster NCE-Campus 控制器提供高密度連線,而 Purple 則提供用於驗證、分析和原則執行的雲端重疊網路。本指南詳細介紹了使用單一 Huawei 控制器部署 Guest WiFi 、安全員工 WiFi 和多租戶 WiFi 所需的整合架構。
藉由將 Huawei CloudCampus 與 Purple 整合,您可以用統一的「基於身分的網路」(Identity-Based Network)取代分散的驗證孤島。我們在超過 80,000 個實體場域運作,並在 2024 年處理了 4.4 億次登入。我們與硬體無關的平台透過標準 RADIUS 和 Captive Portal 協定與 Huawei 原生整合。此整合為訪客啟用了自願選擇加入機制、為員工啟用了 802.1X 憑證驗證,並為租戶啟用了透過私有預共用金鑰(PPSK)進行的動態 VLAN 導向。
無論您管理的是體育場、大學校園還是零售連鎖店,本文件都提供了保護您的無線邊緣並大規模收集第一方數據所需的確切設定步驟、RADIUS 屬性和存取控制清單。
收聽技術簡報 Podcast:
技術深度解析
此整合依賴標準協定:用於驗證和計費的 RADIUS (UDP 1812/1813),以及用於 Captive Portal 重新導向的 HTTPS (TCP 443)。iMaster NCE-Campus 作為網路存取伺服器(NAS)和 RADIUS 轉發器,將來自 AirEngine 基地台的請求轉發到 Purple 的雲端 RADIUS 基礎架構。
架構總覽

Purple 在 Huawei 硬體上支援三種主要的驗證模式:
- Guest WiFi (Captive Portal):未驗證的流量會被 Huawei 控制器攔截,並重新導向至 Purple 的登入頁面。驗證前的存取受到 Walled Garden ACL 的限制。登入成功後,Purple 會傳送 RADIUS Access-Accept,授予用戶端完整的網路存取權限。
- Staff WiFi (802.1X):員工使用公司憑證透過 EAP-PEAP 或 EAP-TLS 進行驗證。Purple 會針對 Microsoft Entra ID、Okta 或 Google Workspace 等身分識別提供者驗證這些憑證。
- Multi-Tenant WiFi (PPSK):租戶使用唯一的密碼連線到單一共享的 SSID。Purple 驗證該密碼並傳回特定的 RADIUS 屬性,以動態地將租戶導向至其隔離的 VLAN。
Walled Garden 與驗證前 ACL
Captive Portal 需要 Walled Garden,這是一個存取控制清單(ACL),允許在使用者驗證之前存取基本服務。如果 Walled Garden 不完整,登入頁面將無法載入,從而導致不良的訪客體驗。
對於 Huawei iMaster NCE-Campus,驗證前 ACL 必須允許:
- DNS 解析 (UDP 53)
- Purple 的 Captive Portal 網域(
*.purpleportal.net、*.purple.ai) - 託管登入頁面資產的內容傳遞網路(CDN)
- 如果啟用了社群登入(Apple、Google、Facebook),則允許身分識別提供者網域
在 Purple 傳回 RADIUS Access-Accept 之前,必須拒絕所有其他流量。
動態 VLAN 導向與 RADIUS 屬性
為了隔離網路流量,Purple 使用動態 VLAN 分配。與其廣播多個 SSID,您只需廣播一個 SSID,並根據使用者的身分動態分配 VLAN。
當 Purple 驗證使用者(透過 802.1X 或 PPSK)時,它會傳回一個包含三個強制性 IETF 標準 RADIUS 屬性的 Access-Accept 封包:
Tunnel-Type=VLAN(或 13)Tunnel-Medium-Type=802(或 6)Tunnel-Private-Group-ID=[VLAN ID]
Huawei 控制器接收這些屬性,並指示 AirEngine 基地台使用指定的 VLAN ID 標記用戶端的流量。

實作指南
本節涵蓋設定 iMaster NCE-Campus 以進行 Purple 整合的確切步驟。
步驟 1:設定 RADIUS 轉發伺服器
首先,將 Purple 定義為外部驗證伺服器。
- 在 iMaster NCE-Campus 中,導覽至 Design(設計)> Network Design(網路設計)> Template Management(範本管理)。
- 選擇 RADIUS Server(RADIUS 伺服器)並按一下 Create(建立)。
- 將 Authentication service(驗證服務)設定為 Portal authentication(Portal 驗證)。
- 輸入 Purple 的主要和次要 RADIUS IP 位址(可在您的 Purple 儀表板中取得)。
- 將驗證連接埠設定為 1812,計費連接埠設定為 1813。
- 輸入 Purple 提供的 RADIUS 共用金鑰。
- 將 NAS identifier(NAS 識別碼)設定為 Device MAC。
步驟 2:建立 Walled Garden ACL
建立 ACL 以允許驗證前流量。
- 導覽至 Design(設計)> Network Design(網路設計)> Template Management(範本管理)> ACL。
- 建立一個名為
Purple_Walled_Garden的新 ACL。 - 將 ACL Type(ACL 類型)設定為 User(使用者)。
- 新增 DNS 和 Purple 所需網域(例如
*.purpleportal.net)的允許規則。 - 儲存 ACL 範本。
步驟 3:設定 Captive Portal URL 範本
Huawei 需要一個 URL 範本,以將標準重新導向參數對應到 Purple 所需的格式。
- 導覽至 Design(設計)> Network Design(網路設計)> Template Management(範本管理)> URL Template(URL 範本)。
- 建立一個名為
Purple_URL_Template。 - 將 範本類型 設定為 基於雲端平台的轉發認證。
- 依據以下內容精確設定參數對應:
redirect-url對應至redirect-urlloginurl對應至login-urldevice-mac對應至ap-macuser-ip對應至uaddressuser-mac對應至umacssid對應至ssid
步驟 4:佈署訪客 SSID
將 RADIUS 伺服器、ACL 和 URL 範本綁定至 SSID。
- 導覽至 Provision(佈署) > Device Configuration(裝置設定) > Site Configuration(站點設定)。
- 選擇 AP 並建立新的 SSID。
- 將 網路類型 設定為 Open(開放)。
- 選擇 Open+Portal 認證。
- 將認證類型設定為 雲端平台轉發認證。
- 將互連模式設定為 RADIUS 轉發。
- 選擇先前建立的
Purple_URL_Template。 - 在第三方認證 URL 欄位中,貼上您專屬的 Purple 歡迎頁面 URL。
- 選擇 Purple RADIUS 伺服器範本。
- 選擇
Purple_Walled_GardenACL 作為預設允許規則。 - 儲存並將設定部署至 AirEngine 存取點。
最佳實踐
為確保部署安全且可靠,請遵循以下與廠商無關的最佳實踐:
- 為員工實施 802.1X:切勿在員工網路中使用共用 PSK。使用 Purple 的 SecurePass 附加元件部署支援 EAP-TLS 的 802.1X,以核發用戶端憑證。這能消除基於密碼的網路釣魚媒介,並符合 ISO 27001 的要求。
- 整合 SSID:廣播過多 SSID 會因管理訊框開銷而降低空口(airtime)效率。使用 PPSK 和動態 VLAN 導向將多租戶網路整合至單一 SSID 中。
- 驗證 Trunk 設定:如果連接存取點的交換器 Trunk 連接埠不允許指派的 VLAN,動態 VLAN 指派將會靜默失敗。在測試 RADIUS 導向之前,務必稽核交換器連接埠設定。
- 監控 RADIUS 延遲:認證逾時通常源自 WAN 延遲。確保您的 iMaster NCE-Campus 控制器與 Purple 的區域 RADIUS 基礎架構之間擁有低延遲路徑。
疑難排解與風險緩釋
將雲端 RADIUS 與企業控制器整合時,問題通常集中在三個領域:Walled Garden、RADIUS 共用金鑰或 VLAN Trunking。
歡迎頁面無法載入
症狀:裝置已連線至訪客 WiFi,但瀏覽器顯示逾時錯誤,而非 Purple 歡迎頁面。
根本原因:Walled Garden ACL 不完整,阻擋了對 Purple 入口網站網域或所需 CDN 的存取。
緩釋措施:將測試裝置連線至 SSID。嘗試 ping purpleportal.net。如果 ping 失敗,請檢查 iMaster NCE-Campus ACL 設定,並確保其已套用至 SSID 的預先認證狀態。
靜默認證失敗
症狀:使用者輸入了有效的憑證,但連線中斷且未顯示任何錯誤訊息。 根本原因:iMaster NCE-Campus 與 Purple 之間的 RADIUS 共用金鑰不一致。 緩釋措施:直接從 Purple 儀表板複製共用金鑰,並將其貼入 Huawei RADIUS 伺服器範本中。任何尾隨的空格都會破壞 RADIUS 封包中使用的 MD5 雜湊值。
認證後 DHCP 逾時
症狀:員工透過 802.1X 成功通過認證,但裝置收到的是 169.254.x.x APIPA 位址,而非有效的 IP。
根本原因:Purple 已透過 RADIUS 成功指派動態 VLAN,但該 VLAN 未 Trunk 至 AirEngine 存取點。
緩釋措施:登入存取交換器,並驗證連接至 AP 的介面上,port trunk allow-pass vlan 指令是否包含目標 VLAN ID。
投資報酬率(ROI)與商業影響
將 Huawei AirEngine 與 Purple 結合部署,能將標準網路基礎架構轉化為可衡量的商業資產。
對於 零售 營運商而言,此整合能收集消費者的第一方數據,進而實現精準的行銷活動,帶動人潮並提升平均交易價值。Purple 的 WiFi Analytics 儀表板提供熱圖和停留時間指標,讓場地管理者能夠根據實際訪客行為最佳化商店佈局。
在 旅宿 環境中,透過 OpenRoaming 或 Passpoint 進行的自動認證消除了手動登入的繁瑣流程,進而提升顧客滿意度評分。對於多租戶大樓,PPSK 動態 VLAN 導向無需為每個新租戶手動配置和管理獨立的 SSID,從而降低 IT 開銷。
透過在單一硬體架構上整合訪客互動、員工安全和租戶隔離,企業能將其在 Huawei CloudCampus 的投資報酬率最大化。
關鍵定義
iMaster NCE-Campus
Huawei 的雲端或地端網路自動化與管理平台。
IT 團隊將其用作中央控制器,以設定 SSID、將原則推送到 AirEngine AP,並設定至 Purple 的 RADIUS 轉發。
PPSK (Private Pre-Shared Key)
一種安全功能,允許在單一 SSID 上使用多個唯一的密碼,每個密碼會將使用者繫結至特定的網路原則或 VLAN。
對於需要隔離網路且不廣播數十個 SSID 的多租戶環境(如共享工作空間或零售園區)至關重要。
Dynamic VLAN Steering
根據裝置通過驗證的身分(而非其連線的 SSID)將其分配至特定虛擬區域網路(VLAN)的程序。
由 Purple 用於確保連線到同一個實體基地台的主管、收銀員和訪客被分配到完全獨立且安全的網路區段。
Walled Garden
套用於未驗證使用者的存取控制清單(ACL),僅允許存取完成登入程序所需的特定 IP 位址或網域。
如果 Walled Garden 設定錯誤,訪客將會看到空白畫面或逾時錯誤,而不是 Purple 登入頁面。
RADIUS Relay
一種設定,其中本機網路控制器會將來自基地台的驗證請求轉發至外部 RADIUS 伺服器。
Huawei iMaster NCE-Campus 作為轉發器,將憑證安全地從場域傳遞到 Purple 的雲端基礎架構進行驗證。
802.1X
一項基於連接埠之網路存取控制的 IEEE 標準,為希望連線至 LAN 或 WLAN 的裝置提供驗證機制。
員工 WiFi 的企業標準。它以個人使用者憑證或數位憑證取代共享密碼。
EAP-TLS
可延伸驗證協定 - 傳輸層安全性(Extensible Authentication Protocol - Transport Layer Security)。一種依賴用戶端和伺服器憑證而非密碼的 802.1X 驗證方法。
目前最安全的驗證方法。Purple 的 SecurePass 向員工裝置核發這些憑證,以消除網路釣魚風險。
Captive Portal
公共存取網路的使用者在獲得存取權限之前,必須檢視並與之互動的網頁。
Purple 用於收集場域訪客的第一方數據和同意聲明的主要機制。
範例
一家擁有 200 間客房的飯店需要為房客、員工以及在遊客大廳營運的第三方咖啡店提供安全且隔離的 WiFi,且僅使用兩個 SSID 以節省空口時間(airtime)。
部署一個名為「Hotel_Guest」的 SSID,設定為指向 Purple 的 Captive Portal 的 Open+Portal 驗證原則。部署第二個名為「Hotel_Secure」的 SSID,設定為 WPA3-Enterprise 和 802.1X 驗證。員工透過 EAP-TLS 進行驗證,Purple 會傳回 RADIUS 屬性將其分配至 VLAN 20。咖啡店在同一個「Hotel_Secure」SSID 上使用 PPSK;他們輸入唯一的密碼,Purple 則傳回 RADIUS 屬性將其分配至 VLAN 30。
一家大型連鎖零售商正轉移至 Huawei AirEngine,並需要確保其現有的 Purple 登入頁面(splash page)能在所有門市正確載入,且不會在現代智慧型手機上觸發安全警告。
精確設定 iMaster NCE-Campus URL 範本以對應所需的參數(ap-mac、uaddress、umac、ssid、redirect-url)。建立完整的 Walled Garden ACL,允許傳送至 Purple 網域及任何所需社群登入 API 的 DNS (UDP 53) 和 HTTPS (TCP 443) 流量。確保控制器攔截 HTTP 流量並將其重新導向至 HTTPS 登入頁面。
練習題
Q1. 您已在 iMaster NCE-Campus 上設定了訪客 SSID 和 Walled Garden ACL。當您測試連線時,您的手機偵測到了 Captive Portal,但畫面仍保持空白。最可能的原因是什麼?
提示:考慮裝置載入託管於雲端平台上的現代網頁需要什麼。
查看標準答案
Walled Garden ACL 可能缺少所需網域的允許規則。具體而言,必須允許 DNS (UDP 53),以及對 Purple 的 Portal 網域和任何託管頁面資產的內容傳遞網路(CDN)的 HTTPS 存取。如果啟用了社群登入,則在驗證前也必須允許那些特定的 API 端點。
Q2. 使用您的 PPSK 網路的租戶抱怨他們無法連線到網際網路。您檢查 iMaster NCE-Campus 記錄,發現 Purple 傳回了 RADIUS Access-Accept,且 Tunnel-Private-Group-ID 設定為 40。然而,用戶端裝置的 IP 位址為 169.254.x.x。這是什麼設定錯誤?
提示:驗證成功,但網路路由在邊緣失敗。
查看標準答案
連接 Huawei AirEngine 基地台與網路的交換器連接埠未設定為 Trunk VLAN 40。雖然 Purple 成功授權了使用者,且控制器指示 AP 將流量標記為 VLAN 40,但上游交換器丟棄了這些封包,因為該 Trunk 不允許此 VLAN。您必須在存取交換器上將 VLAN 40 新增至 Trunk 允許通過(allow-pass)清單中。
Q3. 您正在從舊版控制器遷移至 Huawei iMaster NCE-Campus。您設定的 RADIUS 伺服器範本與舊系統完全相同,但所有驗證請求都無聲失敗。您應該首先檢查什麼?
提示:RADIUS 中的無聲失敗通常表示密碼編譯不相符。
查看標準答案
驗證 RADIUS 共用金鑰(Shared Secret)。如果 iMaster NCE-Campus 中設定的金鑰與 Purple 儀表板中的金鑰不完全相符,則無法解密 RADIUS 封包,從而導致無聲失敗或沒有明確錯誤代碼的 Access-Reject 訊息。複製金鑰時,請確保沒有尾隨空格。
繼續閱讀本系列
CommScope Ruckus 與 Purple WiFi 整合:安裝與設定指南
本技術參考指南為 CommScope Ruckus 架構與 Purple WiFi 的整合提供了權威的設定指南。其中詳細介紹了使用 Guest WiFi Captive Portal、透過 802.1X 的安全員工 WiFi,以及使用 Ruckus Dynamic PSK 的多租戶網路隔離的逐步部署步驟。
Allied Telesis 基地台與 Purple WiFi 整合
本指南提供將 Allied Telesis TQ 系列基地台與 Purple WiFi 整合的完整設定指南。內容涵蓋外部 Captive Portal 重新導向、802.1X RADIUS 驗證,以及使用私有預共用金鑰 (PPSK) 進行動態 VLAN 導向,以實現安全的多租戶部署。
Grandstream GWN Access Points 與 Purple WiFi 整合
本權威技術參考指南詳細說明如何將 Grandstream GWN Access Points 與 Purple 的 Guest WiFi 和分析平台進行整合。內容涵蓋 Grandstream Captive Portal 設定、RADIUS AAA 設定、Walled Garden 設定、具備動態 VLAN 導向的安全員工 802.1X 驗證,以及多租戶 PPSK 分段,為部署大規模訪客與員工 WiFi 的 MSP 和 IT 團隊提供具體且逐步的指引。