# iOS/iPadOS BYOD User Enrollment

# Automatic VPP License Assignment for iOS/iPadOS BYOD

## What

Device-based VPP license assignment is the preferred method for managed iOS and iPadOS devices because it does not depend on a user's Apple Account. BYOD enrollment cannot use device-based assignment, however, and some content such as Apple Books requires user assignment. FileWave's Automatic setting handles both cases: it uses device-based assignment when the device and content support it, then falls back to user-based assignment when they do not.

## When/Why

A VPP app association can assign its license to the device or the user. The VPP preference sets the default for new associations, while the license setting on an individual association can override that default. Select **Automatic** in Preferences when you want new associations to choose the compatible assignment method. The preference is shown below.

![Ea0PDKxrNsyeEDgx-embedded-image-fxfhju8d.png](https://kb.filewave.com/uploads/images/gallery/2023-07/Ea0PDKxrNsyeEDgx-embedded-image-fxfhju8d.png)

You can override that default on an individual association:

![LW7IthUUENgGfa6v-embedded-image-hgjmdccv.png](https://kb.filewave.com/uploads/images/gallery/2023-07/LW7IthUUENgGfa6v-embedded-image-hgjmdccv.png)

**Automatic** first tries device-based licensing. If the device or content cannot use that method, FileWave uses user-based assignment instead. The fallback still needs a FileWave user and VPP user association that can receive the license; Automatic changes the assignment method, not the user identity behind it.

Automatic assignment also helps when you do not manage BYOD devices. Apps that support device-based licensing continue to use it. If you later associate an app that lacks device-based licensing or an Apple Book that requires a user, FileWave can use user assignment for that association without forcing you to remember a one-off setting change.

## How

Changing the preference affects new associations. Existing associations keep their current license setting. If a BYOD device receives a device-based association, the app can be associated but cannot install because that enrollment cannot use device-based licensing. Update applicable older associations to **Automatic** so FileWave can fall back to user assignment.

<p class="callout info">If many existing associations need the same change, use the Associations view to edit them in bulk.</p>

# iOS BYOD User Enrollment Overview

## What

With Version 14(+) of FileWave, you can now BYOD (bring-your-own-device) enroll a device without giving total management of the device to the system admin.

## When/Why

Typically, this option works best if the device to be supported is not company owned. For instance, an employee with their own iPhone may want to BYOD enroll a device to allow distribution of company-owned app licenses, but without giving their company the ability to manage their phone in other ways.

## How

BYOD enrollment is off by default in FileWave, and must be enabled on the Mobile tab in preferences as shown below:

![GaGowZyVosOOdnaC-embedded-image-yj5xldb0.png](https://kb.filewave.com/uploads/images/gallery/2023-07/GaGowZyVosOOdnaC-embedded-image-yj5xldb0.png)

Once enabled, a new tab will be added to the "Enroll iOS Device..." Assistant:

![MkgZMhVp7SHODrkA-embedded-image-xwn96lu6.png](https://kb.filewave.com/uploads/images/gallery/2023-07/MkgZMhVp7SHODrkA-embedded-image-xwn96lu6.png)

And, once user enrollment is enabled, you can go to [https://my.server.address:20443/ios/byod](https://my.server.address:20443/ios/byod) to see the user enrollment page:

![Nl5KS8EcGK6hoY6M-embedded-image-ci6ebasr.png](https://kb.filewave.com/uploads/images/gallery/2023-07/Nl5KS8EcGK6hoY6M-embedded-image-ci6ebasr.png)

Note that by BYOD's very nature the only way you will enroll BYOD devices is through this page. (i.e. it won't be through ADE). BYOD enrollment **does** require the use of managed apple ids from either Apple School, or Apple Business, Manager.

See below video of a BYOD device enrollment:

<video controls="controls" height="411" style="width: 824px; height: 411px;" width="824"><source src="https://kb.filewave.com/attachments/127"> </source></video>

<p class="callout success">Unlike a ADE enrollment, you don't have to wipe the device first to BYOD enroll it. However, trying to enroll a device with a managed Apple ID that is already logged into iCloud on the device will result in an error.</p>

# Account-Driven User Enrollment for iOS/iPadOS BYOD Devices (v15.0+)

## What

In 2021, Apple introduced [**Account-Driven User Enrollment**](https://support.apple.com/guide/deployment/user-enrollment-and-mdm-dep23db2037d/web), a new method for initiating Bring Your Own Device (BYOD) enrollments. With the releases of **iOS 17** and **iPadOS 17**, profile-based User Enrollment is deprecated, and starting with **iOS 18** and **iPadOS 18**, it is no longer supported. To align with these changes, **FileWave 15.5** now supports Account-Driven User Enrollment (ADUE), enabling organizations to securely enroll BYOD devices using this new workflow.

## When/Why

#### **When to Use**

- **BYOD Environments**: When employees use their personal iOS or iPadOS devices for work purposes and need access to corporate resources.
- **Transitioning from Profile-Based Enrollment**: As profile-based User Enrollment is being phased out, organizations should begin migrating to Account-Driven User Enrollment to ensure compatibility with future iOS and iPadOS versions.

#### **Why This Feature Matters**

Apple aims to enhance the security and privacy of BYOD deployments. Account-Driven User Enrollment offers several benefits:

- **Improved Security**: Separates personal and corporate data more effectively, protecting user privacy and corporate assets.
- **Simplified Enrollment**: Users can enroll their devices by signing in with their Managed Apple ID, streamlining the enrollment process.
- **Modern Authentication**: Utilizes OAuth 2.0 and OpenID Connect for authentication, providing a more secure and standardized method.
- **Organizational Control**: Shifts the responsibility of secure enrollment to the organization, allowing for better compliance with internal policies.

Account-Driven Enrollment relies on the [**Well-known URI**](https://en.wikipedia.org/wiki/Well-known_URI) mechanism for Mobile Device Management (MDM) discovery, ensuring that devices can locate the MDM server securely and efficiently.

## How

#### **Enrolling a Device Using Account-Driven User Enrollment**

To enroll an iOS or iPadOS device using Account-Driven User Enrollment with FileWave 15.5:

- **On their iPhone or iPad, the user navigates to** Settings &gt; General &gt; VPN &amp; Device Management **and taps** Sign In to Work or School Account.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/5oC3vsAbEKfDJLK9-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/5oC3vsAbEKfDJLK9-image.png)

The email entered is used by the device to discover the MDM server. For example, if you enter “pn@widget.ch”, the device queries the <span class="s1">widget.ch</span> domain, specifically at <span class="s1">https://widget.ch/.well-known/com.apple.remotemanagement</span>.

This endpoint must return a specific JSON message containing all the information required to proceed with MDM BYOD enrollment. Therefore, organizations must have control over this URL, which could be an issue for those who completely outsource their website management (see below for potential workarounds).

**FileWave Setup**

The existing User Enrollment option in FileWave now enables both legacy BYOD and the new Account-Driven Enrollment (ADUE):

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/yGZsdBdXSA9XEO0r-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/yGZsdBdXSA9XEO0r-image.png)

FileWave cannot manage your domain but provides some helpful options:

1. **Retrieving the Well-Known Content (JSON):**
    
    
    - If you prefer to host the required file yourself, you can easily obtain the necessary JSON content from FileWave.
    - Click the **“Well-known content”** button in the FileWave interface. The following JSON will be copied to your clipboard:
        
        ```json
        {"Servers": [{"Version": "mdm-byod", "BaseURL": "https://pn.widget.ch:20445/ios/byod/enroll/"}]}
        ```
    - Create a file containing this JSON and serve it from your web server at the appropriate URL (<span class="s1">https://yourdomain/.well-known/com.apple.remotemanagement</span>).
2. **Setting Up a Redirection to the FileWave Server Endpoint:**
    
    
    - Alternatively, you can configure your web server to redirect requests from <span class="s1">https://yourdomain/.well-known/com.apple.remotemanagement</span> to the FileWave server endpoint.
    - Retrieve the endpoint URL by clicking the **“Well-known URL”** button in FileWave. For example, the endpoint might be:
        
        ```
        https://pn.widget.ch:20445/ios/byod/well-known/
        ```
    - Consult your web server documentation for details on setting up the redirection. For instance, to configure Apache, add the following directive inside the <span class="s1">VirtualHost</span> section:
        
         ```
        RewriteRule ^/.well-known/com.apple.remotemanagement https://pn.widget.ch:20445/ios/byod/well-known/ [R=301,L]
        ```

## Related Content

- [Apple: User Enrollment and MDM](https://support.apple.com/guide/deployment/user-enrollment-and-mdm-dep23db2037d/web)
- [Well-known URI](https://en.wikipedia.org/wiki/Well-known_URI)
- [Apple MDM Enrolment Methods](https://kb.filewave.com/books/filewave-client/page/apple-mdm-enrollment-methods "Apple MDM Enrolment Methods")

## Digging Deeper

#### **Device Enrollment Process Workflow**

<table border="1" id="bkmrk-navigate-to-settings" style="border-collapse: collapse;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>Navigate to Settings, General</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/tq2PCb6gCuqRphTW-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/tq2PCb6gCuqRphTW-image.png)  
</td></tr><tr><td>Navigate to VPN &amp; Device Management</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/hyAItT9cxY7Kf4dO-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/hyAItT9cxY7Kf4dO-image.png)  
</td></tr><tr><td>Tap Sign In to Work or School Account…</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/bBqsiNY4erlle5Is-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/bBqsiNY4erlle5Is-image.png)  
</td></tr><tr><td>Enter your Managed Apple Account, press Continue.</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/kXiGF0wE1t4cdBMg-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/kXiGF0wE1t4cdBMg-image.png)  
</td></tr><tr><td>The device will now display the standard authentication page if configured; IDP login is also supported. Enter your credentials and tap **Sign In**.

</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/oa2AAiixc6YiMbsD-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/oa2AAiixc6YiMbsD-image.png)  
</td></tr><tr><td>After a few seconds, the device will prompt you to sign in to iCloud. Tap the button and enter your Managed Apple ID password.

</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/KHCgfQfrpAqvdT4y-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/KHCgfQfrpAqvdT4y-image.png)  
</td></tr><tr><td>And then, press Allow Remote Management to start enrollment.</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/Aty7A0bIdtXDjgL4-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/Aty7A0bIdtXDjgL4-image.png)

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/1hI6sInR8VIY54Ei-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/1hI6sInR8VIY54Ei-image.png)

</td></tr><tr><td>After enrollment, device may prompt to restore iCloud data.</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/0Hra65EMqheLcVga-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/0Hra65EMqheLcVga-image.png)  
</td></tr></tbody></table>

Now the device is ready. As a final step, you need to add the device to FileWave. It will appear in the “New Mobile Client” dialog, or it will be automatically added to the model if [Auto-Enrollment](https://kb.filewave.com/books/filewave-central-anywhere/chapter/conflict-resolution) is enabled.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2024-10/scaled-1680-/2of9h81jH0zBDjZI-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-10/2of9h81jH0zBDjZI-image.png)

# Managing BYOD User Enrollment

## What

You have no doubt gotten used to managing supervised iOS devices, where you have the ability to manage most elements of the device. If you have previously had folks do a manual OTA enrollment, then you know you have less management of those devices than those that are supervised. BYOD user enrolled devices take that a step further, and even fewer capabilities exist (but for good reason).

## When/Why

If you are going to utilize BYOD enrollment, it is because the devices to be enrolled actually shouldn't be managed by you, but they should have the ability to leverage the organization's resources. So, with BYOD enrollment, you can distribute VPP apps and licenses:

- An important feature provided through the Managed Apple IDs is the deployment of apps and media via VPP
- For User Enrollment, FileWave will automatically register and associate VPP users for each associated VPP asset on demand (because the licenses can't be associated to the device)
- Configuration profiles, like email settings and VPN settings are supported (to ease customer setup)

But there are also restrictions to management:

- No access to device-identifying information (e.g. serial number, universal device identifier (UDID), IMEI, or mac addresses)
- No access to personal data
- No access to personal apps (no taking management or removing)
- Limited control capability (no remote wipe, no restrictions, device is not supervised so no profiles requiring supervision)
- Not all profiles are supported (profiles that restrict the user are largely not permitted, e.g strict passcode requirements, configurations that proxy network traffic, restrictions that block content)

## How

Once the devices are enrolled, associations for content are managed like you are used to, but there is one important (and helpful) change to the way FileWave is managing VPP license assignation. So please make sure and check out the article linked below on VPP License/Association Changes

<p class="callout success">You may be saying to yourself: "If I have to assign these licenses to the user, doesn't that mean I'll have to create VPP users in FileWave and invite them?" And the answer to that is thankfully, no. For User Enrollment, FileWave will automatically register and associate VPP users for each associated VPP asset on demand.</p>

# New Inventory Item -- Enrollment Type

## What

There are now several methods of enrolling devices into FileWave and a new inventory field has been created to record the enrollment method.

## When/Why

This field can be helpful when assigning content to devices. The field in question is called Enrollment Type as you'll see below:

![](https://kb.filewave.com/uploads/images/gallery/2023-07/hYyCGSAg5gQEmbQY-embedded-image-kojh1ipb.png)

## How

There is nothing special about access the item...you can do it in any query or smart group, but the following are the breakdown of the values for the field:

<table id="bkmrk-displaying-informati" style="width: 100%;"><tbody><tr style="background-color: rgb(251, 238, 184);"><td style="width: 19.4279%;">Displaying information

</td><td class="align-center" style="width: 9.17561%;">Number

</td><td style="width: 71.3965%;">Description

</td></tr><tr><td style="width: 19.4279%;">Enrollment via APK

</td><td class="align-center" style="width: 9.17561%;">0

</td><td style="width: 71.3965%;">Device was manually enrolled via installation of FileWave application

</td></tr><tr><td style="width: 19.4279%;">Enrollment via EMM\_API

</td><td class="align-center" style="width: 9.17561%;">1

</td><td style="width: 71.3965%;">Device was enrolled via the Android Management API (through NFC or a QRcode)

</td></tr><tr><td style="width: 19.4279%;">OTA Enrollment

</td><td class="align-center" style="width: 9.17561%;">2

</td><td style="width: 71.3965%;">Device was enrolled over-the-air

</td></tr><tr><td style="width: 19.4279%;">User Enrollment

</td><td class="align-center" style="width: 9.17561%;">3

</td><td style="width: 71.3965%;">Device was enrolled BYOD

</td></tr><tr><td style="width: 19.4279%;">DEP Enrollment

</td><td class="align-center" style="width: 9.17561%;">4

</td><td style="width: 71.3965%;">Device was enrolled via Apple DEP

</td></tr><tr><td style="width: 19.4279%;">Enrollment via fwcld

</td><td class="align-center" style="width: 9.17561%;">5

</td><td style="width: 71.3965%;">Device was enrolled via fwcld

</td></tr><tr><td style="width: 19.4279%;">Enrolled

</td><td class="align-center" style="width: 9.17561%;">6

</td><td style="width: 71.3965%;">Enrollment of Chromebook

</td></tr><tr><td style="width: 19.4279%;">User approved enrollment

</td><td class="align-center" style="width: 9.17561%;">7

</td><td style="width: 71.3965%;">Device was enrolled over-the-air and approved by user

</td></tr><tr><td style="width: 19.4279%;">Presumed DEP Enrollment

</td><td class="align-center" style="width: 9.17561%;">9

</td><td style="width: 71.3965%;">Device is supervised iOS client that was enrolled before v14.  
"Presumed DEP" because there is no absolute concrete criteria to determine if it is DEP or Apple Configurator.

</td></tr><tr><td style="width: 19.4279%;">Not available

</td><td class="align-center" style="width: 9.17561%;">8

</td><td style="width: 71.3965%;">Enrollment type is not determined

</td></tr></tbody></table>