This documentation is for WSO2 IoT Server 3.1.0. View the documentation for the latest release.
Page Comparison - Enrolling With the iOS Agent (v.23 vs v.24) - IoT Server 3.1.0 - WSO2 Documentation

Versions Compared

Key

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

...

Excerpt
  1. Sign in to the WSO2 IoT Server 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 if you a device user. If you are administrator click Add under DEVICES.
  3. Click iOS to enroll your device with WSO2 IoT Server.

    Anchor
    Step3
    Step3
    The IoT Server 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 IoT Server Certificate, else go to step 5.

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

    Tip
    titleTip

    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. Anchor
    Step5
    Step5
    Tap Install IoT Server Agent.

    Note

    If you are using iOS 10 or above, you will get the Cannot connect to <IP or host name> error message.
    Example:

    To overcome this, follow the steps given below: 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 Settings > General > About > Certificate Trust Settings .
    2. Enable full trust for the certificate related to WSO2 IoT Server.

    3. Repeat step 5 again and Install the WSO2 IoT Server agent.
  6. After the IoT Server agent is installed, click on the WSO2 IoT Server app on your device to start the registration.

    Info
    titleGetting an Untrusted Enterprise Developer message?

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

    Expand
    titleClick 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.
      Example:
    3. Tap the WSO2 Inc profile that is under Enterprise App.
    4. Tap Trust "WSO2 Inc".

      Info

      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.

  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 and tap Enroll Device. 

    • Developer Environment - Enter your entire server address as your server address.
      Example: https://10.10.10.123
    • Deployment Environment - Enter your domain as your server address.
  9. Enter your details:
    Info

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

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

  12. 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. 

  13. Tap Install.

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

  15. 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.

...