Setting Up the Work Profile

Prerequisite

You need to have an Android device that supports the Lollipop OS version or upwards.

In WSO2 IoTS, data containerization is implemented using the Managed Profile feature. This is only available for the devices that support the Lollipop OS version or upwards.

It is assumed that you have the downloaded Android agent before trying out the following steps.

Click here for more information.

Follow the steps given below to get the android Agent.

Follow the instructions given below to set up the Android work profile:

Open the downloaded file, and tap INSTALL.
Tap OPEN, once the WSO2 Android Agent is successfully installed.
Tap Setup Work-Profile to proceed with registering the Android device via the Work-Profile.
Tap SET UP.
Tap OK to confirm.
Tap UNINSTALL to uninstall the WSO2 IoTS agent you downloaded previously.
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:9443
- Deployment Environment - Enter the domain as your server address.
  
  The Android Agent app's default port is 80. 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 9779 the server IP is as follows: www.abc.com:9779
Tap Yes to continue.
Enter your details and tap Register. A confirmation message will appear.
- Username - Enter the WSO2 IoTS username.
- Password - Enter the 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 BYOD, go to the preceding step - You will be shown a policy agreement, which you can either accept or reject.
  
  You will get access only if you accept the policy agreement.
- If you select COPE, proceed to activate the device administrator - 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.
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.

Once the registration process is complete, navigate to the launcher of your device. You will see that some applications are duplicated, with one set of the applications having a red icon. These applications are the ones used by WSO2 IoTS.