Microsoft Intune
Device enrollment

Guide Macos

In brief

The guide states that support for Setup Assistant (legacy) authentication with ADE user affinity ended in the October 2026 (2610) service release. Existing legacy profiles are automatically updated to modern authentication. It also clarifies that Company Portal isn't supported for enrollments without user affinity.

What Intune admins need to know

Review enrollment behavior and user communications: user-affinity enrollments use modern authentication, with Company Portal sign-in after enrollment to complete Microsoft Entra registration. No administrator migration is specified because existing profiles update automatically.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

  • You need access to the Apple Business portal, or the Apple School Manager (ASM) portal.

  • Be sure the Apple token (.p7m) is active. For more specific information, go to Set up a macOS ADE token.

  • Be sure the Apple MDM push certificate is added to Intune, and is active. This certificate is required to enroll macOS devices. For more information, go to Get an Apple MDM push certificate.

  • Decide how you want users to authenticate on their devices:For ADE with user affinity, use Setup Assistant with modern authentication (recommended),. Users sign in to the Company Portal app, or Setup Assistant (legacy) (not recommended). Make this decision before you create theapp after enrollment policy. Using the Setup Assistant with modern authentication is considered modern authentication.to complete Microsoft recommends using Setup Assistant with modern authentication.

    For all organization-owned macOS devices, Setup Assistant (legacy) is always and automatically used, even if you don't see "Setup Assistant" text in Intune. Setup Assistant (legacy) authenticates the user, and enrolls the device.Entra registration.

    • Select the Setup Assistant with modern authentication when:

      After the Setup Assistant completes, users can use the device. When the home screen shows, the enrollment is complete, and user affinity is established. The device isn't fully registered with Microsoft Entra ID, and doesn't show in a user's device list in Microsoft Entra ID.

      If users need access to resources protected by Conditional Access or should be fully registered with Microsoft Entra ID, then install the Company Portal app. After it's installed, users open the Company Portal app, and sign in with their organization Microsoft Entra account ([email protected]). During this second login, any Conditional Access policies are evaluated, and Microsoft Entra registration is complete. Users can install and use organizational resources, including LOB apps.

    • Select the Setup Assistant (legacy) when you can't use Setup Assistant with modern authentication and:

      • You want to wipe the device.

      • You don't want to use modern authentication features, such as MFA.

      • You don't want to register devices in Microsoft Entra ID. Setup Assistant (legacy) authenticates the user with the Apple .p7m token. If it's acceptable to not register devices in Microsoft Entra ID, then you don't need to install the Company Portal app. Keep using the Setup Assistant (legacy).

        If you want to use the Company Portal app for authentication instead of using Setup Assistant, or want the devices registered in Microsoft Entra ID, then:

        1. To install the Company Portal app on devices, go to add the Company Portal app. Set the Company Portal app as a required app.
        2. After the device is enrolled, install the Company Portal app.
        3. Once installed, users open the Company Portal app, and sign in with their organization Microsoft Entra account ([email protected]). When they sign in, they're authenticated, and ready to receive your policies.
  • In the Microsoft Intune admin center, go to Apple ConfiguratorDevices enrollment> Enrollment > macOS > Enrollment program tokens, select a token, and create an enrollment policy. Choose to Enroll with user affinity (associate a user to the device), or Enroll without user affinity (user-less devices or shared devices).

    • Enroll with user affinity: Setup Assistant authenticates the user, and enrolls the device in Intune. Also choose if users can delete the management profile, called Locked enrollment.
    • Enroll without user affinity: Setup Assistant authenticates the user, and enrolls the userdevice in Intune.Intune without associating it with a user. Also choose if users can delete the management profile, called Locked enrollment. The Company Portal app isn't used, needed, or supported on enrollments without user affinity.

Important

Intune has ended support for Setup Assistant (legacy) authentication for ADE with user affinity with the October 2026 (2610) service release. Existing profiles that use legacy authentication are automatically updated to Setup Assistant with modern authentication. Already-enrolled devices aren't affected and remain enrolled. For details, see Retirement of Setup Assistant (legacy).

ADE end user tasks

For more specific information on the end user steps, go to Enroll your macOS device using the Company Portal app.

  • Enroll with user affinity + Setup Assistant (legacy):

    1. When the device is turned on, the Apple Setup Assistant runs. Users enter their Apple ID ([email protected] or [email protected]).

    2. The Setup Assistant prompts the user for information, and enrolls the device in Intune. The device isn't registered in Microsoft Entra ID.

      If you're using Setup Assistant for authentication, then stop here.

    3. Optional. If you're using the Company Portal app for authentication (instead of Setup Assistant), then the Company Portal app installs using the option you configured.

      Users open the Company Portal app, and sign in with their organization credentials ([email protected]). After they sign in, users are authenticated, and can access organization resources.

      Remember, installing the Company Portal app is optional. If you want your users to authenticate using Company Portal app, instead of using the Setup Assistant, then add the Company Portal app.

  • Enroll with user affinity + Setup Assistant with modern authentication:

    1. When the device is turned on, the Apple Setup Assistant runs. Users enter their Apple ID ([email protected] or [email protected]) and their organization Microsoft Entra credentials ([email protected]).
Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…