Skip to main content

A Network Administrator’s Guide to Configuring RADIUS Authentication for Guest WiFi

A comprehensive technical reference for network administrators on deploying RADIUS authentication for guest WiFi. Covers architecture, vendor-neutral configuration steps, security best practices, and troubleshooting common deployment failures.

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

Listen to this guide

View podcast transcript
A Network Administrator's Guide to Configuring RADIUS Authentication for Guest WiFi - Podcast Script [INTRO - approximately 1 minute] Hello and welcome. I'm going to walk you through everything you need to know about configuring RADIUS authentication for guest WiFi - from the underlying architecture through to the practical steps your team needs to take, and the pitfalls that catch most deployments out. This isn't a lecture. Think of it as a briefing from a senior consultant who has sat across the table from IT managers at hotels, retail chains, stadiums, and conference centers, and helped them get this right. We'll cover the technical fundamentals, real-world implementation patterns, and where Purple's cloud-native RADIUS platform fits into the picture. Let's get into it. [TECHNICAL DEEP-DIVE - approximately 5 minutes] So, what actually is RADIUS? RADIUS stands for Remote Authentication Dial-In User Service. It's a networking protocol - defined in RFC 2865 - that provides centralized authentication, authorization, and accounting for network access. In plain terms: it's the system that decides whether a visitor's device is allowed onto your network, under what conditions, and for how long. It then logs the whole session. For guest WiFi specifically, RADIUS sits between your access points and your identity layer. A visitor connects to your SSID, their device sends an authentication request to the access point, the access point forwards that to a Network Access Server - or NAS - which then queries the RADIUS server. The RADIUS server validates the credentials, returns an Access-Accept or Access-Reject, and the session begins or is blocked. Accounting packets then track session duration, data consumed, and termination reason. The three core functions are often called AAA: Authentication, Authorization, and Accounting. Authentication confirms identity. Authorization defines what that identity can access - bandwidth limits, VLAN assignment, session duration. Accounting creates the audit trail. Now, for guest WiFi the authentication method matters enormously. In a corporate environment you'd typically use 802.1X with EAP-TLS - certificate-based, very secure. For guests, that's impractical. Guests don't have certificates on their personal devices. So the common pattern is a captive portal combined with RADIUS. The visitor lands on a splash page, enters their details or authenticates via social login, and the captive portal exchanges those credentials with the RADIUS server on their behalf. The RADIUS server then signals the access point to grant access. This is exactly the architecture Purple operates. Our cloud-native RADIUS service handles the authentication exchange, while the captive portal - which you brand and configure through the Purple platform - manages the visitor-facing experience. The access point simply needs to know the RADIUS server address, port, and shared secret. Purple provides all three. Let's talk ports and protocols. RADIUS authentication traffic runs on UDP port 1812. RADIUS accounting runs on UDP port 1813. You'll configure both on your access points. The shared secret is a pre-shared key between your access point and the RADIUS server - treat it like a password. Use a long, randomly generated string. Never reuse it across deployments. On the hardware side, Purple is hardware-agnostic. We work with Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme, and Fortinet, among others. The configuration steps vary by vendor, but the underlying RADIUS parameters are consistent: server IP or hostname, authentication port 1812, accounting port 1813, shared secret, and accounting interval. For Avaya access points, for instance, you configure the RADIUS attributes under the External RADIUS section, set the Called-Station-Id format to UC-hyphenated MAC format, enable accounting, and then configure the SSID with web page redirection pointing to Purple's captive portal URLs. Purple's support documentation covers the exact steps for Avaya at the link in the guide. For Pepwave MAX series devices, you can configure either through InControl2 - their cloud management platform - or directly through the local web interface. Either way, you're setting up an external captive portal, pointing authentication and accounting at Purple's RADIUS servers, and configuring the SSID with open security and the captive portal attached. Again, the exact steps are in Purple's support docs. One architecture decision worth flagging: primary and secondary RADIUS servers. Always configure both. Purple provides two RADIUS server addresses for redundancy. If the primary is unreachable, the access point fails over to the secondary automatically. Without a secondary, a RADIUS server blip means your guests can't connect. In a hotel with 300 rooms or a stadium with 40,000 fans, that's a serious incident. VLAN segmentation is the other critical piece. Your guest WiFi traffic should never touch your corporate or operational network. Assign guest sessions to a dedicated VLAN, route that VLAN to a separate internet uplink or at minimum through a firewall with strict egress rules. This is a PCI-DSS requirement if you process card payments anywhere on the same physical infrastructure, and it's simply good practice regardless. [IMPLEMENTATION RECOMMENDATIONS AND PITFALLS - approximately 2 minutes] Let me give you the three things that most commonly go wrong. First: shared secret mismatches. The shared secret on the access point must exactly match what's registered in the RADIUS server. Case-sensitive, character-for-character. A single wrong character produces an Access-Reject with no useful error message. Always copy-paste from your Purple dashboard rather than typing manually. Second: allowlist gaps. Before the visitor authenticates, their device needs to reach the captive portal. That means certain domains must be allowlisted on the access point - Purple's portal URLs, authentication endpoints, and any social login providers you're using. If the allowlist is incomplete, visitors see a blank page or a timeout. Purple maintains a current list of required domains in the support documentation - use that list, don't guess. Third: accounting interval. This controls how frequently the access point sends interim accounting updates to the RADIUS server. Set it too long and you lose session granularity. Set it too short and you generate unnecessary traffic. For most deployments, 240 to 300 seconds is the right range. Avaya's recommended interval is 300 seconds; Pepwave's is 180 to 240 seconds. Follow the vendor-specific guidance. On the compliance side: CCPA/CPRA requires that you have a lawful basis for collecting visitor data. A well-configured captive portal with explicit consent checkboxes satisfies this. Purple's platform is GDPR compliant and ISO 27001 certified. Every login through Purple is a conscious-choice opt-in - the visitor actively agrees to your terms before connecting. That audit trail is your compliance evidence. [RAPID-FIRE Q&A - approximately 1 minute] Quick questions I get asked regularly. "Do I need to replace my existing hardware?" No. Purple layers on top of your existing infrastructure. No rip and replace required. "Can I use RADIUS for staff WiFi on the same platform?" Yes. Purple supports separate SSIDs for guest and staff, with different authentication policies on each. "What if my venue has multiple sites?" Purple manages multi-site deployments from a single pane of glass. You configure once and replicate across sites. "Is cloud RADIUS less secure than on-premises?" No. Purple's cloud RADIUS operates with 99.999% uptime, ISO 27001 certification, and end-to-end encryption. The attack surface is smaller than a self-managed server because patching and hardening are handled centrally. "How long does a full deployment take?" For a single venue with supported hardware, a network administrator can complete the RADIUS configuration in under two hours. Purple's onboarding team is available to assist. [SUMMARY AND NEXT STEPS - approximately 1 minute] To summarize. RADIUS authentication for guest WiFi gives you centralized access control, a full accounting trail, and the compliance foundation you need for GDPR and PCI-DSS. The architecture is straightforward: access point to NAS to RADIUS server to Purple's cloud platform. The three things to get right are the shared secret, the domain allowlist, and the accounting interval. Purple operates cloud-native RADIUS across more than 80,000 venues worldwide, handling 440 million logins in 2024. The platform is hardware-agnostic, ISO 27001 certified, and GDPR compliant. Your next steps: check whether your hardware is on Purple's supported list, pull the RADIUS server credentials from your Purple dashboard, and follow the vendor-specific configuration guide in Purple's support center. If you need a hand, Purple's technical team can walk you through it. Thanks for listening. The full written guide with diagrams, worked examples, and configuration references is linked below.

header_image.png

Executive Summary

Providing secure, compliant, and reliable internet access to visitors is a core operational requirement for modern venues. However, deploying open networks exposes organizations to significant risk, while enterprise-grade 802.1X is impractical for unmanaged personal devices. The solution is RADIUS authentication paired with a captive portal.

This guide details the technical architecture, configuration requirements, and best practices for deploying RADIUS authentication for guest networks. By routing authentication and accounting traffic through a cloud-native RADIUS server, IT teams can enforce access policies, isolate guest traffic, and maintain a full audit trail without managing on-premise infrastructure. Purple operates this architecture across 80,000+ venues, handling 440 million logins in 2024. This document provides the blueprint for configuring Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme, and Fortinet hardware to use Purple's Identity-Based Networks.

Technical Deep-Dive

RADIUS (Remote Authentication Dial-In User Service) is a client-server protocol that provides centralized Authentication, Authorization, and Accounting (AAA) management for users who connect and use a network service.

In a guest WiFi context, the visitor's device cannot natively authenticate against the RADIUS server using certificates (EAP-TLS) as corporate devices do. Instead, the WiFi access point acts as the Network Access Server (NAS) and the RADIUS client. When a visitor connects to the open SSID, the access point intercepts their HTTP traffic and redirects them to an external captive portal.

Once the visitor completes the authentication flow on the captive portal - whether via a form, social login, or single sign-on - the portal communicates with the RADIUS server. The RADIUS server then sends an Access-Accept message back to the access point via UDP port 1812, containing authorization attributes such as session timeouts or bandwidth limits. The access point then grants network access and begins sending accounting updates via UDP port 1813 to track the session.

radius_architecture_diagram.png

The Cloud RADIUS Overlay

Managing on-premise RADIUS infrastructure requires significant hardware, maintenance, and redundancy planning. Purple provides a hardware-agnostic cloud RADIUS overlay. This means the authentication and accounting servers are fully managed in the cloud, offering 99.999% uptime and automatic scaling.

comparison_chart.png

By using a cloud overlay, IT teams can standardize access policies across multiple sites and hardware vendors from a single pane of glass, integrating seamlessly with existing Guest WiFi deployments.

Implementation Guide

Deploying RADIUS authentication requires configuring both the wireless infrastructure and the authentication platform. The following steps outline the vendor-neutral process, with specific examples for common hardware.

1. Network Segmentation and SSID Configuration

Guest traffic must be isolated from corporate networks. Create a dedicated VLAN for guest access. Configure the SSID with open security (no WPA2/WPA3 password) but enable captive portal or web page redirection (WPR).

2. RADIUS Server Configuration

You must configure the access point to communicate with the primary and secondary RADIUS servers. This requires three components:

  • Server IP or Hostname: The address of the RADIUS server.
  • Authentication and Accounting Ports: Standard ports are 1812 for authentication and 1813 for accounting.
  • Shared Secret: A cryptographic key used to verify communications between the access point and the RADIUS server.

For example, on a Pepwave MAX Series device, you configure the authentication server under the Captive Portal settings, specifying the IP, port 1812, and the shared secret. You repeat this for the accounting server on port 1813.

3. Walled Garden (Domain Whitelist)

Before authentication, the visitor's device must be able to load the captive portal and any associated identity providers (like Google or Microsoft Entra ID). You must configure a walled garden or domain whitelist on the access point. If this is incomplete, the captive portal will fail to load. Purple maintains a canonical list of required domains for its platform.

4. Accounting Interval

The accounting interval dictates how often the access point sends session updates to the RADIUS server. A common standard is 300 seconds (5 minutes). Setting this too low creates unnecessary traffic; setting it too high reduces the accuracy of your WiFi Analytics .

Best Practices

  1. Always Configure Secondary Servers: RADIUS infrastructure must be highly available. Always configure the secondary RADIUS IP provided by Purple. If the primary server is unreachable, the access point will automatically failover.
  2. Use Strong Shared Secrets: Treat the RADIUS shared secret as a critical password. Generate a long, random string and never reuse it across different venues or platforms.
  3. Validate the Whitelist: The most common cause of captive portal failure is an incomplete domain whitelist. Always test the login flow on a clean device before deploying to production.
  4. Isolate Traffic: Guest VLANs should be strictly isolated. Use firewall rules to prevent any routing between the guest VLAN and operational networks. This is a strict requirement for PCI-DSS compliance in retail and hospitality environments.

Troubleshooting & Risk Mitigation

When a RADIUS deployment fails, the symptoms are usually identical from the visitor's perspective: they cannot connect to the internet. Network administrators must isolate the failure point.

Symptom: The captive portal does not load.

  • Cause: DNS resolution failure or incomplete walled garden.
  • Resolution: Verify that the access point's domain whitelist includes all required URLs. Check that the client device is receiving a valid IP address and DNS server via DHCP.

Symptom: The portal loads, but authentication fails (Access-Reject).

  • Cause: Shared secret mismatch or NAS ID misconfiguration.
  • Resolution: Verify that the shared secret configured on the access point matches the secret in the RADIUS server exactly. Ensure the access point's MAC address or NAS ID is correctly registered in the authentication platform.

Symptom: Sessions disconnect unexpectedly.

  • Cause: Accounting failures or strict idle timeouts.
  • Resolution: Verify that UDP port 1813 is open outbound. Check the idle timeout settings on the access point; some mobile devices aggressively sleep their WiFi radios, triggering an idle disconnect.

ROI & Business Impact

Deploying RADIUS authentication transforms guest WiFi from a cost center and security risk into a managed, compliant asset.

For IT teams, the immediate impact is a reduction in support tickets and the elimination of shared password management. By shifting to a cloud RADIUS model, organizations avoid the CapEx of on-premises servers and the OpEx of maintaining them.

For the wider business, this architecture provides the foundation for secure data collection. By requiring a conscious-choice opt-in through the captive portal, venues build CCPA/CPRA-compliant first-party databases. In the Hospitality and Retail sectors, this data drives loyalty programs and personalized engagement, directly attributing revenue to the network infrastructure.

Listen to our senior consultant briefing on this topic below:

Key Definitions

RADIUS

Remote Authentication Dial-In User Service. A networking protocol that provides centralized authentication, authorization, and accounting management.

Used to secure network access by verifying credentials against a central database before granting a device an IP address or routing its traffic.

Captive Portal

A web page that a user of a public access network is obliged to view and interact with before access is granted.

The primary interface for guest WiFi, used to collect consent, display terms, and capture first-party data.

NAS (Network Access Server)

A gateway that controls access to a network. In a wireless environment, the WiFi access point or controller acts as the NAS.

The NAS acts as the RADIUS client, forwarding authentication requests from the visitor's device to the RADIUS server.

Shared Secret

A cryptographic key known only to the RADIUS client (access point) and the RADIUS server.

Used to verify that RADIUS packets originate from a trusted source and to encrypt passwords within the packets.

Accounting Interval

The frequency at which the access point sends interim session updates to the RADIUS server.

Critical for accurate reporting in analytics platforms. A standard interval is 300 seconds.

Walled Garden

A limited environment that controls the user's access to web content before they are fully authenticated.

Implemented via a domain whitelist on the access point, allowing the device to load the captive portal and identity providers.

VLAN

Virtual Local Area Network. A logical subnetwork that groups a collection of devices, isolating their traffic.

Essential for security; guest WiFi traffic must be assigned to a dedicated VLAN separate from corporate data.

Identity-Based Networks

A network architecture where access policies are dynamically applied based on the authenticated identity of the user or device.

Allows IT teams to enforce different rules for staff, guests, and IoT devices on the same physical infrastructure.

Worked Examples

A 200-room hotel needs to deploy secure guest WiFi across 50 Avaya access points. They require users to authenticate via a branded portal and need to track session data for compliance. How should the network administrator configure the RADIUS settings?

The administrator must configure the Avaya APs to use an external RADIUS server. First, navigate to Security > External Radius. Set the Called-Station-Id Attribute Format to 'UC-hyphenated' and enable Accounting with an interval of 300 seconds. Next, create a 'Guest WiFi' SSID with open encryption and enable Web Page Redirection (WPR). Set the Landing Page URL to the Purple portal and configure the Authentication Service with Purple's primary and secondary RADIUS IPs on port 1812, and accounting on port 1813, using the provided shared secret. Finally, populate the WPR Whitelist with the required domains.

Examiner's Commentary: This approach correctly isolates the authentication flow to an external cloud RADIUS provider while ensuring the local hardware handles the traffic redirection. Setting the Called-Station-Id format correctly is critical for the RADIUS server to identify the access point, and configuring the secondary server ensures high availability.

A retail chain is rolling out guest WiFi using Pepwave MAX routers. During testing, the captive portal splash page fails to load on iOS devices, presenting a blank screen instead. What is the likely cause and resolution?

The likely cause is an incomplete Allowed Networks (domain whitelist) configuration. The administrator must log into the Pepwave local web interface or InControl2 dashboard, navigate to the Captive Portal settings, and verify the 'Allowed Domains / IPs' list. They must ensure all required domains for the captive portal, authentication endpoints, and any social login providers (e.g., Apple, Google) are explicitly listed.

Examiner's Commentary: Whitelist gaps are the most common cause of captive portal failures. Modern mobile operating systems use aggressive captive portal detection mechanisms; if the OS cannot reach its specific validation URLs or the portal's CDN, it will halt the connection process.

Practice Questions

Q1. You are deploying guest WiFi at a large stadium. You have configured the primary RADIUS server, but the project manager asks if the secondary server configuration can be skipped to save time. How do you respond?

Hint: Consider the impact of a single point of failure in a high-density environment.

View model answer

You must configure the secondary server. RADIUS is the gatekeeper for network access. If the primary server experiences an outage or network routing issue, all new authentication requests will fail, resulting in a total loss of guest WiFi access. Configuring the secondary server provides automatic failover and ensures high availability.

Q2. A venue reports that guest WiFi sessions are disconnecting exactly 60 minutes after users log in, despite the Purple platform being configured for 24-hour sessions. Where should you investigate?

Hint: Think about which component actually enforces the session termination.

View model answer

You should investigate the local hardware configuration. The access point or controller (the NAS) ultimately enforces session limits. In this case, the hardware likely has a local 'Session Timeout' or 'Access Quota' hardcoded to 60 minutes, which overrides the RADIUS attributes sent by Purple. For example, on a Pepwave device, the 'Access Quota' setting must be adjusted.

Q3. You are reviewing a proposed network architecture for a retail chain. The design shows guest WiFi traffic and Point of Sale (POS) terminals operating on the same subnet. What is your recommendation?

Hint: Consider security standards and compliance requirements for payment processing.

View model answer

The design must be rejected. Guest traffic must be strictly isolated from operational networks, especially those handling payments. The guest WiFi must be assigned to a dedicated VLAN with firewall rules preventing routing to the POS subnet. Failing to do so violates PCI DSS compliance and introduces severe security risks.