The following article discusses how to set up a Ruckus Cloudpath and Smartzone with the Marketing4WiFi platform. The guide will cover the initial setup of Cloudpath, configuring a secure WLAN on the Smartzone, and set up of Client settings in the Marketing4WiFi platform to provide a PSK to Guests who purchase a Multi Device Guest Plan from a hotspot.
Ruckus Cloudpath Configuration
- Login to the Cloudpath dashboard
- Using the navigation panel to the left click Configuration > RADIUS Server
- Click on the Clients tab and edit the default client
- Collect the RADIUS hosts and RADIUS Secret from this page to use later in the Ruckus Smartzone configuration
- Enable COA: Checked
- Coa Port: 3799
- COA Attributes: Press the add button and configure with
- Acct-Session-ID(string)
- Add If It Doesn’t Exist
- ${ACCT_SESSION_ID}
- Click on the Attributes tab at the top
- Click show to make the following attributes visible
- WISPr-Bandwidth-Max-Down
- WISPr-Bandwidth-Max-Up
- Using the navigation panel to the left click Configuration > API Keys
- Click Add API Key
- Create an enabled API Key with an expiration date sufficiently far out from today’s date. If a key expires it will have to be re-enabled for the integration to work. Record the API Key for use later during the Marketing 4 WiFi configuration
Ruckus Smartzone Configuration
- Login to the Smartzone dashboard
- Using the navigation panel to the left, click Services & Profiles > Authentication
- Click the Proxy (SZ Authenticator) tab at the top and the click the ‘+ Create’ button
- Name: SecurePass-auth
- Service Protocol: RADIUS
- Primary Server
- IP Address: Use the public IP of your Cloudpath
- Port: 1812
- Shared Secret: Use the RADIUS secret collected in step 3 of the Cloudpath configuration
- Using the navigation panel to the left, click Services & Profiles > Accounting
- Click the Proxy tab at the top and the click the ‘+ Create’ button
- Primary Server
- IP Address: Use the public IP of your Cloudpath
- Port: 1813
- Shared Secret: Use the RADIUS secret collected in step 3 of the Cloudpath configuration
- Using the navigation panel to the left, click Wireless LANs and click the ‘+ Create’ button
- General Options
- Name: SecurePass
- SSID: SecurePass WiFi
- Authentication Options
- Authentication Type: Standard usage
- Authentication Method: Open
- Encryption Options
- Encryption Method: WPA2
- Algorithm: AES
- 802.11w MFP: Disabled
- Dynamic PSK: External
- Authentication & Accounting Service
- Authentication Service: SecurePass-auth
- Accounting Service: SecurePass-acct
- Options
- Wireless Client Isolation: ON
- General Options
- Press OK
Marketing4WiFi Platform Configuration
This guide assumes your Client has Guest Plans enabled and configured with a Hotspot already live with Guest Plans enabled. offering Multi Device Guest Plans.
- Login to your Marketing 4 WiFi dashboard
- Use the navigation panel to the left to click Operator Settings > Add/Edit Clients
- Click Edit on the Client you want to enable Cloudpath on.
- Click on the toggle for Enable Cloudpath
- Cloudpath Hostname: Enter the hostname for your Cloudpath
- Cloudpath Username: Enter an valid admin username for your Cloudpath
- Cloudpath Password: Enter an valid admin password for your Cloudpath
- Cloudpath API Key: Enter the API Key created in step 8 of the Ruckus Cloudpath configuration
- Press Submit
- Use the navigation panel to the left to click Network > Guest Plans. Click ‘Add Plan’.
- Select the Client with Cloudpath enabled
- Give the plan a name and a clear description for guests
- Select the intended session profile
- Enter the intended price for this plan
- Registration Header Text and Registration Button Text are used if a guest is using a Voucher
- Enable Multi Devices: Yes
- No. of Devices per Plan can be set to the amount of
- Pre-expiration Message Time: Select the amount of time before a plan expires you want a guest to receive a warning message about their plan expiring.
- Press Submit.
- Repeat step 6 to create as many Multi device guest plans as desired
- Use the navigation panel to the left to click Network > Hotspots
- Click on the edit icon for the hotspot that will utilize the Cloudpath integration
- Click on the toggle for Enable SecurePass
- WPA Key Confirmation Page: Click the blue plus icon to create a page and then use the edit page body button to build your own template. This is the page that will be displayed to users after purchasing a Guest Plan to provide on that original device the details of their DPSK
- SSIDs: SecurePass WiFi (or whatever SSID name was used in step 6.1 of the Ruckus Smartzone configuration
- Add the Guest Plans created in step 6
- Press Submit
Guest Experience
- When a guest selects a Multi Device Guest Plan to purchase from a hotspot with Cloudpath enabled they’ll be presented with options on how to receive their private password.
- After successfully purchasing the plan regardless of selection devices will be presented an interstitial page displaying key information about the PSK associated to their purchased plan.
- At the defined interval before the DPSK expires the hotspots Guest Plan Expiration Email will be sent to the contact information if it was provided.