This documentation is for WSO2 IoT Server 3.0.0. View the documentation for the latest release.
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
Page Comparison - Setting Up the Work Profile (v.2 vs v.3) - IoT Server 3.0.0 - WSO2 Documentation

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titlePrerequisite

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

Info

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. 

Excerpt
Follow the instructions given below to enroll an Android device:
Tip

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

Expand
titleClick here for more information.

Follow the steps given below to get the android Agent. 

Localtab Group
Localtab
titleUsing the QR code
Panel
borderColor#11375B
bgColor#ffffff
borderWidth2
  1. Sign in to the Device Management console.

    Expand
    titleClick here for more information.
    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2
    Excerpt Include
    Accessing the WSO2 IoTS Consoles
    Accessing the WSO2 IoTS Consoles
    nopaneltrue
  2. Click Enroll New Device.
    Image Modified
  3. Click Android to enroll your device with WSO2 IoTS.
Image Removed
  1. Image Added
  2. Enroll the device.
    1. Click Enroll Device.
    2. Scan the QR code to download the Android agent onto your Android device.

      Info

      You need to make sure that your Android device and the

IoTS server
    1. 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
    1.  When this page appears, the web browser will typically display an "insecure connection" message, which requires your confirmation before you can continue.

      Info
      Expand
      titleClick here for more information.

      The WSO2 IoTS consoles are based on the HTTPS protocol, which is a combination of HTTP and SSL protocols. This protocol is generally used to encrypt the traffic from the client to server for security reasons. The certificate it works with is used for encryption only, and does not prove the server identity, so when you try to access these consoles, a warning of untrusted connection is usually displayed. To continue working with this certificate, some steps should be taken to "accept" the certificate before access to the site is permitted. If you are using the Mozilla Firefox browser, this usually occurs only on the first access to the server, after which the certificate is stored in the browser database and marked as trusted. However, with other browsers, the insecure connection warning might be displayed every time you access the server.

      This scenario is suitable for testing purposes, or for running the program on the company's internal networks. If you want to make these consoles available to external users, your organization should obtain a certificate signed by a well-known certificate authority, which verifies that the server actually has the name it is accessed by and that this server belongs to the given organization.

  1. Click Download Android Agent.

Localtab
titleInviting via email
Panel
borderColor#11375B
bgColor#ffffff
borderWidth2
  1. Sign in to the Device Management console.

    Expand
    titleClick here for more information.
    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2
    Excerpt Include
    Accessing the WSO2 IoTS Consoles
    Accessing the WSO2 IoTS Consoles
    nopaneltrue
  2. Click Invite by Email.
  3. Enter the email address of the users who needs to enroll their device with WSO2 IoTS, and click Send Invite(s).
    If you entered your email address, you will receive the registration email.
  4. Click on the link in the email to download the Android agent.
  5. Click Download Android Agent.

Localtab
titleDownloading the APK
Panel
borderColor#11375B
bgColor#ffffff
borderWidth2
  1. Sign in to the Device Management console.

    Expand
    titleClick here for more information.
    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2
    Excerpt Include
    Accessing the WSO2 IoTS Consoles
    Accessing the WSO2 IoTS Consoles
    nopaneltrue
  2. Click Download APK.
  3. Copy the downloaded file to your mobile device.


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

  1. Open the downloaded file, and tap INSTALL.

  2. Tap OPEN, once the WSO2 Android Agent is successfully installed.

  3. Tap Setup Work-Profile to proceed with registering the Android device via the Work-Profile.

    Anchor
    work-profile
    work-profile

  4. Tap SET UP.

    Tap OK to confirm.

  5. Tap UNINSTALL to uninstall the WSO2 IoTS agent you downloaded previously.

  6. Anchor
    start-registeration
    start-registeration

    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.

      Note

      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

  7. Tap Yes to continue.
  8. 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.
  9. 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.

      Info

      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.
  10. Anchor
    Step7
    Step7
    Read the tenant policy agreement, and tap Agree to accept the agreement.  
  11. 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.

    Info

    You will be prompted to provide a PIN code only if your device is a BYOD device.

  12. Confirm the PIN and click OK to continue.
  13. Anchor
    Step10
    Step10
    Tap ACTIVATE to enable the WSO2 Agent administrator on your device. A confirmation message will appear after enabling the device admin.
  14. 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.