Already a NinjaOne customer? Log in to view more guides and the latest updates.

NinjaOne Apple MDM: Policy Settings: Custom Payloads

Topic

This article explains how to define a specific configuration profile that NinjaOne will apply to devices assigned to the policy. NinjaOne deploys each custom payload as a separate Mobile Device Management (MDM) profile to the device.

Environment

  • NinjaOne Mobile Device Management (MDM)
  • Apple iOS and iPadOS

Description

Custom payloads allow NinjaOne to support all Apple MDM payloads, even if the UI does not reflect support. There may be a small delay in implementing new Apple functionalities, but we will expedite the appropriate solution.

To learn more about Apple configuration profiles and profile-specific payloads, refer to Apple's developer documents at TopLevel | Apple Developer Documentation (external link).

Index

Select a topic to continue:

Add a Custom Payload to a NinjaOne Policy

To create a custom payload, perform the following steps:

  1. Navigate to AdministrationPoliciesMDM Policies and select a policy to edit.
  2. In the Custom payload section of an Apple MDM policy, click Add payload.
  3. Give the payload an identifiable name. In the Content field, insert the payload properties into the colored code block.
custom payload.png
Figure 1: Add a custom payload in a NinjaOne Apple MDM policy
  1. Click Update.

You can edit or delete the payload by moving your mouse cursor over the row and clicking the action menu.

Required Keys

Use one or more valid dictionaries to define the payload content. You must manually enter the property list (p-list) file format text. You may also include optional keys; NinjaOne will deploy them as configured. NinjaOne does not validate optional keys, but will verify that they comply with the p-list-based structure.

Updating custom payloads

Optionally, you can add a payload identifier and a UUID. If you do not include one, NinjaOne will create a generic identifier (for example, "com.NinjaOne.Custom.[GUID]").

If you update a custom payload, do not change the payload identifier or payload UUID. This action results in an error, and you cannot save changes to the custom payload.

Additional Resources

FAQ

Next Steps