What you'll need
- Admin access to your SmartZone controller (vSZ-E, vSZ-H, SZ100, SZ144, SZ300) or a RUCKUS One cloud account with admin rights
- SSH access to the controller, if you're on an on-premises SmartZone (not needed for RUCKUS One cloud)
- Firewall access to open the controller's Northbound Interface port to MyWiFi's servers, if you're on-premises
- The Location already created in your MyWiFi dashboard
Steps
- In the SmartZone admin UI, go to System > General Settings > Northbound Interface. Turn it on and set a strong password. This is a separate password from your admin login — it's used only for this integration, so keep it handy, you'll enter it again in MyWiFi.
- Create a Hotspot (WISPr) portal profile and set "Redirect unauthenticated user" to your MyWiFi splash page URL for this location.
- Create or edit your guest WLAN: set its authentication type to Hotspot (WISPr) and attach the portal profile from step 2.
- Add MyWiFi's domains to the Walled Garden on that WLAN so guests can reach the splash page before they've logged in.
- If you're on an on-premises controller, SSH in as a superuser and run
no encrypt-mac-ip. Skipping this is the single most common reason this integration fails — without it, the controller sends your guests' device info encrypted and MyWiFi can't read it. RUCKUS One cloud controllers don't need this step. - In the MyWiFi dashboard, go to Devices and click Add Device.
- Select the Location, name the device, and under Select Your Hardware choose RUCKUS SmartZone.
- Enter your RUCKUS connection details as prompted — username, password, controller URL, zone ID, and WLAN ID — and save. (RUCKUS One cloud accounts use different credentials under the hood, but confirm with the on-screen field labels at this step rather than this article — that path wasn't independently verified for this guide.)
Best practice: On-premises controllers need inbound access from MyWiFi — the Northbound Interface port (9080 for HTTP, 9443 for HTTPS) has to be open on your firewall to MyWiFi's servers. If guests can never get past the splash page after everything above is configured, check this first.
Comments
Please sign in to leave a comment.