Setting up automatic authentication for macOS devices

You can create and assign an SSO extension profile to allow macOS devices to authenticate automatically with hosts, domains, and web services on your organization's network. An SSO extension profile configured for Platform SSO is an advanced option for macOS devices: the device prompts the user to register with your identity provider, then signs them in after that.

SSO extension profiles are supported for iOS and macOS devices. This example focuses on macOS only with a Platform SSO configuration.

  1. On the menu bar, click Policies and profiles > Networks and connections > Single sign-on extension.
    Screenshot of the menu path to the SSO extension profile.
  2. Click Add icon..
    Screenshot of the Add icon for a single sign-on extension profile.
  3. Type a name and description for the profile, then select macOS as the device type for the profile.
    Screenshot of the name, description, and macOS device type for the profile.
  4. Set Single sign-on extension type to Platform SSO.
    Screenshot of Platform SSO selected on the macOS tab.
  5. Fill in the extension details for your identity provider.

    Configure the options for your identity provider:

    • Extension identifier: The bundle identifier of the app extension that performs SSO.
    • Team identifier: The Apple Developer team identifier of the SSO extension.
    • URLs: The URL prefix for the identity provider. Add multiple URLs as needed.
    • Screen locked behavior: How the device handles authentication requests when the screen is locked.
    • Extension data: The custom payload for the app extension. Click Payload format to see a sample.
    • Denied bundle identifiers: Add a bundle identifier for each app you want to exempt from the configuration.
    Screenshot of the extension identifier, URLs, and payload fields.
  6. Choose an authentication method and set the account options you need.

    For example, select OpenID (macOS 27 and later), add a registration token and an account display name, and set how often users must sign in again. You can also choose how new user accounts are created and which policy rules to turn on.

    Screenshot of the Platform SSO authentication and account options.
  7. Click Save.
    Screenshot of the Save button.
  8. Assign the profile to users or groups.

    Assign only one Platform SSO profile to a macOS device at a time. If a macOS device receives Platform SSO configurations from more than one profile, it reports an invalid configuration error to UEM and does not apply the profiles.

    Screenshot of assigning the single sign-on extension profile.
  9. That's it!

    You have successfully set up automatic authentication for macOS devices.

    Screenshot of the completed SSO extension profile.
For more information about SSO extension profiles, see Setting up automatic authentication for iOS and macOS devices.