Alta Labs 與 Purple WiFi 整合:設定與 Captive Portal 配置
本技術參考指南涵蓋了 Alta Labs AP6 和 AP6 Pro 基地台與 Purple 雲端託管 Captive Portal 的端到端整合。本指南詳細介紹了外部重新導向配置、RADIUS 驗證、Walled Garden 需求,以及使用 AltaPass 私有預先共用金鑰(PPSK)的多租戶區隔。場地營運商和 IT 團隊將獲得一份適用於餐旅、零售和智慧辦公環境的可重複部署指南。
收聽此指南
查看播客逐字稿

執行摘要
Alta Labs AP6 和 AP6 Pro 基地台使用標準 RADIUS 驗證和 HTTP 重新導向,與 Purple 的雲端 Captive Portal 進行整合。AP 會攔截未經驗證的訪客流量,將其重新導向至您的 Purple 歡迎頁面(splash page),並在 Purple 的 RADIUS 伺服器傳回 Access-Accept 後授予存取權限。對於多租戶環境,Alta Labs 的 AltaPass 技術可根據所使用的密碼,將每個連線裝置分配到唯一的 VLAN 和頻寬策略,而無需額外的 SSID。本指南為您提供從頭開始部署整合所需的確切配置步驟、Walled Garden 網域名稱清單和 RADIUS 參數。Purple 在全球 80,000 多個實體場地營運,並在 2024 年處理了 4.4 億次登入(Purple 內部數據)。Alta Labs 硬體非常適合需要以具競爭力的價格進行企業級區隔的 MSP 和智慧辦公室安裝商。
技術架構
此整合橫跨三個層級:Alta Labs 雲端管理平台、邊緣的 AP6 或 AP6 Pro 硬體,以及處理驗證與分析的 Purple 雲端基礎架構。
當訪客連線至開放式或 WPA3-OWE SSID 時,AP 會將裝置置於受限的預先驗證狀態。所有外發的 HTTP 流量都會被攔截並重新導向至 Purple 歡迎頁面 URL。在驗證完成之前,裝置只能存取 Walled Garden 中明確列出的網域。訪客在 Purple 歡迎頁面上提交憑證後,Purple 的 RADIUS 伺服器會向 AP 發送 Access-Accept,AP 隨即解除限制並授予完整的網際網路存取權限。Purple 會記錄工作階段數據(裝置類型、停留時間、登入方式),並將其提供於 WiFi Analytics 儀表板中。

對於員工和後勤網路,相同的 AP 硬體可處理 WPA2/WPA3-Enterprise (IEEE 802.1X) 驗證。AP 作為 RADIUS 用戶端,將驗證請求轉發至 Purple 的 SecurePass 基礎架構,該基礎架構進而比對 Microsoft Entra ID、Okta 或 Google Workspace 驗證憑證。RADIUS Access-Accept 回應包含 Tunnel-Private-Group-Id 屬性,AP 會使用該屬性將裝置動態分配到正確的 VLAN。
實作指南
步驟 1:在 Purple 中新增場地與硬體
在操作 Alta Labs 控制器之前,請先在 Purple 中註冊部署。
- 登入 Purple 管理入口網站,並導覽至 Management > Locations。
- 選取 Venues and Groups > Add venue 並完成場地精靈。
- 在您的場地中,選取 Hardware > Add hardware > Add new hardware。
- 將硬體類型設定為 WiFi AP,並選取適當的 AP 類型。
- 輸入每台 Alta Labs AP6 或 AP6 Pro 裝置的 MAC 位址。
- 按一下 View Manual Online 以取得此場地的 RADIUS 伺服器 IP 位址、連接埠和共用金鑰。記錄這些值,您將在步驟 3 中需要它們。
步驟 2:在 Alta Labs 中設定訪客 SSID
登入位於 manage.alta.inc 的 Alta Labs 雲端管理平台。
- 導覽至 Settings > WiFi,然後選取用於訪客存取的 SSID。
- 在 Advanced Settings 中,將網路類型設定為 Guest。這會自動強制執行用戶端隔離。
- 捲動至 Hotspot 區段並選取 External。
- 在 Redirect URL 欄位中,貼上您的場地硬體設定中提供的 Purple 歡迎頁面 URL(例如:
https://region1.purpleportal.net/access/)。 - 輸入您的 Purple 場地設定中的 Authorisation Secret(RADIUS 共用金鑰)。
- 按一下 Save。
步驟 3:設定 RADIUS 驗證
設定好外部重新導向後,請配置 RADIUS 設定,以便 AP 可以與 Purple 的驗證基礎架構進行通訊。
| 參數 | 值 |
|---|---|
| 主要驗證伺服器 IP | 由 Purple 場地設定提供 |
| 驗證連接埠 | UDP 1812 |
| 主要計費伺服器 IP | 由 Purple 場地設定提供 |
| 計費連接埠 | UDP 1813 |
| 共用金鑰 | 由 Purple 場地設定提供 |
對於高可用性部署,請使用 Purple 提供的備用 IP 位址來設定次要 RADIUS 伺服器。
步驟 4:定義 Walled Garden
Walled Garden 允許在驗證完成之前存取特定網域。遺漏項目將會中斷 Captive Portal 流程或導致社群登入無法載入。請在 Alta Labs Hotspot 配置的 Additional Authorised Hosts / IPs 欄位中輸入以下網域。
Purple 基礎架構(必填)
| 網域 | 用途 |
|---|---|
region1.purpleportal.net |
歡迎頁面託管 |
venuewifi.com |
Purple 重新導向基礎架構 |
cloudfront.net |
入口網站資源的 CDN |
作業系統 Captive Portal 探測(必填)
| 網域 | 作業系統 |
|---|---|
captive.apple.com |
iOS / macOS |
connectivitycheck.gstatic.com |
Android |
msftconnecttest.com |
Windows |
社群登入(依啟用的提供商新增)
| 提供商 | 網域 |
|---|---|
accounts.google.com, oauth2.googleapis.com, apis.google.com, gstatic.com |
|
facebook.com, graph.facebook.com, connect.facebook.net, *.fbcdn.net |
|
| Apple | appleid.apple.com, idmsa.apple.com, *.apple.com |

AltaPass PPSK 與多租戶區隔
AltaPass 是 Alta Labs 正在申請專利的私有預先共用金鑰(PPSK)實作技術。它允許單一 SSID 承載多個不重複的密碼,,每個密碼皆對應到獨立的 VLAN、頻寬限制、排程和熱點旁路規則。這消除了為每個租戶、員工群組或裝置類別廣播獨立 SSID 的需求。
在 Alta Labs 儀表板中設定 AltaPass
- 選擇您的 SSID 並導覽至密碼管理區段。
- 按一下每個密碼輸入項左側的紫色網路類型按鈕。
- 為該密碼分配一個 VLAN ID。使用此密碼連線的用戶端將被分配到指定的 VLAN 子網路。
- 根據需要設定每個密碼的頻寬限制(上傳和下載)。
- 啟用或停用每個密碼的熱點旁路。IoT 裝置和 POS 終端機通常會繞過 Captive Portal。
- 根據需要套用排程限制(例如:限制特定裝置在營業時間以外的網際網路存取)。

對於一棟擁有 72 個住戶的住宅大樓而言,這意味著只需一個 SSID 和 72 個以上的專屬密碼——每個住戶一個、管理部門一個、大樓自動化系統一個。每個密碼都對應到一個隔離的 VLAN 和子網路。標準方案的住戶可獲得 100 Mbps 頻寬,尊榮方案的住戶可獲得 300 Mbps 頻寬,大樓管理團隊則不受限制。IoT 裝置被隔離在啟用深度封包檢測的專用 VLAN 中。這就是將 SSID 數量從 72 個減少到 1 個的部署模式。
透過 RADIUS 進行動態 VLAN 分配
對於 802.1X 員工網路,VLAN 分配是透過 RADIUS 屬性而非 PPSK 進行。RADIUS Access-Accept 回應必須包含:
| 屬性 | 值 |
|---|---|
Tunnel-Type |
13 (VLAN) |
Tunnel-Medium-Type |
6 (IEEE-802) |
Tunnel-Private-Group-Id |
目標 VLAN ID(例如 "20") |
重要提示:使用 RADIUS 分配的 VLAN 時,請將 SSID 上的預設 VLAN 設定為 VLAN 1(或保持未標記狀態)。如果預設 VLAN 設定為特定值,AP 可能會使用設定的預設值覆寫 RADIUS 分配。這是目前 Alta Labs 韌體中的已知行為。
最佳做法
以下建議適用於任何搭配 Purple 的 Alta Labs 部署,不論場域類型為何。
針對圍牆花園(Walled Garden)項目使用動態 DNS 解析。 OAuth 提供商和 CDN 經常輪換 IP 位址。靜態 IP 白名單會隨著時間失效。請將 Alta Labs 控制器設定為動態解析圍牆花園網域,並將 DNS TTL 設定為不低於 30 秒,以避免過多的查詢負載。
精確界定圍牆花園的範圍。 僅將驗證流程所需的網域加入白名單。過度放寬白名單(特別是為大型網域新增萬用字元項目)會產生旁路漏洞,從而破壞 Captive Portal 的目的。
在正式上線前使用未驗證的裝置進行測試。 使用從未連線到該網路的裝置。先前已驗證的裝置可能快取了 MAC 授權或 DNS 記錄,從而掩蓋了圍牆花園的故障。請完整測試您打算提供的每一種登入方式。
每季審查圍牆花園網域。 Apple、Google 和 Meta 會定期更新其 OAuth 網域結構。請將每季審查納入您的營運日程中,以便在影響使用者之前發現變更。
從一開始就對 IoT 裝置進行區隔。 使用 AltaPass 將 IoT 裝置分配到啟用了熱點旁路的專用 VLAN。將 IoT 流量與訪客或員工流量混合會帶來不必要的風險,並使事件回應變得複雜。
如欲深入瞭解企業 WiFi 安全架構,請參閱我們的指南: 企業 WiFi 安全:2026 年完整指南 。
疑難排解與風險緩釋
iOS 上未顯示歡迎頁面(Splash Page)。 最常見的原因是圍牆花園中缺少 captive.apple.com 項目。iOS 使用此網域來偵測 Captive Portal。如果該探測被阻擋,Captive Network Assistant 將永遠不會啟動,使用者會看到一般的連線錯誤。
社群登入返回空白畫面或 CORS 錯誤。 請檢查圍牆花園中是否遺漏了 CDN 或 API 子網域。Facebook 的 *.fbcdn.net 和 Google 的 gstatic.com 是最常被遺漏的項目。請在未驗證的工作階段中使用瀏覽器開發者工具,以識別哪些網域請求失敗。
使用 AltaPass 時 VLAN 分配失敗。 請確認連接到 AP 的上游交換器連接埠已設定為 Trunk 連接埠,並允許標記的 VLAN。Access 模式的交換器連接埠會直接捨棄標記的訊框,導致用戶端無法取得 IP 位址。
RADIUS 驗證逾時。 請確認邊緣防火牆上的 UDP 連接埠 1812 和 1813 已對外開放。檢查 Alta Labs 設定中的共用金鑰是否與 Purple 場域設定中的值完全一致——單個字元不符就會導致所有驗證請求失敗。
動態 VLAN 分配將使用者分配到錯誤的 VLAN。 請將 802.1X SSID 上的預設 VLAN 設定為 VLAN 1。如果預設 VLAN 設定為特定值,AP 可能會覆寫 RADIUS 分配的 VLAN。這是 Alta Labs 社群論壇中已確認的韌體層級行為。
投資報酬率(ROI)與商業影響
將 Alta Labs 硬體與 Purple Guest WiFi 結合部署,可在三個維度上帶來可衡量的回報:營運效率、數據收集和安全態勢。
在營運方面,將多個 SSID 整合到單一由 AltaPass 管理的網路中,可減少管理開銷並提升無線效能。較少的 SSID 意味著較少的信標訊框(Beacon Frame)開銷,這會直接轉化為所有連線裝置的更高吞吐量。
在數據方面,Purple 的 Captive Portal 在每次登入時都會收集經驗證的第一方數據。使用 Purple Capture 和 Engage 方案的場域報告指出,與未管理的訪客 WiFi 相比,行銷資料庫的訂閱率提高了 40%(Purple 內部數據)。這些數據直接匯入 WiFi Analytics ,讓行銷團隊能夠掌握客流量模式、停留時間和重複造訪率。
在安全方面,動態 VLAN 分配可在邊緣隔離訪客、員工和 IoT 流量。結合 Purple 的 ISO 27001 認證基礎架構與符合 GDPR 規範的數據處理,此架構符合處理卡片支付之場所的 PCI DSS 網路分段要求。
專為 餐旅業 部署而言,品牌形象登入頁面、會員計劃整合以及單一裝置頻寬控制的結合,能創造出差異化的訪客體驗,且不會增加網路營運團隊的複雜度。
對於 零售 環境,在相同的實體基礎架構上將 POS 終端與訪客 WiFi 進行分段的能力(使用 AltaPass 旁路規則),無需獨立佈線或硬體,從而降低資本支出與營運成本。
相關指南: Arista Cognitive Wi-Fi 與 Purple WiFi 整合 | 訪客 WiFi 的 Walled Garden 設定
關鍵定義
Captive portal
A web page that intercepts unauthenticated network traffic and requires the user to interact - log in, accept terms, or pay - before granting internet access. Purple hosts the splash page in the cloud; the Alta Labs AP handles the redirect.
The primary mechanism for guest data capture in hospitality, retail, and public-sector WiFi deployments.
Walled garden
A defined list of domains and IP addresses that a client device can access before completing captive portal authentication. Everything outside the list is blocked until the user logs in.
Critical for allowing social login APIs, OS detection probes, and portal CDN assets to function before authentication completes.
PPSK (Private Pre-Shared Key)
A security method where multiple unique passwords can be used on a single SSID, with each password assigning the connecting device to a specific VLAN, bandwidth policy, and access schedule.
Alta Labs implements this as AltaPass. Used in MDUs, smart offices, and stadiums to provide isolated access without SSID proliferation.
RADIUS
Remote Authentication Dial-In User Service. A networking protocol that provides centralised authentication, authorisation, and accounting (AAA) management. Purple acts as the RADIUS server; the Alta Labs AP acts as the RADIUS client.
The mechanism that tells the AP a guest has successfully authenticated and should be granted internet access.
Identity-Based Networking
A network architecture where access rights, VLANs, and bandwidth limits are applied based on the authenticated identity of the user or device, rather than the physical port or SSID they connect to.
Purple's term for the combination of RADIUS, PPSK, and VLAN assignment that enables consistent policies across a distributed estate.
Dynamic VLAN assignment
The process of placing a client device onto a specific Virtual Local Area Network based on authentication credentials returned by a RADIUS server, rather than a static SSID-to-VLAN mapping.
Essential for isolating staff, guest, and IoT traffic on shared wireless infrastructure. Requires correct RADIUS attributes: Tunnel-Type, Tunnel-Medium-Type, and Tunnel-Private-Group-Id.
Captive Network Assistant (CNA)
The built-in OS mechanism on iOS, Android, and Windows that detects a captive portal by probing a known URL. If the probe is redirected, the OS launches a pseudo-browser for the user to log in.
If the CNA probe domains are blocked in the walled garden, the user never sees the splash page. This is the most common captive portal failure mode.
WPA3-OWE
Wi-Fi Protected Access 3 - Opportunistic Wireless Encryption. A standard that encrypts data in transit on open networks without requiring a password, protecting guest privacy while still allowing captive portal redirection.
The recommended security mode for guest SSIDs in 2026. Provides encryption without the friction of a pre-shared key.
AltaPass
Alta Labs' patent-pending implementation of multi-password SSID technology. Allows a single SSID to carry unlimited unique passwords, each with its own VLAN, bandwidth limit, schedule, and hotspot bypass setting.
The primary tool for multi-tenant segmentation on Alta Labs hardware. Replaces the need for multiple SSIDs in residential, hospitality, and smart office deployments.
範例
A 200-room hotel needs to provide tiered WiFi access: a free basic tier (10 Mbps) for standard guests, a premium paid tier (50 Mbps) for loyalty members, and a secure network for housekeeping staff. They want to avoid broadcasting multiple SSIDs to maintain RF performance across 40 Alta Labs AP6 Pro units.
Deploy a single SSID named 'Hotel Guest WiFi' with AltaPass enabled. Create three password profiles in the Alta Labs dashboard: (1) a standard guest password assigned to VLAN 10 with a 10 Mbps download limit and external hotspot redirect to the Purple splash page; (2) a loyalty member password assigned to VLAN 20 with a 50 Mbps limit - Purple can distribute this password post-authentication via its marketing automation; (3) a housekeeping staff password assigned to VLAN 30 with no bandwidth limit, hotspot bypass enabled, and client isolation disabled so staff devices can communicate with back-of-house systems. Configure the switch uplinks as trunks allowing VLANs 10, 20, and 30. The guest and loyalty VLANs route to the internet via NAT. The staff VLAN routes to the property management system subnet.
A retail chain is deploying Purple Guest WiFi across 50 stores using Alta Labs hardware. During testing, the splash page loads correctly on Android devices, but Apple iOS devices show a generic 'No Internet Connection' error and do not display the login screen. The walled garden includes the Purple portal domain and Google OAuth entries.
Add captive.apple.com to the walled garden in the Alta Labs Hotspot configuration. iOS uses this domain as its Captive Network Assistant probe. When the device connects to a new network, iOS sends an HTTP request to captive.apple.com. If it receives the expected response, it assumes the network is open. If it receives a redirect, it launches the pseudo-browser. If the domain is blocked entirely, iOS cannot detect the captive portal and displays a connectivity error. Once the domain is whitelisted, iOS devices will detect the redirect and launch the login screen automatically.
練習題
Q1. You are deploying Alta Labs AP6 Pro access points in a conference centre. The client requires a captive portal for attendees, but also needs point-of-sale terminals to connect securely to the same access points without seeing the splash page. Both device types should use the same SSID to simplify signage. How do you configure this?
提示:AltaPass allows per-password hotspot bypass settings on the same SSID.
查看標準答案
Enable AltaPass on the single SSID. Create one password for POS terminals that assigns them to a secure VLAN (e.g., VLAN 50) with hotspot bypass enabled - these devices connect directly to the network without seeing the captive portal. Create a separate password (or use an open connection) for attendees that triggers the external redirect to the Purple splash page on VLAN 10. Both device types connect to the same SSID but receive different network policies based on their password.
Q2. After configuring the Purple captive portal on an Alta Labs network, Android devices successfully display the splash page, but Apple iOS devices show a generic 'No Internet Connection' error and do not open the login screen. The walled garden includes the Purple portal domain and Google OAuth entries. What is the most likely cause and fix?
提示:iOS uses a specific domain to detect captive portals. If it cannot reach that domain, it assumes the network has no internet access.
查看標準答案
The walled garden is missing captive.apple.com. iOS sends an HTTP probe to this domain when connecting to a new network. If the probe is blocked, iOS cannot detect the captive portal and displays a connectivity error instead of launching the Captive Network Assistant. Add captive.apple.com to the walled garden in the Alta Labs Hotspot configuration. Also add connectivitycheck.gstatic.com for Android and msftconnecttest.com for Windows to ensure cross-platform compatibility.
Q3. A stadium IT director has configured RADIUS-assigned VLANs on an Alta Labs 802.1X staff network. The RADIUS server is sending the correct Tunnel-Private-Group-Id attribute (VLAN 20), but all staff devices are landing on VLAN 5, which is the default VLAN configured on the SSID. What is causing this and how do you resolve it?
提示:There is a known behaviour in Alta Labs firmware related to the interaction between the SSID default VLAN and RADIUS-assigned VLANs.
查看標準答案
The Alta Labs AP is overriding the RADIUS-assigned VLAN with the SSID default VLAN value. This is a known firmware behaviour: when the default VLAN on the SSID is set to a specific value (VLAN 5 in this case), the AP uses that value instead of the RADIUS-returned VLAN. The fix is to set the default VLAN on the 802.1X SSID to VLAN 1 (or leave it untagged). With the default set to VLAN 1, the AP correctly defers to the RADIUS-assigned VLAN for each authenticated user.
繼續閱讀本系列
MikroTik RouterOS Captive Portal 與 Purple WiFi 整合指南
本技術指南提供將 MikroTik RouterOS 與 Purple 的 WiFi 平台整合的逐步說明。內容涵蓋訪客 WiFi Captive Portal 設定、員工 WiFi 802.1X 驗證,以及使用 Private PSK 進行動態 VLAN 切割的多租戶 WiFi。
Arista Cognitive Wi-Fi 與 Purple WiFi 整合
本技術指南詳細介紹了 Arista Cognitive Wi-Fi (CV-CUE) 與適用於企業場域的 Purple 訪客 WiFi 平台的逐步整合過程。內容涵蓋 Arista Captive Portal 設定、Walled Garden ACL 設計、RADIUS 伺服器設定、安全的員工 802.1X 驗證,以及使用 Arista PPSK 搭配動態 VLAN 導向的多租戶 (Multi-Tenant) 隔離——為 IT 團隊和網路架構師提供決定性的部署藍圖。
WatchGuard Firebox 與 Purple WiFi 整合:設定與組態指南
本指南是為部署 WatchGuard Firebox 和 Access Points 與 Purple 整合的 IT 經理和網路架構師提供的逐步整合手冊。內容涵蓋 Guest WiFi 的外部 Captive Portal 重新導向、Staff WiFi 的安全 802.1X 驗證,以及使用 WatchGuard 私有預先共用金鑰 (PPSK) 搭配動態 VLAN 導向的多租戶區隔,為您在所有存取層級提供單一、整合的架構。