Cloud4Wi - Demo App
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 and easy and effective way to:
- experience the accuracy of geo location 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: customers_write, customers_read, organization_read
Copy your App Client ID and Secret, you'll ned to enter them in the Demo App settings later.
- Configure an new SSID
The the WiFi SDK is pre-configured to use 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. The 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 to configure the external RADIUS settings. Us the following parameters:
- RADIUS Primary IP Address: 126.96.36.199
- RADIUS Secondary IP Address: 188.8.131.52
- 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 form 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 in 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 do 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 purpose only, we suggest removing from your phone all the known WiFi networks.