Try WSO2 Cloud for Free
Sign in
||
Skip to end of metadata
Go to start of metadata

In this tutorial, you will enroll an iOS device. You can choose to download the WSO2 agent onto your device by scanning the QR code or by directly typing the URL on the device's browser.

WSO2 Device Cloud supports devices on iOS 7, 8, 9 and 10.

Let's get started!

Enroll your device

  1. Sign up by going to http://wso2.com/iot/cloud/, clicking on the URL sent in the confirmation mail and then selecting WSO2 Device Cloud

  2. The Device Cloud opens. Click Add under DEVICES

  3. Click the iOS device type, and click Enroll Device.
  4. Select one of the options to download the iOS agent onto your device.

    • Scan the QR code with your device, and you will be directed to the web page to download the WSO2 agent. 

      Prerequisite: If you click Scan QR code, you will need to have a QR scanner application on the device.

    • Type the URL given in the device's browser.
  5. Tap  Download IoT Server Agent on this screen.
  6. The registration screen appears in the Safari browser. iOS devices need the root certificate to be downloaded to trust the server certificate. Therefore, tap Install WSO2 Device Cloud Certificate.

  7. Tap Install as required to download the root certificate. Once completed, click Done.
    Example:

    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.

  8. Tap Install WSO2 Device Cloud Agent on the registration screen.

    The agent application starts installing on your device. 
  9. Close the Safari browser and click on the installed WSO2 Agent to start the registration.

    Getting an Untrusted Enterprise Developer message?

    When you open the WSO2 agent 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 WSO2 agent application

    Follow the steps given below to establish the trust for the WSO2 agent 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 https://ppq.apple.com. 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.

    Navigate back to the WSO2 Agent application and open it.

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

  11. Tap Enroll Device.
  12. Enter your details:

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

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

  15. Tap Install where ever required to install the Organizations Profile Service.
    Example:

  16. Tap Install.

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

  18. After the profile is installed, click Done.

    Upon the successful registration, you will be directed the enrollment successful confirmation page.

  19. Tap Allow to let the WSO2 Agent send you notifications.

  20. Click Open to open the WSO2 agent.

    If the registration was successful, you will see the Unregister button when the agent opens. If you don't see it, you will need to start enrolling the device again as the device has not been enrolled with WSO2 Device Cloud.

  21. Navigate to the Device Cloud console and click View under devices to confirm that your device is registered.
  22. Click on your device and you will be able to view the device specific details and carry out operations on your device.
    To get a better understanding let's check out the following scenarios:

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


    Description
    Device Details

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

    Device IDThe unique device identifier.
    NameThis shows the name the user has given his/her device (e.g., Kim's device).
    ModelThe type of device will be stated (e.g., iPhone, iPad)
    StatusIndicates if the device is active, inactive or removed from WSO2 IoTS.
    OwnerThe username or email to whom the device belongs to.
    OwnershipIndicates if the device belongs to any of the following ownership types:
    • Bring Your Own Device (BYOD)
    • Corporate Owned, Personally Enabled
    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.
    Policy ComplianceIf your device does not comply with certain criteria in the enforced policy, the aspects in which your device is none compliant will be highlighted under this section.
    For more information on adding a policy and enforcing it on a device, see Publishing Policies.
    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.
    The operation logs shows the following statuses:
    • IN-PROGRESS - The operation is processing on the IoT server side and has not yet been delivered to the device.
    • PENDING - The operation is delivered to the device but the response from the device is pending.
    • COMPLETED - The operation is delivered to the device and the server has received a response back from the device.
    • ERROR - An error has occurred while carrying out the operation.

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

    For example, click the Ring operation and you will hear your device ring.

    The following operations are supported for iOS in WSO2 Device Cloud:

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

Unregistering and uninstalling the iOS agent

Want to unregister your device from WSO2 IoT Server and uninstall the iOS agent that's on your device? Follow the steps given below:

  1. Open the WSO2 Device Management Application and tap Unregister.
  2. Navigate to Settings > General > Profiles or Profiles & Device Management.
  3. Tap the WSO2 Inc profile that is under ENTERPRISE APP.
  4. Tap  Delete App.

  5. Similarly, tap the  *.cloud.wso2.com and WSO2 IOT Device Management profiles and remove them.

Now you have successfully unregistered your device from WSO2 Device Cloud, removed the profiles that were added when the iOS agent was installed, and uninstalled the WSO2 Device management application.

  • No labels