Skip to main content

Apple Business Manager

JupiterOne's integration with Apple Business Manager collects data about MDM servers and managed devices, providing visibility into your organization's Apple device management infrastructure.

Installation​

For this integration, you will need an Apple Business Manager account with administrative access and API access enabled. This integration uses JWT-based OAuth authentication with the Apple Business Manager API.

info

You will need to generate a server token and obtain the required credentials from Apple Business Manager. See the Apple Business Manager API documentation for more information.

Obtaining API Credentials​

  1. Log in to Apple Business Manager
  2. Navigate to Settings > Preferences
  3. Under Server Tokens, create a new token with the required permissions
  4. Download the private key (.pem file)
  5. Note the following values:
    • Client ID: Your organization's Apple Business Manager Client ID
    • Key ID: The identifier for the private key
    • Private Key: The content of the downloaded .pem file

The server token you create must have sufficient permissions to access:

  • MDM server configurations
  • Device inventory

Configuration in JupiterOne​

To install the Apple Business Manager integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Apple Business Manager. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Apple Business Manager account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Client ID: Your Apple Business Manager Client ID

  • Key ID: The Key ID associated with your private key

  • Private Key: Upload the .pem file you downloaded from Apple Business Manager

Click Create once all values are provided to finalize the integration.

note

If the integration runs successfully but no entities are collected, verify that your organization has MDM servers configured in Apple Business Manager and that devices are assigned to your organization.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.