Download this guide ⬇
Introduction
Scope and Purpose
Thank you for purchasing the Trusted WiFi solution. This document is a hardware configuration guide describing how to setup a Ruckus SmartZone WLAN Controller for a Trusted WiFi Passpoint service.
For more information on how to setup an end-to-end Trusted WiFi Passpoint service, please refer to the Trusted WiFi Passpoint Administration Guide.
For complete information on how to setup a Ruckus SmartZone WLAN Controller, please refer to the vendor’s original documentation.
Documentation Conventions
The following conventions are used throughout this document:
Notes: Helpful information, suggestions or references.
Warning: Important notification that something might result in a configuration not working, loss of data, equipment damage or personal injury.
Bold and/or green: commands, command options and keywords.
Italics: variable, input requirement for a valid parameter.
Passpoint Overview
Passpoint – also known as Hotspot 2.0 – is an industry-wide next generation approach to public internet access driven by the Wi-Fi Alliance that brings the following benefits:
Frictionless onboarding and roaming, thanks to a one-time registration followed by automatic access to interconnected hotspots
More secure and private Wi-Fi connections, compared with general visitor networks
Passpoint is based on the IEEE 802.11u standard, which is a set of protocols enabling cellular-like roaming. Following the initial enrollment, frequent users such as visitors, guests or employees bypass repeated logins, forms and passwords, as their mobile devices automatically join the Wi-Fi subscriber service when they return to a venue or roam between inter-linked Passpoint enabled hotpots and providers, while being better protected against potential cyber threats.
If a device supports 802.11u and is enrolled to a service, it automatically communicates with the Wi-Fi infrastructure via the access points to discover the network SSID and connects securely to it by presenting its access credentials. Upon successful authentication, the device is provisioned with Passpoint standards-based management objects - known as Per-Provider Subscription Management Objects (PPS-MO).
GlobalReach - an ASSA ABLOY company - has been involved with Passpoint since its inception and even contributed to the creation and initial pilot testing of the standard. As a result, it is one of the few trusted worldwide experts on this topic, with a proven platform backed by real-world operational experiences at scale.
The best user experience is to offer Passpoint through a customer/brand mobile app integration, as it further simplifies the onboarding process, while incentivizing app downloads and customer loyalty, leading to further engagement and monetization opportunities. To this effect, Trusted WiFi offers a Software Development Kit (SDK) for easy app integration.
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
End-to-End Service Components
Implementing an end-to-end Trusted WiFi Passpoint service requires a combination of the following software and hardware components:
Trusted WiFi Passpoint: the core services are offered and managed centrally via the Trusted WiFi Passpoint Module (hosted and operated by GlobalReach). Following an initial setup performed by the GlobalReach Operations team, Managed Service Providers (MSPs) can then add sites to customer realms and monitor the solution.
Customer Realm: the service requires connectivity to a realm including domain, security certificate and private key, as well as the database holding the users’ Personally Identifiable Information (PII). It is the responsibility of the Identity Provider – typically the customer/brand – to make this part available.
Mobile App: the best user experience is to offer Passpoint through a customer/brand mobile app integration. Trusted WiFi offers a Software Development Kit (SDK) for easy implementation. It is the responsibility of the app owner – typically the customer/brand – to perform the integration.
Local Networks: the local networks must be compliant with Passpoint (Hotspot 2.0). – Most recent Wi-Fi access points and controllers from major vendors support Passpoint today, however older models or products from more exotic manufacturers might not do. The configuration of the local infrastructure is typically handled by the Managed Service Providers (MSPs).
User Devices: the subscribers’ mobile devices (belonging to visitors, guests, employees, etc.) must be compliant with Passpoint (Hotspot 2.0) – All recent iOS and Android-based smartphones or tablets support Passpoint today, however older models or products running less popular operating systems might not do. Laptops compatibility is also more erratic. It is therefore essential to maintain a traditional onboarding service in parallel with Passpoint to handle non-compatible devices.
High-Level Topology
The diagram below illustrates the high-level topology for the end-to-end Trusted WiFi Passpoint service:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Glossary
The following is a glossary of the most common terms used regarding this solution.
Term | Abbreviation | Description |
|---|---|---|
Deployment | - | Enabling of a Trusted WiFi product module for a property via the Trusted WiFi interface. |
Module | - | Product or service purchased from Trusted WiFi that is managed through its own sub-section via the Trusted WiFi interface. |
License | - | Legal agreement that grants users the right to use specific software, outlining terms and conditions for its usage, distribution, and potential modifications, while protecting the intellectual property of the software developer. GlobalReach licenses comprise of two different types:
Trusted WiFi is sold as a combination of one-off licenses to activate the service and recurring licenses based on a price per Wi-Fi access point per month. |
Managed Service Provider | MSP | The third-party company that remotely manages and monitors a client's IT infrastructure and end-user systems, offering services like network and infrastructure management, security, and 24/7 technical support. |
Organization | Org | A company account in Trusted WiFi. |
Operator | - | An organization type account in Trusted WiFi that is used by MSPs to manage a property’s Wi-Fi network. |
Customer | - | An organization type account in Trusted WiFi typically used for customers/brands that allows grouping to view all properties belonging to the same company even if managed by several different MSPs. |
Linked Organization | Linked Org | A link creating a relationship between an operator and a customer account, allowing a customer to view a property while allowing an operator to manage it. |
User | - | An individual accessing a product, service or system.
|
Property | - | Trusted WiFi concept representing an Individual site or location where products are deployed. |
Linked Property | - | Site or location shared between operator and customer accounts. |
Passpoint Software Development Kit | Passpoint SDK | The service that sits within the customer’s mobile app and that is connected to the Trusted WiFi RADIUS infrastructure allowing Passpoint profiles to be created for a given Passpoint realm. |
Passpoint Realm | - | The customer specific domain that is used to provision Passpoint profiles that are approved for connection to any associated network. |
Passpoint Profile | - | The security certified profile that sits on a subscriber’s device. If installed correctly it allows seamless authentication to the secure Passpoint SSID. |
Secure Passpoint Service Set Identifier | Secure Passpoint SSID | The Wi-Fi network that is associated to the Passpoint realm configured to allow subscriber devices with a valid Passpoint profile to seamlessly connect to the Passpoint network at a property. |
Subscriber | - | An individual person using a service. |
Subscriber Device | - | The equipment – typically a smartphone, tablet or computer – the subscriber is using to connect to the service. |
Collision-Resistant Unique Identifier | CUID | A unique identifier designed to be collision-resistant – meaning engineered to minimize the likelihood of generating duplicate IDs even in distributed systems – and more efficient in terms of space and database indexing performance due to its sequential nature. In the context of Passpoint, a CUID is delivered to a subscriber device when it requests a Passpoint profile. |
Customer Loyalty Mobile Application | Mobile App | The iOS and/or Android digital application used by businesses to engage and reward their customers through loyalty programs. In the context of Passpoint, the best user experience is to offer Passpoint through a customer/brand mobile app integration using the Trusted WiFi SDK. |
RUCKUS SMARTZONE CONFIGURATION
Supported Versions
Version 3.62 is the oldest version that supports Passpoint. Ruckus recommends running version 5.22 on the controller and either 3.62 or 5.12 on the APs. This will ensure support for both older and newer APs.
Note
Please refer to the Ruckus Wireless AP-Controller Matrix - January 2022 document for further information on which versions of OS code supports which APs.
Prerequisites
It is assumed the following prerequisites are met before configuring a Ruckus SmartZone WLAN Controller for a Trusted WiFi Passpoint service:
A supported Ruckus SmartZone running version 5.22 or greater, activated and licensed.
A Trusted WiFi account with operator permissions.
A core Trusted WiFi Passpoint service configured and tested.
A property in Trusted WiFi with deployed Gateway and Passpoint modules.
A deployed and configured Wi-Fi network.
Note
This document focuses on a specific part of the Ruckus SmartZone configuration only.
Please refer to the Passpoint Administration Guide for instructions on how to configure the end-to-end Passpoint service.
Please refer to the original Ruckus documentation for complete instructions on Ruckus SmartZone WLAN Controllers configuration.
Warning
The Ruckus configuration is focusing on Passpoint v1.0.
All properties must share the same NAI realm, RADIUS IP / port settings and SSID name for the Passpoint service (CustomerPasspoint).
Each property requires a separate RADIUS secret and NAS identifier, both generated when a configuration is activated within the Trusted WiFi management platform.
Core Passpoint Settings
Log into Trusted WiFi, then click on the Properties icon in the left menu to view the properties list.
Select or search for the property you wish to work on. This will open its deployments page:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Click on the Passpoint tile and then click on the Configuration option in the left menu to display the Passpoint settings summary as per the example below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Take note of the details for your respective installation as they will be required at a later step.
Ruckus SmartZone Configuration
RADIUS
Proceed to Security > Authentication > Proxy (SZ Authenticator) > Create to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Complete the fields as per the property RADIUS settings and click OK.
Field
Description
Name
Enter the name of the Server.
Friendly Name
Enter the Friendly Name. It should match the SSID name to ensure Passpoint connection is seamless.
Description
Enter an optional description.
Service Protocol
Select the RADIUS radio button.
Primary Server
IP address
Enter the <Primary RADIUS IP> from Trusted WiFi.
Port
Enter the < RADIUS Authentication Port> from Trusted WiFi.
Shared Secret
Enter the < RADIUS Shared Secret> from Trusted WiFi.
Confirm Secret
Re-enter the <RADIUS Shared Secret> from Trusted WiFi.
Secondary Server
Back RADIUS
Enable the Secondary Server toggle.
IP address
Enter the <Secondary RADIUS IP> from Trusted WiFi.
Port
Enter the < RADIUS Authentication Port> from Trusted WiFi.
Shared Secret
Enter the < RADIUS Shared Secret> from Trusted WiFi.
Confirm Secret
Re-enter the <RADIUS Shared Secret> from Trusted WiFi.
Wi-Fi Operator
Click on Services> Hotspot & Portals > Hotspot 2.0 to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Under the Wi-Fi Operator heading, click +Create to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Complete the fields as per the description below and click OK to save the Operator configuration:
Field
Description
Name
Enter the desired Name.
Description
Enter an optional description.
Domain Name
Enter the first Domain Name as per the Trusted WiFi settings and click +Add to save.
Language
Select the appropriate language from the pull-down list and add the SSID as the Friendly Name. Click on the +Add to save.
Identity Provider
This configuration enables authentication and accounting. The table below details the items for the Service Provider setup (listed as Identity Provider in the Ruckus configuration).
Option
Required
Data Source
Description
Name
Y
Installer’s own
Name of Identity Provider
Description
Installer’s own
Description of the Identity Provider
Realms
Y
Trusted WiFi settings
List of Network Access Identifiers (NAI) realms corresponding to the Service Providers or other entities whose networks or services are accessible via this AP.
Authentication Realm
Y
Installer’s own
RADIUS realm for “No Match” and “Unspecified”
Under the Identity Providers heading on the same screen, click +Create to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Complete the fields as per the description below and click OK to save the Operator configuration:
Field
Description
Name
Enter the desired Name for the RADIUS service.
Description
Enter an optional description.
Realms
Configure the first Realm information (NAI in Settings).
Enter the Name of the Realm.
Enter Encoding values RFC-4282.
Enter the EAP method as EAP-TTLS.
Click the +Add to save.
Click the Next button to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Warning
Since this configuration is designed for Passpoint v1.0, no configuration is required and therefore the user should not Enable Online Signup & Provisioning.
Click the Next button to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Click on No Match Realm and then click on the Configure button to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Select the correct RADIUS service for this realm from the drop-down list and click OK to save.
Repeat the previous steps for the Unspecified Realm and click OK to save.
Click Next to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Select the Accounting tab to configure the accounting ports and toggle the Enable Accounting On, which will allow the default port to be used for this RADIUS service as per the Trusted WiFi settings.
Click Next to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Once satisfied with the configuration, click OK to save.
Passpoint WLAN Profile
From the menu, go to the Networks > Wireless > Wireless LANs section to display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Select the appropriate Zone from the side menu and then click on Create. Fill in the screen as follows
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Complete the fields, as per the description below:
Field
Description
General options
Name
Enter the name of the Service.
SSID
Enter the name of the SSID.
HESSID
Not required.
Description
Enter an optional description.
WLAN Group
Default, or can be changed to the installer’s group if required.
Authentication options
Authentication Type
Check the Hotspot 2.0 Access radio button.
Method
Check the 802.1x EAP radio button.
Encryption Options
Method
Check the WPA2 radio button.
Algorithm
Check the AES radio button.
802.11r
Default is off, but the installer can decide to enabled it if required at the property.
Scroll down to the Hotspot 2.0 Profile section:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Click on the + to create a new Hotspot 2.0 WLAN profile and display the page below:
.png?sv=2022-11-02&spr=https&st=2026-04-17T14%3A46%3A34Z&se=2026-04-17T15%3A07%3A34Z&sr=c&sp=r&sig=pYf7gFPI7y0UWAN4zNy5s%2Bb8wV3V79c3Xgs2Q6fTwPU%3D)
Complete the fields, as per the description below:
Field
Description
Name
Enter the WLAN profile name.
Description
Enter an optional description.
Operator
Select the operator from the drop-down list.
Identity Provider
Select the identity providers from the pull-down list (which were previously configured) and select Add.
Click OK to save the configuration.
Under the Advanced Options section, ensure you configure the VLAN you have setup.
Click OK to save this WLAN.