Skip to main content

Alta Labs Integration with Purple WiFi: Setup and Captive Portal Configuration

This technical reference guide covers the end-to-end integration of Alta Labs AP6 and AP6 Pro access points with Purple's cloud-hosted captive portal. It details external redirect configuration, RADIUS authentication, walled garden requirements, and multi-tenant segmentation using AltaPass Private Pre-Shared Keys. Venue operators and IT teams will leave with a repeatable deployment playbook for hospitality, retail, and smart office environments.

📖 8 min read📝 1,844 words🔧 2 worked examples3 practice questions📚 9 key definitions

Listen to this guide

View podcast transcript
PODCAST SCRIPT: Alta Labs Integration with Purple WiFi: Setup and Captive Portal Configuration Purple WiFi Intelligence Platform - Technical Briefing Series Duration: Approximately 10 minutes Voice: UK English, senior consultant tone - confident, conversational, authoritative --- [INTRO - 1 MINUTE] Welcome to the Purple Technical Briefing Series. I'm your host, and today we are breaking down the integration between Alta Labs access points and the Purple WiFi intelligence platform. If you are an IT manager, network architect, or venue operations director looking to deploy a robust, scalable guest WiFi solution, this briefing is for you. We are going to cover the specific setup for the Alta Labs AP6 and AP6 Pro, how to configure the external captive portal redirection, and the critical walled garden settings required to make social logins actually work in the real world. We will also dive into AltaPass - Alta Labs' implementation of Private Pre-Shared Keys, or PPSK - and how you can use it to segment multi-tenant environments without destroying your RF performance with SSID bloat. Let's get into it. --- [TECHNICAL DEEP-DIVE - 5 MINUTES] The integration between Alta Labs and Purple relies on two fundamental networking concepts: HTTP redirection for the captive portal, and RADIUS for authentication and accounting. When a guest walks into your venue - say, a retail store or a hotel lobby - and connects to your open or WPA3-OWE guest network, the Alta Labs AP acts as the gatekeeper. It intercepts the client's initial HTTP requests and redirects them to your branded Purple splash page. To configure this in the Alta Labs Cloud Management platform, you navigate to your WiFi settings, select your guest SSID, and under the Advanced Settings, set the network type to Guest. This is crucial because it automatically applies client isolation, preventing devices from communicating laterally across the network. Next, under the Hotspot section, you select External and drop in the Purple redirect URL provided in your venue settings, along with your Authorisation Secret. But here is where most deployments hit a snag: the walled garden. The walled garden is the list of domains and IP addresses that a device is allowed to access before it has authenticated. If you want guests to log in using Google, Facebook, or Apple, their devices need to reach those OAuth servers while they are still in the pre-authenticated state. You must explicitly whitelist the Purple infrastructure domains - like region1.purpleportal.net and cloudfront.net. Then, you need to add the OS captive portal probes: captive.apple.com for iOS, and connectivitycheck.gstatic.com for Android. If you block these, the phone doesn't know it's behind a captive portal, and the splash page never pops up. Finally, you add the social login domains. For Google, that's accounts.google.com, oauth2.googleapis.com, and gstatic.com. For Facebook, it's facebook.com, graph.facebook.com, and the fbcdn.net domains. A static IP whitelist will not work here because these providers use dynamic content delivery networks. You must use domain names and ensure your controller performs dynamic DNS resolution. Once the user completes the login on the Purple splash page, Purple's RADIUS server sends an Access-Accept message back to the Alta Labs AP. The AP then removes the walled garden restriction and grants the device full internet access. It's a clean, secure flow that captures first-party data while maintaining network integrity. Now, let's talk about multi-tenant segmentation. In environments like smart offices, student accommodation, or multi-dwelling units, you often need to provide secure, isolated networks for different groups. Historically, IT teams would broadcast a separate SSID for every tenant. That is a terrible practice. It causes massive management overhead and destroys your wireless performance due to beacon frame overhead. Alta Labs solves this with AltaPass, their version of Private Pre-Shared Keys. With AltaPass, you broadcast one single SSID - let's call it BuildingWiFi. But, you generate unique passwords for different users or devices. When Tenant A enters their specific password, the AP dynamically assigns them to VLAN 101 with a 100 Megabit bandwidth limit. When the management team enters their password on the same SSID, they are dropped onto VLAN 200 with unlimited bandwidth. You can even create a password for IoT devices, like smart thermostats, that assigns them to an isolated VLAN and bypasses the captive portal entirely. One SSID. Unlimited passwords. Complete isolation. This is Identity-Based Networking at the edge, and it is a genuinely elegant solution to a problem that has plagued multi-tenant deployments for years. Let me give you a concrete example of how this works in practice. Consider a 72-unit apartment complex - a real-world deployment type that Alta Labs has been used for extensively. Instead of broadcasting 72 separate SSIDs, the network administrator creates a single SSID and generates a unique password for each unit. Each password maps to a dedicated VLAN and subnet. Residents on the basic tier get 100 Megabits. Residents who have paid for the premium tier get 300 Megabits. The building management team gets unrestricted access. The building automation system - door locks, HVAC, lifts - gets its own isolated VLAN with deep packet inspection enabled. All from one SSID. The RF environment is cleaner, performance is higher, and management is dramatically simpler. Now, let's move on to the 802.1X configuration for secure staff WiFi. For your staff network, you should not be using a pre-shared key at all. You should be using WPA2 or WPA3 Enterprise with 802.1X authentication. In the Alta Labs platform, you configure this by selecting your staff SSID, setting the security mode to WPA2-Enterprise or WPA3-Enterprise, and pointing the AP to your RADIUS server. If you are integrating with Purple's SecurePass product, Purple acts as the RADIUS intermediary, connecting to your identity provider - whether that is Microsoft Entra ID, Okta, or Google Workspace - and returning the appropriate VLAN assignment in the Access-Accept message. The Alta Labs AP reads the Tunnel-Private-Group-Id attribute from the RADIUS response and places the device on the correct VLAN automatically. One important note on dynamic VLAN assignment with Alta Labs: when configuring RADIUS-assigned VLANs, set the default VLAN on the SSID to VLAN 1 or leave it untagged. There is a known behaviour where if the default VLAN is set to a specific value, the AP may override the RADIUS-assigned VLAN with the configured default. Setting the default to VLAN 1 ensures the RADIUS assignment takes precedence. --- [IMPLEMENTATION RECOMMENDATIONS AND PITFALLS - 2 MINUTES] When you are rolling this out, there are a few key recommendations I want to highlight. First, always test your captive portal flow with a fresh device. Do not use your own phone if you have already connected to the network during testing. Your device remembers the MAC address authorisation or has cached DNS entries, which will mask walled garden failures. Grab a tablet that has never seen the network, connect it, and verify that the OS captive portal assistant launches automatically. Second, watch out for over-whitelisting. I see engineers get frustrated with social login errors and just whitelist entire wildcard domains or massive IP blocks. This creates a security vulnerability where savvy users can bypass your captive portal entirely. Stick to the specific domains required for the OAuth flow. Third, when deploying AltaPass PPSK with dynamic VLANs, ensure your entire switching infrastructure is configured correctly. The switch ports connecting to your Alta Labs APs must be configured as trunks, allowing all the tagged VLANs to pass through to the gateway. If the AP tags the traffic for VLAN 101, but the switch port is set to access mode on VLAN 1, the traffic drops, and the client gets no IP address. Fourth, implement a quarterly review of your walled garden configuration. OAuth providers and content delivery networks change their domain structures. Apple updated its Sign In domains twice in 2023. A walled garden that was correct at deployment will drift out of alignment without active maintenance. --- [RAPID-FIRE Q&A - 1 MINUTE] Let's run through a couple of quick questions we hear from the field. Question one: Can I use WPA3 with the Purple captive portal on Alta Labs hardware? Yes. You should use WPA3-OWE, which stands for Opportunistic Wireless Encryption. This encrypts the data over the air, protecting guest privacy, while still functioning as an open network that triggers the captive portal redirect. It is the right choice for any new guest WiFi deployment in 2026. Question two: What ports do I need to open on my firewall for the RADIUS traffic? Purple's RADIUS servers communicate over UDP port 1812 for authentication and UDP port 1813 for accounting. Ensure your edge firewall allows outbound traffic on these ports from the Alta Labs APs to the Purple infrastructure. Question three: Can I use AltaPass PPSK alongside the Purple captive portal on the same SSID? Yes, and this is actually a very useful configuration. You can create an AltaPass password that bypasses the captive portal for known devices - like your point-of-sale terminals or digital signage - while standard connections to the same SSID still go through the Purple splash page. This gives you a single, clean SSID that handles both authenticated devices and guest users. --- [SUMMARY AND NEXT STEPS - 1 MINUTE] To wrap up: Integrating Alta Labs with Purple WiFi gives you a secure, scalable platform for capturing first-party data and delivering a branded guest experience. Remember the three pillars of a successful deployment. First, configure the external hotspot redirect and RADIUS settings accurately in the Alta Labs Cloud Management platform. Second, meticulously define your walled garden domains to ensure OS probes and social logins function correctly. And third, leverage AltaPass PPSK to implement Identity-Based Networking, segmenting your traffic without polluting your airspace with unnecessary SSIDs. Purple operates across 80,000 live venues and has processed 440 million logins in 2024. The platform is ISO 27001 certified, GDPR compliant, and built to scale from a single boutique hotel to a national retail estate. When you pair that with the performance and flexibility of Alta Labs hardware, you have a compelling enterprise WiFi stack. If you follow this playbook, you will deliver a seamless, compliant WiFi experience that your marketing team and your security team will both be happy with. Thank you for listening to the Purple Technical Briefing Series. Until next time, keep your networks secure and your data actionable.

header_image.png

Executive summary

Alta Labs AP6 and AP6 Pro access points integrate with Purple's cloud captive portal using standard RADIUS authentication and HTTP redirection. The AP intercepts unauthenticated guest traffic, redirects it to your Purple splash page, and grants access once Purple's RADIUS server returns an Access-Accept. For multi-tenant environments, Alta Labs' AltaPass technology assigns each connecting device to a unique VLAN and bandwidth policy based on the password used - no additional SSIDs required. This guide gives you the exact configuration steps, walled garden domain lists, and RADIUS parameters to deploy the integration from scratch. Purple operates across 80,000+ live venues and processed 440 million logins in 2024 (Purple internal data). Alta Labs hardware is a strong fit for MSPs and smart office installers who need enterprise-grade segmentation at a competitive price point.


Technical architecture

The integration sits across three layers: the Alta Labs cloud management platform, the AP6 or AP6 Pro hardware at the edge, and Purple's cloud infrastructure handling authentication and analytics.

When a guest connects to the open or WPA3-OWE SSID, the AP places the device in a restricted pre-authentication state. All outbound HTTP traffic is intercepted and redirected to the Purple splash page URL. The device can only reach domains explicitly listed in the walled garden until authentication completes. Once the guest submits their credentials on the Purple splash page, Purple's RADIUS server sends an Access-Accept to the AP, which removes the restriction and grants full internet access. Purple logs the session data - device type, dwell time, login method - and makes it available in the WiFi Analytics dashboard.

architecture_overview.png

For staff and back-of-house networks, the same AP hardware handles WPA2/WPA3-Enterprise (IEEE 802.1X) authentication. The AP acts as the RADIUS client, forwarding authentication requests to Purple's SecurePass infrastructure, which in turn validates credentials against Microsoft Entra ID, Okta, or Google Workspace. The RADIUS Access-Accept response carries the Tunnel-Private-Group-Id attribute, which the AP uses to place the device on the correct VLAN dynamically.


Implementation guide

Step 1: Add the venue and hardware in Purple

Before touching the Alta Labs controller, register the deployment in Purple.

  1. Log in to the Purple management portal and navigate to Management > Locations.
  2. Select Venues and Groups > Add venue and complete the venue wizard.
  3. From your venue, select Hardware > Add hardware > Add new hardware.
  4. Set the hardware type to WiFi AP and select the appropriate AP type.
  5. Enter the MAC address of each Alta Labs AP6 or AP6 Pro unit.
  6. Click View Manual Online to retrieve the RADIUS server IP addresses, ports, and shared secret for this venue. Record these values - you will need them in Step 3.

Step 2: Configure the guest SSID in Alta Labs

Log in to the Alta Labs Cloud Management platform at manage.alta.inc.

  1. Navigate to Settings > WiFi and select the SSID intended for guest access.
  2. In Advanced Settings, set the network type to Guest. This enforces client isolation automatically.
  3. Scroll to the Hotspot section and select External.
  4. In the Redirect URL field, paste the Purple splash page URL provided in your venue hardware settings (e.g., https://region1.purpleportal.net/access/).
  5. Enter the Authorisation Secret (RADIUS shared secret) from your Purple venue settings.
  6. Click Save.

Step 3: Configure RADIUS authentication

With the external redirect in place, configure the RADIUS settings so the AP can communicate with Purple's authentication infrastructure.

Parameter Value
Primary auth server IP Provided by Purple venue settings
Authentication port UDP 1812
Primary accounting server IP Provided by Purple venue settings
Accounting port UDP 1813
Shared secret Provided by Purple venue settings

For high-availability deployments, configure the secondary RADIUS server using the backup IP address provided by Purple.

Step 4: Define the walled garden

The walled garden permits specific domains before authentication completes. Missing entries will break the captive portal flow or prevent social logins from loading. Enter the following domains in the Additional Authorised Hosts / IPs field in the Alta Labs Hotspot configuration.

Purple infrastructure (required)

Domain Purpose
region1.purpleportal.net Splash page hosting
venuewifi.com Purple redirect infrastructure
cloudfront.net CDN for portal assets

OS captive portal probes (required)

Domain OS
captive.apple.com iOS / macOS
connectivitycheck.gstatic.com Android
msftconnecttest.com Windows

Social login (add per provider enabled)

Provider Domains
Google accounts.google.com, oauth2.googleapis.com, apis.google.com, gstatic.com
Facebook facebook.com, graph.facebook.com, connect.facebook.net, *.fbcdn.net
Apple appleid.apple.com, idmsa.apple.com, *.apple.com

captive_portal_flow.png


AltaPass PPSK and multi-tenant segmentation

AltaPass is Alta Labs' patent-pending implementation of Private Pre-Shared Keys (PPSK). It allows a single SSID to carry multiple unique passwords, with each password mapping to a distinct VLAN, bandwidth limit, schedule, and hotspot bypass rule. This eliminates the need to broadcast separate SSIDs for each tenant, staff group, or device category.

Configuring AltaPass in the Alta Labs dashboard

  1. Select your SSID and navigate to the password management section.
  2. Click the purple network type button to the left of each password entry.
  3. Assign a VLAN ID to the password. Clients connecting with this password will be placed on the specified VLAN subnet.
  4. Set bandwidth limits (upload and download) per password as required.
  5. Enable or disable hotspot bypass per password. IoT devices and POS terminals typically bypass the captive portal.
  6. Apply schedule restrictions if required (e.g., restrict internet access for certain devices outside business hours).

altapass_ppsk_segmentation.png

For a 72-unit residential building, this means one SSID and 72+ unique passwords - one per unit, one for management, one for the building automation system. Each password maps to an isolated VLAN and subnet. Residents on the standard tier receive 100 Mbps. Premium residents receive 300 Mbps. The building management team is unrestricted. IoT devices are isolated on a dedicated VLAN with deep packet inspection enabled. This is the deployment model that reduces SSID count from 72 to one.

Dynamic VLAN assignment via RADIUS

For 802.1X staff networks, VLAN assignment works through RADIUS attributes rather than PPSK. The RADIUS Access-Accept response must include:

Attribute Value
Tunnel-Type 13 (VLAN)
Tunnel-Medium-Type 6 (IEEE-802)
Tunnel-Private-Group-Id Target VLAN ID (e.g., "20")

Important: set the default VLAN on the SSID to VLAN 1 (or leave it untagged) when using RADIUS-assigned VLANs. If the default VLAN is set to a specific value, the AP may override the RADIUS assignment with the configured default. This is a known behaviour in the current Alta Labs firmware.


Best practices

The following recommendations apply to any Alta Labs deployment with Purple, regardless of venue type.

Use dynamic DNS resolution for walled garden entries. OAuth providers and CDNs rotate IP addresses frequently. A static IP whitelist will degrade over time. Configure the Alta Labs controller to resolve walled garden domains dynamically, and set a DNS TTL no lower than 30 seconds to avoid excessive query load.

Scope the walled garden precisely. Whitelist only the domains required for the authentication flow. Over-whitelisting - particularly adding wildcard entries for large domains - creates a bypass vector that undermines the purpose of the captive portal.

Test with unauthenticated devices before go-live. Use a device that has never connected to the network. Previously authenticated devices may have cached MAC authorisations or DNS entries that mask walled garden failures. Walk through every login method you intend to offer.

Review walled garden domains quarterly. Apple, Google, and Meta update their OAuth domain structures periodically. Build a quarterly review into your operational calendar to catch drift before it affects users.

Segment IoT devices from the outset. Use AltaPass to assign IoT devices to a dedicated VLAN with hotspot bypass enabled. Mixing IoT traffic with guest or staff traffic creates unnecessary risk and complicates incident response.

For a broader view of enterprise WiFi security architecture, see our guide on Enterprise WiFi Security: A Complete Guide for 2026 .


Troubleshooting and risk mitigation

Splash page fails to appear on iOS. The most common cause is a missing captive.apple.com entry in the walled garden. iOS uses this domain to detect captive portals. If the probe is blocked, the Captive Network Assistant never launches and the user sees a generic connectivity error.

Social login returns a blank screen or CORS error. Check the walled garden for missing CDN or API subdomains. Facebook's *.fbcdn.net and Google's gstatic.com are the most frequently omitted entries. Use browser developer tools in an unauthenticated session to identify which domain requests are failing.

VLAN assignment fails with AltaPass. Verify that the upstream switch port connecting to the AP is configured as a trunk port and allows the tagged VLANs. An access-mode switch port will drop tagged frames silently, leaving the client without an IP address.

RADIUS authentication times out. Confirm that UDP ports 1812 and 1813 are open outbound on the edge firewall. Check that the shared secret in the Alta Labs configuration exactly matches the value in the Purple venue settings - a single character mismatch will cause all authentication requests to fail.

Dynamic VLAN assignment places users on the wrong VLAN. Set the default VLAN on the 802.1X SSID to VLAN 1. If the default VLAN is set to a specific value, the AP may override the RADIUS-assigned VLAN. This is a firmware-level behaviour confirmed in the Alta Labs community forum.


ROI and business impact

Deploying Alta Labs hardware with Purple Guest WiFi delivers measurable returns across three dimensions: operational efficiency, data capture, and security posture.

On the operational side, consolidating multiple SSIDs into a single AltaPass-managed network reduces management overhead and improves wireless performance. Fewer SSIDs mean less beacon frame overhead, which translates directly to higher throughput for all connected devices.

On the data side, Purple's captive portal captures verified first-party data at every login. Venues using Purple's Capture and Engage plans report a 40% increase in marketing database opt-ins compared to unmanaged guest WiFi (Purple internal data). That data feeds directly into WiFi Analytics , giving marketing teams visibility into footfall patterns, dwell time, and repeat visit rates.

On the security side, dynamic VLAN assignment isolates guest, staff, and IoT traffic at the edge. Combined with Purple's ISO 27001-certified infrastructure and GDPR-compliant data handling, this architecture meets the requirements of PCI DSS network segmentation for venues processing card payments.

For hospitality deployments specifically, the combination of branded splash pages, loyalty programme integrations, and per-device bandwidth controls creates a differentiated guest experience without adding complexity to the network operations team.

For retail environments, the ability to segment POS terminals from guest WiFi on the same physical infrastructure - using AltaPass bypass rules - eliminates the need for separate cabling or hardware, reducing both capital and operational expenditure.


Related guides: Arista Cognitive Wi-Fi Integration with Purple WiFi | Walled Garden Configuration for Guest WiFi

Key Definitions

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.

Worked Examples

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.

Examiner's Commentary: This approach uses AltaPass to achieve Identity-Based Networking without SSID proliferation. The key insight is that hotspot bypass is a per-password setting, not a per-SSID setting. This allows the same SSID to serve both captive-portal guests and bypass-enabled staff simultaneously. The loyalty tier distribution via Purple's post-authentication flow is a common pattern in hospitality - the guest logs in on the standard tier, and Purple's marketing engine sends them a premium access code if they match the loyalty criteria.

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.

Examiner's Commentary: This is the single most common captive portal failure mode in the field. Android uses connectivitycheck.gstatic.com and Windows uses msftconnecttest.com for the same purpose. All three must be in the walled garden for a cross-platform deployment. The failure is particularly confusing because it presents as a network connectivity error rather than a portal error, leading engineers to investigate DHCP and DNS before checking the walled garden.

Practice Questions

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?

Hint: AltaPass allows per-password hotspot bypass settings on the same SSID.

View model answer

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?

Hint: iOS uses a specific domain to detect captive portals. If it cannot reach that domain, it assumes the network has no internet access.

View model answer

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?

Hint: There is a known behaviour in Alta Labs firmware related to the interaction between the SSID default VLAN and RADIUS-assigned VLANs.

View model answer

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.