Onboarding

Mac zero-touch with Apple Business Manager

Link a client's Apple Business Manager so new Macs set themselves up with the Enlist agent on first boot, before anyone signs in.

When a client buys Macs through Apple or an Apple reseller, they show up in the client's Apple Business Manager. Link it to Enlist and each new Mac sets itself up with the Enlist agent the first time it's turned on: Setup Assistant enrolls it, installs the agent, and carries on. Nobody runs an installer, and the agent can't be removed from the Mac.

What you need #

  • The Change settings permission in Enlist (owners and admins have it).

  • A company Apple ID for your MSP that stays with the business, not a person's own. It holds your Apple push certificate.

  • For each client, a sign-in to their Apple Business Manager with the Administrator or Device Enrollment Manager role.

  • Macs the client bought through Apple or a reseller that adds them to Apple Business Manager. A Mac bought elsewhere can be added with Apple Configurator on an iPhone.

Once for your MSP: the Apple push certificate #

Enlist uses it to wake your Macs. One certificate covers every client.

  1. In Enlist, open Settings → Apple device management and pick Make a push certificate request. Approve with your passkey, and the request downloads.

  2. Sign in at identity.apple.com/pushcert with your company Apple ID, pick Create a Certificate, accept the terms, upload the request and download the certificate (a .pem file).

  3. Back in Enlist, pick the .pem file, type the Apple ID you used, and pick Upload certificate.

The certificate lasts a year. Enlist warns you 30 days before it ends. To renew, make a renewal request in Enlist, then pick Renew next to the current certificate at identity.apple.com with the same Apple ID. A new certificate made from scratch has another topic, and every enrolled Mac would stop answering, so Enlist refuses it unless you tick Replace the topic.

  1. Open the client from Clients, then its settings. Under Apple Business Manager, pick Link Apple Business Manager, then Download Enlist's public key.

  2. In Apple Business Manager, open your name at the bottom left, then Preferences → Your MDM Servers → Add. Name it Enlist, upload the public key, and pick Save. Then pick Download Token.

  3. In Enlist, pick the token file (it ends in .p7m) and Upload token, then approve with your passkey. Enlist checks it with Apple before keeping it.

  4. In Apple Business Manager, open Preferences → MDM Server Assignment and pick Enlist as the default for Mac. Or assign Macs one by one under Devices.

  5. Choose the site new Macs enroll into, if the client has sites.

Enlist reads the client's Macs from Apple Business Manager every hour, and when you pick Read Macs now, and gives each one Enlist's enrollment profile. iPhones and iPads are left out.

What happens when a Mac is turned on #

  1. Setup Assistant shows Remote Management with your MSP's name. The user picks Enroll.

  2. Enlist checks that Apple signed the Mac's request and that Apple Business Manager assigned this Mac to the client, then enrolls it.

  3. Enlist sends the agent's settings (with a one-day enrollment token for the client), the Full Disk Access profile, and the agent. The agent enrolls into the client, and the blueprint's onboarding starts like on any other Mac.

  4. Setup Assistant carries on: the user makes their account and lands on the desktop with the agent already working.

The client's Apple Business Manager panel shows each Mac's stage: Ready: turn it on, Enrolling, Installing the agent, Set up, agent on its way and Agent installed, with each step and any error.

Change or remove #

Apple Business Manager's token lasts a year: download a new one for the Enlist server and pick Upload a new token. Forget link (after a passkey check) stops new Macs from enrolling; Macs already set up keep the agent. Remove the Enlist server in Apple Business Manager too. Removing the push certificate stops Enlist reaching enrolled Macs until you upload one with the same topic. Every change shows in Activity.

If something goes wrong #

"Apple Business Manager's terms and conditions changed"
Apple wants new terms accepted. Someone with the Administrator role signs in at business.apple.com and accepts them; Enlist tries again within the hour.
"Couldn't get the profile"
Apple Business Manager wouldn't give this Mac Enlist's profile, often because it's assigned to another device management server. Assign it to Enlist and pick Read Macs now.
A Mac skips Remote Management
It was set up before it was assigned to Enlist. Erase it (System Settings → General → Transfer or Reset → Erase All Content and Settings) and turn it on again, or install the agent by hand from Onboard a Mac.

Last updated 2026-11-17. Something wrong or missing? Email [email protected].