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.
iOS - IoT Server 3.0.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata

WSO2 IoT Server (WSO2 IoTS) supports devices on iOS 7, 8, 9 and 10. The following subsections explain how you can work with the iOS device type:

Before you start, make sure that your system administrator does all the required configurations to configure the iOS device type in WSO2 IoTS

Enroll an iOS device

Follow the instructions given below to enroll an iOS device:

  1. Sign in to the WSO2 IoTS Device Management Console.

     Click here for more information.
    Follow the instructions below to sign into the IoTS device management console:
    1. Start the server.

    2. Access the device management console.

      • For access via HTTP: 

        For example: http://localhost:9763/devicemgt/
      • For access via secured HTTP: 
        For example: https://localhost:9443/devicemgt/ 
    3. Enter the username and password, and sign in.

      The system administrator will be able to log in using admin for both the username and password. However, other users will have to first register with IoTS before being able to log into the IoTS device management console. For more information on creating a new account, see Registering with IoTS.

    4. Click LOGIN. The respective device management console will change, based on the permissions assigned to the user.
      For example, the device management console for an administrator is as follows:

  2. Click Enroll New Device.
  3. Click iOS to enroll your device with WSO2 IoTS.
    The IoTS registration screen appears in the Safari browser. iOS devices need the root certificate to be downloaded to trust the server certificate. If the certificate is a self-signed SSL certificate, tap Install IoTS Certificate, else go to step 5.

  4. Tap Install as required to download the root certificate. The IoTS registration screen appears.


    If you are using iOS 10 with a self-signed certificate, do the following to mark it as a trusted certificate. This is required in iOS 10 because there is a change in how self-signed CA certificates are trusted by iOS devices from iOS 10 onwards.

    1. Open the Certificate Trust Settings found in Settings>General>About.
    2. Enable full trust for the certificate related to WSO2 IoT Server.

  5. Tap Install IoTS Agent as shown in step 3
  6. After the IoTS agent is installed, click on the WSO2 IoTS app on your device to start the registration.

    Getting an Untrusted Enterprise Developer message?

    When you open the WSO2 IoTS app for the first time, you may see the Untrusted Enterprise Developer message.

     Click here for more informations on how to establish the trust for the IoTS iOS application

    Follow the steps given below to establish the trust for the IoTS iOS application:

    1. Click Cancel to dismiss the Untrusted Enterprise Developer message.
    2. Tap Settings > General > Profiles or Profiles & Device Management.
    3. Tap the WSO2 Inc profile that is under Enterprise App.
    4. Tap Trust "WSO2 Inc".

      An Internet connection is required to verify the app developer's certificate when establishing trust. If you are behind a firewall, make sure it's configured to allow connections to If you are not connected to the Internet when you trust an app, the device displays Not Verified instead. In order to use the app, you need to connect to the Internet, and tap the Verify App button.

    5. Tap Trust to confirm that you trust the developer.

      The developer WSO2 Inc. remains trusted until you use Delete App to remove all apps from the developer.

  7. Tap Allow to let the WSO2 Agent access your device location.

  8. Enter your server address, based on your environment, in the text box provided. 

    • Developer Environment - Enter your entire server address as your server address.
    • Deployment Environment - Enter your domain as your server address.
  9. Tap Start Registration.
  10. Enter your details:

    By default, WSO2 IoTS only supports the BYOD registration process for the iOS platform.

  11. Tap Login. 
  12. Read the End User License Agreement (EULA) and tap I accept the terms.

  13. Tap Install where ever required to install the WSO2 Profile Service.

    A warning message appears to indicate that by installing the profile, WSO2 IoTS has access to remotely manage the iOS device. 

  14. Tap Install.

  15. Tap Trust to confirm that you are aware of the device being remotely managed by installing the profile.

  16. After the profile is installed, click Done.

    Upon the successful registration, the following confirmation appears.

    Thereafter, your browser automatically closes and after 1 or 2 seconds, the native iOS Agent is loaded.

     Click here for more information on how to uninstall the iOS agent.

    Follow the instructions below to uninstall the iOS agent application:

    1. Locate the iOS agent app on your device.

    2. Tap and hold down the icon of the iOS agent app. After a few seconds, all the apps in your iPhone will start wiggling and a tiny "X" icon will appear beside them. Note that the "X" icon will not appear beside the apps that came with the device.
    3. Press the "X" icon that appears beside the iOS agent app. A message-box will appear.
    4. Tap Delete to delete the iOS agent app.
    5. Press the home button to go back to the normal screen. The home button is the circular button that appears below the touch screen.

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:

  1. Navigate to the WSO2 IoTS Device Management page to view all the created devices.

     Click here for more information on navigating to the Device Management page.
    1. Sign in to the Device Management console.
    2. Click the menu icon.
    3. Click Device Management.
  2. Click the view icon on the iOS device you enrolled.

    This directs you to the device details page where you can view the device information and try out operations on a device.

     View device details

    The details of each registered devices will be shown on separate pages within the Device page.

    Device Details

    The following device information will be retrieved automatically when you register with WSO2 IoTS.

    DeviceThis shows the name the user has given his/her device (e.g., Kim's iPhone).
    ModelThe type of device will be stated (e.g., iPhone, iPad)
    IMEIThe International Mobile Station Equipment Identity (IMEI) number of all GSM devices. This is not applicable to devices such as iPads which work without a SIM.
    StatusIndicates if the device is active, inactive or removed from WSO2 IoTS.
    Policy ComplianceIf your device does not comply to certain criteria in the enforced policy, the aspects in which your device is none compliant will be highlighted under this section.
    Device LocationProvide the location of your device.
    Installed ApplicationA list of all the applications that have been installed on your device and the memory consumption by each application will be listed under this section.
    Operation LogA list of all the operations that have been carried out by you and its current status
     Device operations

    Click on the operation you wish to carry out and provide the required details (if requested) to apply the selected operation on your device.

    Device Lock
    Ability to lock a device via WSO2 IoTS.
    Ability to receive the location of the device.
    Mute Device
    Ability to enable the silent profile on a device via WSO2 IoTS.
    Enterprise Wipe
    Ability to unregister a device from WSO2 IoTS.
    Clear Password
    Ability to remove a device lock via WSO2 IoTS.
    Change Lock-Code
    Ability to change the provided passcode or lock-code via WSO2 IoTS.
    Ability to ring the device via WSO2 IoTS.
    Ability to send a message to the device via WSO2 IoTS. The WSO2 IoTS admin can use
    this device operation to send group messages or even private messages to the WSO2 IoTS users.
    APN Configurations
    Ability to set the APN configurations on a user's device. In iOS, the WSO2 IoT server does not detect 
    whether a device (i.e., iPad) has only Wifi, or whether the device has 3G and Wifi. If there is only 
    Wifi, the APN configurations can not be pushed, and a policy violation occurs.
    Google calendar
    Ability to set the google calendar configurations on the WSO2 IoTS user's device.
    Ability to set the LDAP account configurations on the WSO2 IoTS user's device.
  • No labels