Skip to main content

Ruckus Cloud

Configure Ruckus Cloud-managed access points with IronWifi's cloud-based RADIUS authentication and external captive portal. This guide walks through cloud portal configuration for RADIUS services, guest access portal setup, walled garden configuration, and WPA2-Enterprise deployment for secure guest and employee WiFi networks.

Prerequisites​

In Ruckus Cloud:​

  • Active Ruckus Cloud account
  • Access to cloud.ruckuswireless.com
  • At least one cloud-managed access point
  • Administrative permissions for your organization and venue

In IronWifi Console (complete these first):​

  1. Create a Network

    • Navigate to Networks and click Create Network
    • Note the RADIUS server details:
      • Primary RADIUS Server IP
      • Backup RADIUS Server IP (optional)
      • RADIUS Authentication Port (1812)
      • RADIUS Accounting Port (1813)
      • Shared Secret

  2. Create a Captive Portal

    • Navigate to Captive Portals and click Create Captive Portal
    • Select Vendor: Ruckus
    • Note the Splash Page URL provided
    • Copy the Walled Garden domains list

Ruckus Cloud Configuration​

Access Portal​

  1. Log into cloud.ruckuswireless.com
  2. Select your organization and venue

Step 1: Configure RADIUS​

  1. Navigate to Admin & Services → Services
  2. Click Add Service
  3. Select RADIUS
  4. Configure:
    • Name: IronWifi
    • Primary Server: {Primary IP}
    • Auth Port: 1812
    • Secret: {Secret}
  5. Click Save

Step 2: Configure Guest Portal​

  1. Navigate to Admin & Services → Guest Access
  2. Create new guest portal
  3. Select External type
  4. Configure:
    • Portal Name: IronWifi-Portal
    • Splash Page URL: {IronWifi Splash URL}

Step 3: Configure Walled Garden​

In the Guest Portal settings:

  1. Navigate to Walled Garden section

  2. Add the following required entries:

    • 107.178.250.42
    • *.ironwifi.com
    • *.ironwifi.net
    • splash.ironwifi.com

  3. If using social login providers, add their domains:

ProviderRequired Entries
Google*.google.com, *.googleapis.com, *.gstatic.com, accounts.google.com
Facebook*.facebook.com, *.fbcdn.net, connect.facebook.net, facebook.com
LinkedIn*.linkedin.com, *.licdn.com, linkedin.com
Twitter/X*.twitter.com, *.twimg.com, twitter.com, *.x.com, x.com
Apple*.apple.com, *.icloud.com, appleid.apple.com
Microsoft/Azure AD*.microsoft.com, *.microsoftonline.com, *.msftauth.net, login.microsoftonline.com
Stripe*.stripe.com, js.stripe.com
PayPal*.paypal.com, *.paypalobjects.com
Twilio (SMS)*.twilio.com

Step 4: Create WLAN​

  1. Navigate to WiFi Networks
  2. Click Add WiFi Network
  3. Configure:
    • Name: Guest-WiFi
    • Type: Guest
    • Portal: IronWifi Guest Portal
    • Authentication: IronWifi RADIUS service

WPA-Enterprise​

For 802.1X authentication without captive portal:

  1. Create WiFi Network
  2. Set security to WPA2-Enterprise
  3. Select IronWifi RADIUS service
  4. Configure encryption method (AES recommended)

Testing​

Once configuration is complete, verify everything is working properly:

Test Captive Portal​

  1. Connect a test device to the Guest WiFi network
  2. Open a web browser
  3. You should be automatically redirected to the IronWifi splash page
  4. Complete the authentication process
  5. Verify internet access is granted after authentication

Test Enterprise Authentication​

  1. Connect a device to the WPA-Enterprise network
  2. Enter valid credentials when prompted
  3. Verify successful connection
  4. Check authentication logs in IronWifi Console

Troubleshooting​

If you encounter issues during setup or operation, use this reference to diagnose and resolve common problems:

SymptomPossible CauseSolution
RADIUS service inactiveService not enabledVerify RADIUS service is active in Admin & Services
RADIUS authentication failedIncorrect server IPCheck that RADIUS server IP matches IronWifi Console
RADIUS authentication failedWrong shared secretVerify shared secret matches exactly in both systems (case-sensitive)
RADIUS authentication failedFirewall blocking trafficEnsure ports 1812 and 1813 are open to IronWifi servers
Guest portal not appearingIncorrect portal URLCheck that Splash Page URL matches IronWifi Console
Guest portal not appearingPortal not linked to WLANVerify guest portal is selected in WiFi Network settings
Guest portal not appearingMissing Walled Garden entriesAdd all required IronWifi domains to Walled Garden
Authentication succeeds but no internetClient isolation enabledCheck WiFi Network isolation settings
Social login not workingMissing provider domainsAdd all required domains for the social provider to Walled Garden
Portal appears in cached stateBrowser cachingTest from incognito/private browser window
Clients not appearing in logsAccounting not configuredVerify RADIUS accounting is enabled and port 1813 is configured

For detailed error information:

  1. Review Ruckus Cloud logs: Monitor → Event Logs
  2. Review IronWifi logs: Analytics → Authentication Logs
  3. Check active client sessions: Monitor → Clients