The Cloud4Wi demo mobile app allows you to experience the power of Cloud4Wi mobile services on your own device. The app implements all the capabilities offered by the WiFi SDK and Geo SDK, providing an easy and effective way to:
- experience the accuracy of geolocation tracking
- verify the extreme precision and reliability of location-based moments
- assess the impact on performances and battery consumption
- experience the automatic WiFi connection on your own WiFi test network
Test environment preparation
In order to test the Demo App in a real scenario, you need to prepare your environment and perform some configurations.
Cloud4Wi Dashboard operations
To get started, you need an active Cloud4Wi account. Login your you account at dashboard.cloud4wi.com
- Create a Location named "HOTSPOT_20"
Go on Manage > Locations and create a new Location entering as a name "HOTSPOT_20".
In the Location setup, the input Identity Domain should be set to the value "Organization".
(Note: if a Location with the same name already exists, do not create a new Location.)
- Add your Access Points to the Account
Add your test Access Points to a location (it can be any location as long as its Identity Domain is set to "Organization"). The value to use as MAC Address / NAS-ID depends on the specific WiFi vendor as detailed in the related configuration guide.
Make sure the Access Points are not currently configured in any other Location or other Cloud4Wi Accounts.
- Create API credentials
Go to Manage > Developers and create a new API V3 application with the following parameters:
- Role: public_app
- Scope: organization_read, organization_write
Copy your App Client ID and Secret, you'll need to enter them in the Demo App settings later.
WiFi Network configuration
- Configure a new SSID
The WiFi SDK is pre-configured to use a dedicated SSID name on the WiFi network, configured with the specific settings. Note that you need to add an additional dedicated SSID on top of those that you already have. In order to work with the demo app, the test SSID name must be "securewifi.io". Depending on the WiFi vendor, you might need to set the same value in different configuration interfaces.
- Configure the SSID with WPA2-Enterprise authentication
The configuration steps vary depending on the WiFi vendor. Here you can find the configuration guide for Cisco Meraki. If you are using other WiFi vendors, please contact our team and we'll send you the related instructions.
- Configure RADIUS service
As part of the WPA2-Enterprise settings, you should have configured the external RADIUS settings. Us the following parameters:
- RADIUS Primary IP Address: 220.127.116.11
- RADIUS Secondary IP Address: 18.104.22.168
- Shared Secret: <will be communicated during account delivery>
- Download the app
The app is currently in private mode, so we need to send you an invitation as a tester to download it from the app stores.
Send to our team your email address associated with the Android or Apple account you are planning to use, and you'll receive an email with the steps to follow to download the app.
Please note that to tun the Demo App on iPhone, you'll need to install TestFlight (learn more here)
- Configure the app
Once you have the Demo App installed, go to WiFi Settings from the menu.
As a WiFi Profile Type, select "WPA2-Enterprise"
Then enter the API Client ID and Secret you created in the previous steps.
Using the Mobile App
The mobile app experience has been designed to emulate the scenario where the user must register explicitly to the service. In your mobile app, you can use the SDK methods to run this step in the background without impacting the user experience.
For the demo, you can initialize a new user on the WiFi page, on the New User tab. You'll receive an email with the automatically-generated password as a reminder. In case you want to perform multiple tests and you already have a user account, you can login with your existing credentials.
At this point, your mobile is enabled and will connect and authenticate automatically to the SSID created above whenever in range.
If there are other WiFi networks in range that are known and your device has already saved their credentials, the device might prefer those networks instead of the new secure network.
For testing purposes only, we suggest removing from your phone all the known WiFi networks.