This article describes how to enable Cloudi-Fi captive portal on Ruckus vSZ 6.x

You will require Ruckus vSZ Controller v6.x to continue. There is a separate documentation for v5.x

Integration tested on a vSZ controller

1. Get Cloudi-Fi required URL and RADIUS secret

Location URL : this URL will be used to configure an External Captive Portal

  • Cloudi-Fi administration > Locations > Click on the menu button of the location and select Copy Splash page URI

  • Transform the URI as following

Company Key :

  • Go to Settings > Company Account and copy the Cloudi-Fi Public Key

Radius Server Information

  • Use the chatbot interface and ask for the Radius IPs and secret

2. Create Hotspot WISPr Service

Go to Services > Hotspots & Portals > Hotspot (WISPr) > Create

  • Portal Name : Cloudi-Fi Captive Portal

  • Smart Client Support : None

  • Logon URL : External

  • Redirect unauthenticated user, Primary : <Cloudi-Fi Splash Page URL>

  • Start Page, Redirect to the following URL :

  • HTTPS Redirect : ON

  • Session Timeout : Same value as Cloudi-Fi Session lifetime

  • Grace Period : Same value as Cloudi-Fi Session Lifetime

  • Walled Garden : Add the URLs below (Additional URL may be added in case of Social Media connector on your captive portal)

    • * 

3. Create Authentication Services

Go to Security > Authentication > Proxy (SZ Authenticator)

  • Name : Cloudi-FI Radius

  • Service Protocol : Radius

  • IP Address, Port and Secret will be provided by Cloudi-FI Support team

4. Create the Guest WLAN

Go to Network > Wireless > Wireless LANs > Select the Zone/WirelessGroup > Create

  • Name : Your Guest SSID’s Name

  • SSID : Your Guest SSID’s Name

  • Authentication Type : Hotspot (WISPr)

  • Method : Open

  • Encryption Options : None

  • Hotspot (WISPr) Portal : Cloudi-Fi Captive Portal

  • Bypass CNA : OFF

  • Authentication Service : Use the controller as proxy and select Cloudi-Fi Radius

  • NAS ID : User-defined <Cloudi-Fi Public Key>

  • Called Station ID : AP MAC

5. Configure the Northbound Interface (NBI) credentials

To allow Cloudi-Fi to communicate with your vSZ controller, we use the NBI.

It allow us to avoid redirection issues (Security Warning to due HTTP Redirection or Certificate warning with HTTPS redirection).

Go to Administration > External Services > WISPr Northbound Interface

  • Enable Northbound Portal Interface Support : ON

  • Then configure you Username and password

6. Provide NBI credentials to Cloudi-Fi

Go to Cloudi-Fi Administration interface > Settings > Integrations > Ruckus SmartZone

And fill out the username and password fields

If you have any questions, please contact us at

Did this answer your question?