Step-by-Step Guide: Configuring Ruijie Wireless Controllers for Guest WiFi Captive Portals
This guide provides a complete technical walkthrough for configuring Ruijie wireless controllers and gateways to deploy enterprise-grade guest WiFi captive portals. It covers VLAN segmentation, external RADIUS authentication via WISPr protocol, walled garden configuration, and seamless integration with Purple's Identity-Based Networks platform to capture first-party data and drive measurable business value across hospitality, retail, and public-sector environments.
Listen to this guide
View podcast transcript
- Executive summary
- Technical architecture and prerequisites
- Network segmentation
- Required components
- Authentication protocol overview
- Step-by-step implementation guide
- Step 1: Configure the guest SSID
- Step 2: Define the captive portal policy
- Step 3: Configure the walled garden (allowlist)
- Step 4: Configure RADIUS authentication
- Step 5: Apply QoS policies
- Step 6: Test the deployment
- Best practices for enterprise deployment
- Security and compliance
- Portal Escape: a deliberate decision
- Multi-site consistency
- Firmware management
- Troubleshooting and risk mitigation
- Portal page fails to load
- Authentication timeouts
- Social login hangs
- Dynamic VLAN assignment failures
- ROI and business impact

Executive summary
Deploying guest WiFi across a distributed enterprise requires more than an open SSID. For IT managers and network architects, the challenge is balancing seamless access with strict security, GDPR compliance, and data capture requirements. This guide details the exact configuration steps for deploying a secure, scalable captive portal using Ruijie wireless controllers and gateways - and shows how integrating that infrastructure with Purple's Guest WiFi platform transforms a basic wireless connection into a compliant, revenue-generating asset.
We cover the technical prerequisites, VLAN segmentation strategies, external RADIUS authentication via the WISPr protocol, walled garden configuration, and the specific QoS settings required for a production-grade deployment. Whether you manage a 200-room hotel, a 50-site retail chain, or a stadium with 40,000 attendees, this guide provides the authoritative blueprint for a secure Ruijie captive portal setup. Purple operates across 80,000+ live venues and processed 440 million logins in 2024 (Purple internal data), so the integration patterns described here are proven at scale.

Technical architecture and prerequisites
Before modifying your Ruijie controller, establish the correct network architecture. A secure guest network demands complete isolation from corporate traffic at Layer 2 - the switch level.
Network segmentation
The foundation of secure guest WiFi is VLAN isolation. You must create a dedicated guest VLAN on your Ruijie gateway or core switch. This ensures guest traffic never intersects with internal systems, payment terminals, or staff devices. A standard enterprise VLAN scheme for a Ruijie deployment looks like this:
| VLAN ID | Purpose | Notes |
|---|---|---|
| 10 | Corporate | Staff devices, internal servers |
| 20 | Voice | VoIP handsets |
| 30 | Guest | Captive portal, internet-only |
| 40 | IoT | Printers, smart TVs, sensors |
| 99 | Management | Controller, switch management |
For more on why consumer-grade approaches fail here, read Why Consumer WiFi Gear Doesn't Belong on Your Guest Network .
Required components
To complete this deployment, you need:
- A Ruijie Cloud account or a local Ruijie RG-WS Series Wireless Controller (e.g., RG-WS6008 or RG-WS7110).
- A Ruijie RG-EG Series Gateway - required for external portal authentication via WISPr.
- Ruijie RG-AP Series Access Points (e.g., RG-AP820-I, RG-AP850-AR).
- A Purple Connect, Capture, or Engage licence.
- Outbound UDP access on ports 1812 (RADIUS authentication) and 1813 (RADIUS accounting) from the gateway to Purple's servers.
Authentication protocol overview
Ruijie supports several authentication methods. Enterprise deployments should use external RADIUS authentication. This approach uses the WISPr (Wireless Internet Service Provider roaming) protocol to securely redirect unauthenticated users to Purple's splash page, process their credentials, and return a RADIUS Accept or Reject message to the Ruijie controller.

The table above summarises the five authentication methods available on Ruijie platforms. Email registration and social login are the most common choices for hospitality and retail environments because they capture structured, GDPR-compliant first-party data. Voucher codes suit conference rooms and paid access tiers. RADIUS with 802.1X is reserved for staff networks where directory-backed identity is required.
Step-by-step implementation guide
Follow these steps within the Ruijie Cloud or local controller interface. The UI paths below apply to the Ruijie Cloud new interface (post-2024) and the Ruijie JaCS platform.
Step 1: Configure the guest SSID
Establish the wireless broadcast network.
- Log in to Ruijie Cloud or the local controller web interface.
- Navigate to Device Config and select Wi-Fi under the Wireless section.
- Click + to create a new SSID, or edit an existing one.
- Set the SSID Name (e.g., "Free Guest WiFi").
- Set Security Mode to Open - no pre-shared key.
- Assign the SSID to your dedicated guest VLAN (e.g., VLAN 30).
- Save the SSID configuration.
Step 2: Define the captive portal policy
Instruct the controller to intercept guest traffic and redirect it to Purple.
- Navigate to Auth & Account and select Captive Portal under Authentication.
- Create a new policy. Set a descriptive Policy Name (e.g., "Purple-Guest-Portal").
- Set Policy Mode to External.
- Set Authentication Device to your Ruijie gateway (RG-EG series) or access point.
- Select the guest SSID created in Step 1.
- In the Portal Server URL field, enter your specific Purple splash page URL (available in your Purple dashboard under Hardware Configuration).
- Enter the Purple RADIUS server IP addresses in the designated fields.
- Set Seamless Online duration to match your session timeout policy (e.g., 24 hours for hospitality, one hour for retail).
- Decide on Portal Escape behaviour - see the Best Practices section below.
Step 3: Configure the walled garden (allowlist)
A captive portal intercepts all traffic until the user authenticates. Certain traffic must pass through pre-authentication to allow the login page to load and process social logins. This is the most frequently misconfigured element in any captive portal deployment.
- Navigate to Auth & Account and select Allowlist.
- Add all required Purple infrastructure domains. Your Purple dashboard provides the exact list for your region.
- If you offer social login, add the OAuth domains for each provider:
- For Microsoft Entra ID:
*.microsoft.com,*.microsoftonline.com,login.live.com - For Google Workspace:
*.google.com,accounts.google.com - For Okta: your specific Okta tenant domain
- For Microsoft Entra ID:
- Add any payment processor domains if you offer paid WiFi tiers.
- Save and apply the allowlist.
Step 4: Configure RADIUS authentication
Configure the secure communication channel between Ruijie and Purple.
- Navigate to the RADIUS server settings in your Ruijie controller or gateway.
- Add the primary Purple RADIUS server IP address and port 1812 for authentication.
- Add the secondary Purple RADIUS server IP address as a failover.
- Enter the Shared Secret from your Purple dashboard. This must match exactly.
- Add the accounting server on port 1813 and enable RADIUS accounting. This tracks session duration and data usage, feeding directly into Purple's WiFi Analytics reports.
- Set the NAS Identifier to a meaningful string (e.g., your venue name) to distinguish traffic in Purple's analytics.
Step 5: Apply QoS policies
Unrestricted guest access can saturate your internet link during peak periods.
- Navigate to the QoS or bandwidth management section of your Ruijie gateway.
- Set per-user download limits (e.g., 10 Mbps for hotel guests, 5 Mbps for retail shoppers).
- Set per-user upload limits (e.g., 2-5 Mbps).
- Disable Client Escape to ensure unauthenticated users cannot access the network if the portal server is temporarily unreachable.
- Save and push the configuration to all relevant devices.
Step 6: Test the deployment
Always test from a clean device with no cached credentials.
- Connect a mobile device to the guest SSID.
- Open a browser and navigate to a non-HTTPS URL (e.g.,
http://example.com). The portal should redirect. - Verify the Purple splash page loads correctly.
- Complete the authentication flow.
- Confirm internet access is granted post-authentication.
- Check the Purple dashboard to confirm the session appears in your analytics.
Best practices for enterprise deployment
Security and compliance
Never rely on a shared PSK for guest access. Shared passwords offer no accountability and are impossible to revoke for a single user. By using Purple's captive portal with individual authentication, you enforce explicit consent for data processing, satisfying GDPR Article 7 requirements. Purple holds ISO 27001, GDPR, CCPA, and Cyber Essentials certifications, ensuring the data capture mechanism itself is auditable.
For a deeper look at the security architecture, read our Enterprise WiFi Security: A Complete Guide for 2026 and What Is Secure WiFi: Essential Guide for Business 2026 .
Portal Escape: a deliberate decision
Ruijie's Portal Escape feature automatically releases user traffic if the AP and portal server become unreachable. In a hospitality environment, you may choose to enable it - a guest locked out of WiFi during a server blip generates complaints. In a retail or healthcare environment, you may choose to disable it - unauthenticated access represents a compliance and security risk. Document your decision and the rationale in your network runbook.
Multi-site consistency
Use Ruijie Cloud to manage configuration centrally across all sites. Push portal policies simultaneously to eliminate per-site configuration drift - the most common cause of inconsistent guest experiences across a distributed estate. Purple's cloud overlay operates on the same principle: one dashboard, all venues.
Firmware management
Some Ruijie captive portal features - particularly bandwidth controls and dynamic VLAN assignment - require specific firmware versions on the gateway. Ruijie's release notes document these dependencies. Ensure your RG-EG gateways run firmware RGOS11.9(6)B17T1 or above for full QoS support on cloud-managed deployments.
Troubleshooting and risk mitigation
Portal page fails to load
If the captive portal does not appear when a device connects, verify your walled garden settings first. The device must resolve DNS and reach the Purple portal URL before authentication. Check that your Ruijie allowlist includes all necessary domains and that your DNS server is accessible from the guest VLAN.
Authentication timeouts
If users see the portal but cannot log in, the issue typically lies in the RADIUS configuration. Verify the RADIUS server IP addresses, ports (1812 for authentication, 1813 for accounting), and the shared secret. Ensure your firewall allows outbound UDP traffic on these ports from the Ruijie gateway's management IP.
Social login hangs
If users click a social login button and nothing happens, the OAuth redirect is being blocked. Add the required social provider domains to your Ruijie allowlist. Test by temporarily allowing all traffic pre-authentication to confirm the portal works, then tighten the allowlist incrementally.
Dynamic VLAN assignment failures
If you are using RADIUS to assign users to VLANs dynamically, ensure the RADIUS response includes the correct VLAN attributes (Tunnel-Type, Tunnel-Medium-Type, Tunnel-Private-Group-ID). Ruijie's RG-EG310GH-E and similar gateways support dynamic VLAN assignment, but the feature requires explicit configuration on both the RADIUS server and the gateway.
ROI and business impact
Deploying a secure captive portal transforms guest WiFi from a cost centre into a strategic asset. Purple's WiFi Analytics platform, integrated with your Ruijie infrastructure, captures first-party data, builds high-intent contact lists, and delivers actionable insights into visitor behaviour across your estate.
Harrods used Purple's Guest WiFi to promote its loyalty programme, achieving a market-leading opt-in rate and a 57x ROI (Purple customer data). c2c Rail used Purple to encourage direct bookings, achieving a 121% return on investment and saving £76,000 in operational costs (Purple customer data). Pizza Express deployed Purple across 470+ restaurants to build richer customer profiles.
For hospitality operators, the data captured at login - email, demographic, visit frequency - feeds directly into CRM systems and loyalty programmes. For retail environments, repeat visit analytics identify your highest-value shoppers. For transport hubs, passenger flow data optimises staffing and commercial space planning.
Purple integrates with Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme, and Fortinet - as well as Ruijie - making it the hardware-agnostic cloud overlay that works with your existing estate rather than replacing it.
Related guides: Grandstream GWN Access Points Integration with Purple WiFi
Key Definitions
Captive portal
A web page that a user of a public access network must view and interact with before internet access is granted. It intercepts all HTTP traffic and redirects the user's browser to the portal page.
The core mechanism for enforcing authentication on guest WiFi networks. Used in hotels, retail, stadiums, and public-sector venues to control access and capture consent.
Walled garden
A pre-authentication allowlist that permits specific domains and IP addresses to bypass captive portal interception. Traffic to these destinations is allowed before the user authenticates.
Essential for allowing devices to load the splash page, reach social login providers, and process payment flows before the user is fully authenticated. Misconfiguration here is the leading cause of captive portal failures.
RADIUS
Remote Authentication Dial-In User Service. A networking protocol that provides centralised Authentication, Authorisation, and Accounting management for users connecting to a network service.
The secure protocol Ruijie controllers use to communicate with Purple's servers. Authentication requests go to port 1812 (UDP); accounting records go to port 1813 (UDP).
WISPr
Wireless Internet Service Provider roaming. A protocol specification that defines how a captive portal redirects unauthenticated users to a login page and how the access controller receives the authentication result.
The specific protocol framework used by Ruijie and Purple to handle the external captive portal redirection and authentication flow. Required for external portal mode on Ruijie gateways.
VLAN isolation
The practice of separating network traffic into distinct virtual local area networks at the switch level, preventing devices on different VLANs from communicating directly.
Non-negotiable for guest networks. Ensures guest devices cannot communicate with corporate servers, staff laptops, or payment terminals, even if they are connected to the same physical infrastructure.
Portal Escape
A Ruijie feature that automatically releases user traffic if the access point and portal server become unreachable, allowing unauthenticated internet access during an outage.
A deliberate trade-off between availability and security. Hospitality operators may enable it to prevent guest complaints during outages. Healthcare and retail operators typically disable it to enforce strict authentication at all times.
SSID
Service Set Identifier. The public name of a wireless network that devices display in their available networks list.
The network name guests select on their devices, which triggers the captive portal redirection. Each SSID in a Ruijie deployment is mapped to a specific VLAN and authentication policy.
QoS
Quality of Service. A set of technologies that manage data traffic to reduce packet loss, latency, and jitter, and to ensure predictable performance for specific traffic types.
Used in guest networks to cap per-user bandwidth, preventing a single device from saturating the internet link and degrading the experience for all other connected users.
802.1X
An IEEE standard for port-based network access control, providing an authentication mechanism for devices connecting to a LAN or WLAN.
Used for staff networks requiring directory-backed identity (e.g., via Microsoft Entra ID or Okta). Not typically used for guest networks, where a captive portal with RADIUS is the appropriate pattern.
Worked Examples
A 250-room hotel uses Ruijie RG-AP820-I access points and an RG-EG310GH-E gateway. They require guests to authenticate via email to build a marketing database. Management is concerned about guests bypassing the portal and about peak-hour bandwidth saturation during conference events.
The IT team creates a dedicated guest VLAN (VLAN 40) on the core switch and trunks it to the Ruijie gateway and APs. In Ruijie Cloud, they create an open SSID mapped to VLAN 40. They configure an External Captive Portal policy pointing to the Purple splash page URL, with the Portal Server URL and RADIUS credentials from the Purple dashboard. Crucially, they configure the Walled Garden to allow traffic only to Purple's domains and disable the Portal Escape feature on the Ruijie gateway, preventing unauthenticated access during any portal outage. They apply a QoS policy limiting each client to 10 Mbps down and 3 Mbps up. For conference events, they create a separate SSID on VLAN 50 with a voucher-based portal and tighter bandwidth limits of 5 Mbps per device.
A retail chain with 50 locations uses Ruijie WS6008 controllers. They implement social login (Facebook and Google Workspace) for shoppers accessing WiFi, but the portal page hangs when users click the social login buttons. The issue affects all 50 sites simultaneously.
The IT manager identifies that the Allowlist (Walled Garden) configuration on the Ruijie controllers is missing the OAuth domains required by Facebook and Google. While the Purple portal URL was correctly allowed, the social provider domains needed for the OAuth handshake were blocked by the captive portal interception. The team adds the required wildcard domains - specifically *.facebook.com, *.fbcdn.net, accounts.google.com, and *.googleapis.com - to the Ruijie Allowlist. They push the updated configuration to all 50 sites simultaneously via Ruijie Cloud, resolving the issue across the entire estate in a single operation.
Practice Questions
Q1. You have configured an external captive portal on a Ruijie RG-EG gateway. Guests connect to the SSID, but their devices report 'No Internet Connection' and the portal page never loads. What is the most likely configuration error and how do you resolve it?
Hint: Consider what network operations must succeed before the user can even see the login page.
View model answer
The walled garden (Allowlist) is misconfigured. The Ruijie gateway is blocking DNS resolution or HTTP traffic required to reach the external Purple splash page URL. Before authentication, the device must be able to resolve the portal domain and make an HTTP connection to it. Add the specific Purple domains to the pre-authentication allowlist in the Ruijie Auth & Account section. Also verify that the guest VLAN has a valid DNS server assigned via DHCP.
Q2. A stadium IT director wants to deploy Ruijie APs for fan WiFi during events. They want to collect marketing data but are concerned that RADIUS authentication will cause delays when 10,000 fans connect simultaneously during the first 30 minutes of doors opening. How should they design the authentication flow to balance data capture with user experience?
Hint: Consider the trade-off between data richness and authentication friction at scale.
View model answer
They should use Purple's One-Click Login for returning fans who have previously authenticated, which bypasses the form fill and reduces RADIUS load. For new fans, a minimal email capture form is preferable to social login, which requires additional OAuth round-trips. The Ruijie gateway must be sized to handle concurrent RADIUS requests - for 10,000 simultaneous connections, a high-capacity RG-EG series gateway is required. Enabling Seamless Online with a 30-day session duration means returning fans connect automatically at subsequent events. QoS limits should be strict (5 Mbps per device) to prevent early arrivals from saturating the link before the main crowd arrives.
Q3. During a security audit, a penetration tester accesses the corporate file server while connected to the 'Guest WiFi' SSID broadcast by a Ruijie AP. The guest network uses a correctly configured captive portal. How do you resolve this critical vulnerability?
Hint: Authentication and network segmentation are separate concerns. One does not imply the other.
View model answer
The captive portal is working correctly, but VLAN isolation is missing or misconfigured. The guest SSID is dropping authenticated users onto the corporate VLAN or native VLAN, which has routing access to internal servers. You need to: (1) create a dedicated guest VLAN (e.g., VLAN 50) on the core switch; (2) assign the Guest SSID to VLAN 50 in the Ruijie controller; (3) configure the switch ports connecting the APs as 802.1Q trunks permitting VLAN 50; (4) configure the Ruijie gateway to block routing between VLAN 50 and all corporate subnets, permitting only internet-bound traffic from the guest VLAN. Authentication and network segmentation are independent controls - both must be correctly configured.
Q4. Your Ruijie deployment has Portal Escape enabled. During a planned maintenance window on the Purple RADIUS servers, you notice that guests are accessing the internet without authenticating. Is this expected behaviour, and what are the compliance implications?
Hint: Consider the purpose of Portal Escape and your GDPR obligations.
View model answer
Yes, this is the expected behaviour of Portal Escape. When the portal server is unreachable, Ruijie automatically releases traffic to maintain connectivity. However, this creates a compliance gap: users are accessing the internet without providing consent for data processing, which may violate GDPR requirements if your terms of service or data capture are tied to the authentication event. For venues where consent capture is a legal or commercial requirement, Portal Escape should be disabled. Schedule RADIUS server maintenance during periods of minimal guest activity, and communicate the maintenance window to venue management. Consider implementing a secondary Purple RADIUS server as a failover to eliminate the scenario entirely.
Continue reading in this series
Integrating WeChat WiFi Authentication: Captive Portal Onboarding for APAC Customers
WeChat has 1.41 billion monthly active users, making it the primary digital identity for Chinese consumers globally. This guide explains how to integrate WeChat OAuth 2.0 authentication into enterprise captive portals for APAC venues, covering platform registration, scope selection, RADIUS Change of Authorisation enforcement, and dual-framework compliance with GDPR and China's PIPL. It is aimed at IT managers, network architects, and venue operations directors who need to act this quarter.
Configurando Redireccionamiento de Portal Cautivo en Controladores de Red Enterprise
This authoritative guide details the technical architecture and vendor-specific configuration steps required to implement captive portal redirection on enterprise network controllers. It provides actionable guidance for IT teams on configuring walled gardens, integrating RADIUS authentication, and ensuring compliance with GDPR and PCI DSS.
Configuring Captive Portal Redirection on Enterprise Network Controllers
This authoritative guide details the technical architecture and vendor-specific configuration steps required to implement captive portal redirection on enterprise network controllers. It provides actionable guidance for IT teams on configuring walled gardens, integrating RADIUS authentication, and ensuring compliance with GDPR and PCI DSS.