WSO2 IoTS supports devices on Android version 4.2.x to 7.0 (Android Jelly Beans to Nougat). The following subsections explain how you can enroll your own device with WSO2 IoT Server and start using it.
Enroll an Android device
Follow the instructions given below to enroll an Android device:
Sign in to the Device Management console.
- Click Enroll New Device.
- Click Android to enroll your device with WSO2 IoTS.
- Enroll the device.
- Click Enroll Device.
Scan the QR code to download the Android agent onto your Android device.
You need to make sure that your Android device and the IoT Server are on the same network, else you will not be able to download the Android agent.
After scanning the QR code you will be directed to a web page. When this page appears, the web browser will typically display an "insecure connection" message, which requires your confirmation before you can continue.
Click Download Android Agent.
Open the downloaded file, and tap INSTALL.
- Tap OPEN, once the WSO2 Android Agent is successfully installed.
Tap Skip and go to Enrollment to proceed with the default Android enrollment process.
If you want to set up the work profile and enable data containerization, click Setup Work-Profile .
Enter the server address based on your environment, in the text box provided. A confirmation message will appear.
- Developer Environment - Enter the server IP as your server address.
Example: 10.10.10.123:8280 Deployment Environment - Enter the domain as your server address.
The Android Agent app's default port is 8280. If you are using any other port, the server address should state the new port in the following format:
www.abc.com
:<PORT>
For example, if the port is 8289 the server IP is as follows:www.abc.com:8289
- Developer Environment - Enter the server IP as your server address.
- Tap Yes to continue.
- Enter your details and tap Register. A confirmation message will appear.
Username - Enter your WSO2 IoTS username.
Password - Enter your WSO2 IoTS password.
- Domain - Enter the domain only if the server is hosted with multi-tenant support.
- Ownership type - Select the corresponding device ownership option. This will customize the device management behavior accordingly.
- BYOD - Bring your own device.
- COPE - Corporate owned personally enabled.
- Tap Yes to continue.
If you select BYODgo to step 13 - You will be shown a policy agreement, which you can either accept or reject.
You will get access to WSO2 IoTS only if you accept the policy agreement.
- If you select COPEgo to step 17 - As it's a corporate owned device, you will not be shown a policy agreement. You will have to adhere to the company policy.
- Read the tenant policy agreement, and tap Agree to accept the agreement.
Tap ALLOW to allow the WSO2 Android agent to make and manage phone calls, access photos, media, and files, and access the device location respectively.
You will get this message only if your Android OS is Marshmallow (6.0) or above.
Example:
Set a PIN code of your choice with a minimum of 4 digits. The PIN code will be used to secure your personal data. Thereby, the IoT server will not be able to carry out critical operations on your personal data without using this PIN.
Example: If the device management admin needs to wipe your device or remove data from the device, he/she can not directly wipe it without the PIN code. You have to provide the PIN code to get your device wiped or you can log into the device management console and wipe your device by entering the PIN code. A confirmation message will appear.You will be prompted to provide a PIN code only if your device is a BYOD device.
- Confirm the PIN and click OK to continue.
- Tap ACTIVATE to enable the WSO2 agent administrator on your device. A confirmation message will appear after enabling the device admin.
You have now successfully registered your Android device. If you wish to unregister the registered device, click Unregister.
Configure the email settings to send out an invitation for users to register their device with WSO2 IoTS.
Sign in to the Device Management console.
- Click Invite by Email.
- Enter the email address of the users who need to enroll their device with WSO2 IoTS, and click Send Invite(s).
If you entered your email address, you will receive the registration email. - Click on the link in the email to download the Android agent.
Click Download Android Agent.
Open the downloaded file, and tap INSTALL.
- Tap OPEN, once the WSO2 Android Agent is successfully installed.
Tap Skip and go to Enrollment to proceed with the default Android enrollment process.
If you want to set up the work profile and enable data containerization, click Setup Work-Profile .
Enter the server address based on your environment, in the text box provided. A confirmation message will appear.
- Developer Environment - Enter the server IP as your server address.
Example: 10.10.10.123:8280 Deployment Environment - Enter the domain as your server address.
The Android Agent app's default port is 8280. If you are using any other port, the server address should state the new port in the following format:
www.abc.com
:<PORT>
For example, if the port is 8289 the server IP is as follows:www.abc.com:8289
- Developer Environment - Enter the server IP as your server address.
- Tap Yes to continue.
- Enter your details and tap Register. A confirmation message will appear.
Username - Enter your WSO2 IoTS username.
Password - Enter your WSO2 IoTS password.
- Domain - Enter the domain only if the server is hosted with multi-tenant support.
- Ownership type - Select the corresponding device ownership option. This will customize the device management behavior accordingly.
- BYOD - Bring your own device.
- COPE - Corporate owned personally enabled.
- Tap Yes to continue.
If you select BYODgo to step 13 - You will be shown a policy agreement, which you can either accept or reject.
You will get access to WSO2 IoTS only if you accept the policy agreement.
- If you select COPEgo to step 17 - As it's a corporate owned device, you will not be shown a policy agreement. You will have to adhere to the company policy.
- Read the tenant policy agreement, and tap Agree to accept the agreement.
Tap ALLOW to allow the WSO2 Android agent to make and manage phone calls, access photos, media, and files, and access the device location respectively.
You will get this message only if your Android OS is Marshmallow (6.0) or above.
Example:
Set a PIN code of your choice with a minimum of 4 digits. The PIN code will be used to secure your personal data. Thereby, the IoT server will not be able to carry out critical operations on your personal data without using this PIN.
Example: If the device management admin needs to wipe your device or remove data from the device, he/she can not directly wipe it without the PIN code. You have to provide the PIN code to get your device wiped or you can log into the device management console and wipe your device by entering the PIN code. A confirmation message will appear.You will be prompted to provide a PIN code only if your device is a BYOD device.
- Confirm the PIN and click OK to continue.
- Tap ACTIVATE to enable the WSO2 agent administrator on your device. A confirmation message will appear after enabling the device admin.
You have now successfully registered your Android device. If you wish to unregister the registered device, click Unregister.
Sign in to the Device Management console.
- Click Download APK.
- Copy the downloaded file to your mobile device.
Open the file, and tap INSTALL.
- Tap OPEN, once the WSO2 Android Agent is successfully installed.
Tap Skip and go to Enrollment to proceed with the default Android enrollment process.
If you want to set up the work profile and enable data containerization, click Setup Work-Profile .
Enter the server address based on your environment, in the text box provided. A confirmation message will appear.
- Developer Environment - Enter the server IP as your server address.
Example: 10.10.10.123:8280 Deployment Environment - Enter the domain as your server address.
The Android Agent app's default port is 8280. If you are using any other port, the server address should state the new port in the following format:
www.abc.com
:<PORT>
For example, if the port is 8289 the server IP is as follows:www.abc.com:8289
- Developer Environment - Enter the server IP as your server address.
- Tap Yes to continue.
- Enter your details and tap Register. A confirmation message will appear.
Username - Enter your WSO2 IoTS username.
Password - Enter your WSO2 IoTS password.
- Domain - Enter the domain only if the server is hosted with multi-tenant support.
- Ownership type - Select the corresponding device ownership option. This will customize the device management behavior accordingly.
- BYOD - Bring your own device.
- COPE - Corporate owned personally enabled.
- Tap Yes to continue.
If you select BYODgo to step 11 - You will be shown a policy agreement, which you can either accept or reject.
You will get access to WSO2 IoTS only if you accept the policy agreement.
- If you select COPEgo to step 15 - As it's a corporate owned device, you will not be shown a policy agreement. You will have to adhere to the company policy.
- Read the tenant policy agreement, and tap Agree to accept the agreement.
Tap ALLOW to allow the WSO2 Android agent to make and manage phone calls, access photos, media, and files, and access the device location respectively.
You will get this message only if your Android OS is Marshmallow (6.0) or above.
Example:
Set a PIN code of your choice with a minimum of 4 digits. The PIN code will be used to secure your personal data. Thereby, the IoT server will not be able to carry out critical operations on your personal data without using this PIN.
Example: If the device management admin needs to wipe your device or remove data from the device, he/she can not directly wipe it without the PIN code. You have to provide the PIN code to get your device wiped or you can log into the device management console and wipe your device by entering the PIN code. A confirmation message will appear.You will be prompted to provide a PIN code only if your device is a BYOD device.
- Confirm the PIN and click OK to continue.
- Tap ACTIVATE to enable the WSO2 agent administrator on your device. A confirmation message will appear after enabling the device admin.
You have now successfully registered your Android device. If you wish to unregister the registered device, click Unregister.
Try it out
You can view device details and carry out operations on your device, after successfully enrolling it with WSO2 IoTS. Let's take a look at how you can do it:
Navigate to the Device Management page to view all the created devices.
Click the view icon on the Android device you enrolled.
Example:You will be directed to the device details page where you can view the device information and try out operations on a device.
Example: