Ruckus SmartZone External Captive Portal Setup Guide
Before You Start
Ensure you have the following ready:
- Access to the Ruckus SmartZone web interface
- Guest portal URL (e.g., https://getonline.captivewifi.io/guest/<site id>
- You can find the Site ID under WiFi hardware
- IP address of the Captive Wi-Fi - 138.68.152.191
Configuration Steps (SmartZone Controller)
1. Login to SmartZone
- Open a browser and log in to the SmartZone web interface.
- Navigate to Network > Wireless LAN.
- Select or Create your desired zone.
2. Create or Edit WLAN
- Create a new WLAN or edit an existing one.
- Set the WLAN Name and SSID (e.g., GuestWiFi).
- Under Authentication Options, select Hotspot (WISPr).
- Under Encryption Options, select None.
3. Configure Hotspot (WISPr) Portal
- Navigate to the Hotspot (WISPr) Portal section.
- Create a new portal profile.
- Set the Portal Name (e.g., GuestPortal).
- For Login URL, select External.
- In Redirect Unauthenticated User - Primary, enter the guest portal URL:
- https://getonline.captivewifi.io/guest/<site id>
4. Add Walled Garden Entries
- In the Hotspot Walled Garden, add the IP address of the Captive Wifi:
-
captivewifi.fra1.digitaloceanspaces.com
-
getonline.captivewifi.io
- 138.68.152.191
5. Authentication Server Settings
- Go to Hotspot Portal > Authentication Server.
- Set Authentication Server to On.
- Select the option Always Accept.
6. Setup Northbound Portal Interface
- Go to Administration > WISPr Northbound Interface.
- Enable it and create a username and password.
- Enter the created credentials in your CaptiveWiFi portal settings.
7. Disable MAC/IP Encryption
This step ensures MAC and IP addresses are logged in plain text for external captive portal integration.
- Access SmartZone via SSH.
- Enter the following command:
- ruckus(config)# no encrypt-mac-ip
8. Test the Captive Portal
- Connect a client device to the configured SSID.
- Ensure redirection to the external captive portal works as expected.
Support: For any configuration assistance, contact Ruckus support or your Captive WiFi administrator.