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

# Set up zero-touch deployment on your catalog

> Configure Apple Business Manager and Microsoft Entra so Primo enrolls ordered devices automatically with zero-touch deployment.

This article explains how to configure Apple Business Manager (ABM) or Microsoft Entra so Primo enrolls ordered devices automatically on delivery with zero-touch deployment (ZTD).

## Understand why ZTD depends on local keyboards

Zero-touch deployment relies on supplier accreditations that are region-dependent:

* **Mac devices** enroll through **Apple Business Manager (ABM)**
* **Windows devices** enroll through **Microsoft Autopilot**

Only suppliers accredited in a given region can provide these services, and they can only deliver devices with the local keyboard configuration of that region.

If you select a non-local keyboard, Primo routes the order to a different supplier that is not accredited for ZTD, so zero-touch deployment is unavailable.

## Configure Apple Business Manager for ZTD

To enroll Apple devices ordered through Primo automatically in zero-touch, authorize the reseller to enroll devices in your ABM.

<Steps>
  <Step title="Open shipping countries settings">
    Go to **Orders & Shipments > Settings > Shipping countries**.
  </Step>

  <Step title="Enable Zero Touch Apple for the country">
    Next to the relevant country, click **Zero Touch Apple > To Setup > Zero-Touch Deployment for Macs > Enable**.
  </Step>

  <Step title="Select or create an Organization ID">
    Select your existing **Organization ID** or create a new one. If you create one, use your company name followed by the ISO country code as the **Organization ID name** (for example, `Primo FR` when enabling zero-touch on the French catalog). Enter the ID shown in Apple Business Manager (**Devices > Inventory > Apple Customer Number**) as the **Organization ID**.
  </Step>

  <Step title="Add the Reseller ID in Apple Business Manager">
    Open [Apple Business Manager](https://business.apple.com/) and click **Devices > Inventory > Customer Number > Add > Reseller Number**. Enter the Reseller number shown in the Primo cockpit.
  </Step>

  <Step title="Confirm the setup">
    Back in the cockpit, check **"I've added these Reseller IDs in Apple Business Manager"** to confirm the action, then click **Confirm** to finalize.
  </Step>
</Steps>

## Configure Microsoft Entra for ZTD

### Step 1: Authorize the reseller to register future devices

<Steps>
  <Step title="Open order settings">
    Go to [**Settings → Orders**](https://app.getprimo.com/settings/).
  </Step>

  <Step title="Open the Windows zero-touch configuration">
    Under **Zero-Touch Procurement**, click **Windows**.
  </Step>

  <Step title="Select countries and authorize the reseller">
    Select the country or countries where you want to enable Autopilot procurement, then click **Authorize our reseller**.
  </Step>

  <Step title="Follow the displayed instructions">
    Complete the steps shown on screen.
  </Step>

  <Step title="Confirm the partner relationship">
    A confirmation screen indicates that the partner relationship is created.
  </Step>
</Steps>

### Step 2: Enter Microsoft Entra information

<Steps>
  <Step title="Open Microsoft Entra ID">
    Log in to the [Azure portal](https://portal.azure.com/) and search for **Microsoft Entra ID**.
  </Step>

  <Step title="Copy your tenant details">
    Copy your **Tenant ID** and **Primary Domain**, then paste them into the cockpit.
  </Step>

  <Step title="Activate the integration">
    Turn on the configuration toggle to finalize the integration.
  </Step>
</Steps>