> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oloid-demo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Oloid Connect Beta App Deployment Process

> This document provides a step-by-step process for deploying the Oloid Connect Beta App using Microsoft Intune Mobile Device Management (MDM) system. It covers...

## Introduction

This document provides a step-by-step process for deploying the **Oloid Connect Beta App** using [Microsoft Intune](https://learn.microsoft.com/mem/intune/fundamentals/what-is-intune) Mobile Device Management (MDM) system. It covers the required XML configuration from the Oloid Admin Portal, uploading the .ipa (iOS App Store Package) file, and assigning it as a Line-of-Business (LOB) app. Additionally, it outlines the process for setting up a Managed Device Configuration policy to enable auto-pairing on enrolled iOS devices.

## Deployment Steps

Step 1: Create the XML configuration file from the Oloid Tenant Admin Portal.

Step 2: Share the .ipa file with the IT team via MDM.

Step 3: Deploy the app in Intune.

Step 4: [Create the Configuration policy for the app.](#steps-to-create-the-configuration-policy-for-the-app)

Once all the steps are performed correctly, the app appears in the enrolled iOS devices. Launch the app and pair the devices using auto-pair option to successfully install the app.

> [!NOTE]
>
> **Note:** If you are using the UAT environment, you must manually switch the Oloid Environment configuration within the iOS settings before launching the app. This step is not required when configuring the Production environment.

If you are using the UAT environment, you must manually switch the Oloid Environment configuration within the iOS settings before launching the app.

To set the runtime environment:

1. Open the **Settings** app on your iOS device.
2. Scroll down and select **OloidConnect**.
3. Tap **Environment**, and then select **UAT**.

This step is required only for the UAT environment. You do not need to perform this step for the Production environment.

![Oloid Connect Beta App Deployment... - screenshot 1](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/7e90228c-6659-4f9a-a754-f73656326862-31b688c4.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=5ce4594229a0e502ec331c3199f95799)

## Steps to generate XML Configuration File via Oloid Admin Portal

1. Log in to the **Oloid Tenant Admin Portal**.
2. On the homepage, go to **user profile icon** from the left panel > select **Tenant Settings** > select **Security** tab > click **API Key.**

   ![Oloid Connect Beta App Deployment... - screenshot 2](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-d94bd355.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=615acdcbe1d72d602daa5e52379bc259)
3. Set **Start Date/Time** and **End Date/Time** > click **Generate**.

   ![Oloid Connect Beta App Deployment... - screenshot 3](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/f7193300-8b32-4057-a303-66df7393fc8a-932d322e.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=d22e81f183266e4a63754e1c04f7fb71)
4. Click **Edit** >set **Start Date/Time** and **End Date/Time** > enter **Total Number of Endpoints** and **Number of Endpoints Paired**.

   ![Oloid Connect Beta App Deployment... - screenshot 4](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/lkdjbfvk-3c43e8e1.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=0c899e0003f557658ef1bb88ee03af7c)
5. Click **Save**.
6. Click **Auto-pair config file**.

   ![Oloid Connect Beta App Deployment... - screenshot 5](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/4edeef11-b8a1-42dc-96d3-91794cd78a37-8eac1e44.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=3f9cce563c5eefa0b96d6fcd2c393aaf)

   The Auto-pair config file pop-up box is displayed.
7. Do the following:
   1. Click **Application Type** drop down menu> select **Application Type** as Oloid Verify.
   2. Click **Application** drop down menu > select the preferred **Application**.

Select **XML** > click **Download**.

![Oloid Connect Beta App Deployment... - screenshot 6](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-99b93ae8.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=f717788d5b949e3a73f034e90a789578)

The auto-pair config file is downloaded.

> [!NOTE]
>
> **Note:** If the setup is successful, the configuration XML will be generated in the following format:

```
Xml

<dict>
  <key>ApiKey</key>
  <string>aaa….bbbb</string>
  <key>TenantName</key>
  <string>srs</string>
  <key>TenantID</key>
  <string>8xxxx8</string>
  <key>Environment</key>
  <string>prod</string>
  <key>ApplicationID</key>
  <string>0xxxxA</string>
  <key>TemplateID</key>
  <string/>
  <key>SkipUserConfirmation</key>
  <true/>
</dict>
```

## Steps to Deploy the Oloid iOS App via Intune MDM

Follow the steps below to deploy the Oloid iOS app via Intune MDM:

1. Click **Create** to create a new **iOS** application in **Intune**.

   ![Oloid Connect Beta App Deployment... - screenshot 7](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/8c251863-1365-44f5-82e3-75d7af4f84d8-7b283194.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=36c5dc8773b9e1be52b8ce814ebcf35c)
2. Click **App type** dropdown menu > Select **'Line-of-business app'** as the App type > click **Select**.

   ![Oloid Connect Beta App Deployment... - screenshot 8](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/2576906d-2bb7-47dd-a2c7-b49b21882bdf-764104fa.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=adc36de62e51838f2f7d1b527f8b3b42)
3. Go to **App information** tab > Click **Select App package file** dropdown menu > Select the .ipa file > click **OK**.

   ![Oloid Connect Beta App Deployment... - screenshot 9](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/26d6a146-94ee-4112-b931-795485a796ee-4ab4d1f4.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=625e565fc539e17c171fd71921709c0a)
4. Enter **'Oloid, Inc.'** as the Publisher name > click **Next**.

   > [!NOTE]
   >
   > **Note:** Leave the remaining fields unchanged.

   ![Oloid Connect Beta App Deployment... - screenshot 10](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/53982294-a384-4fc7-b13e-a0cd0dd7ba32-be3b6da6.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=a3f64f1908f61f41ef3e54c30e6934b9)
5. Go to **Assignment** tab > Assign groups as per the company policy > click **Next**.

   ![Oloid Connect Beta App Deployment... - screenshot 11](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/29725209-6d5b-43c8-9072-19dd08c937f5-f8a0bc83.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=759658883c580b2cbb38b7a587c1f8fa)
6. Go to **Review + Create tab** > paste the generated **XML code** in the setting box > click **Create**.

   ![Oloid Connect Beta App Deployment... - screenshot 12](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-004cba13.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=86d165b2f9239395b1b3e045cbad9d05)

   The application is created in intune.

## Steps to create the Configuration policy for the app.

Create and assign a configuration policy to apply the necessary settings for the Oloid iOS app. Follow the steps below to configure iOS managed app deployment for automatic device pairing:

1. Go to **Manage App** > click **Configuration** > **Create** > **Managed Device**.

   ![Oloid Connect Beta App Deployment... - screenshot 13](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-bc412b5c.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=401d5a3c1f9ef505b7305176badecf27)
2. Enter a Name of **Configuration Policy**.
3. Click **Platform** drop down menu > choose **iOS/iPadOS**.
4. Select the application created in **Section 2** as the targeted app.

   ![Oloid Connect Beta App Deployment... - screenshot 14](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-0de9d6b5.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=d7774a484aa55c748c31011592fae8ca)
5. Go to **Setting** tab > click **Configuration setting format** dropdown menu.
6. Choose **“Enter XML data”** >Paste the XML code generated in **Section 1** > click **Next**.

   ![Oloid Connect Beta App Deployment... - screenshot 15](https://mintcdn.com/oloid-999c42b2/NOCuHOpbY881sLY-/images/intercom/11091553/image-5b8af895.png?fit=max\&auto=format\&n=NOCuHOpbY881sLY-\&q=85\&s=60c1f24dda1275ac535cc90bcfb0873c)
7. Assign the required **Groups** on the next screen >create the **configuration**.
   The configuration policy is created for the App.

## ⚠️ Developer Mode Requirement for Ad Hoc iOS Builds

Starting with **iOS 16**, Apple requires **Developer Mode** to be enabled on devices for running apps installed via Ad Hoc, Enterprise, or other direct distribution methods (outside of TestFlight or the App Store).

> [!WARNING]
>
> **Important:** Developer Mode must be enabled for any app installed using Ad Hoc provisioning profiles. This requirement is enforced by Apple and applies to all devices running **iOS 16 or later**.

✅ **What to Expect**

* If the app is distributed via Ad Hoc builds for development or testing, users **must enable Developer Mode** on their iPhone or iPad to launch the app.
* Once the app is published and installed via the **App Store**, **Developer Mode is no longer required** and can be safely turned off.

**Reference**

Apple Developer Documentation – [Enable Developer Mode](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device)
*“On devices running iOS 16 or later, you must enable Developer Mode to install and launch apps using development provisioning profiles, ad hoc distribution, or enterprise distribution.”*

***

## Enabling Developer Mode via MDM

If you're managing iOS devices using MDM solution, such as **Microsoft Intune**, and the devices are **supervised**, you can enable Developer Mode remotely.

Use a configuration profile to set up Developer Mode, so it can be turned off remotely once the app is installed from the App Store.

```
<dict>
    <key>PayloadType</key>
    <string>com.apple.configuration.profile</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
    <key>PayloadIdentifier</key>
    <string>com.connect.oloid</string>
    <key>PayloadUUID</key>
    <string>01234567-89AB-CDEF-0123-456789ABCDEF</string>
    <key>PayloadDisplayName</key>
    <string>Oloid Developer Mode Config</string>
    <key>PayloadContent</key>
    <array>
       <dict>
          <key>PayloadType</key>
          <string>com.apple.developer</string>
          <key>PayloadVersion</key>
          <integer>1</integer>
          <key>DeveloperMode</key>
          <true/>
        </dict>
   </array>
</dict>
```

**MDM Payload to Enable Developer Mode**
