The payload that configures mobile device management (MDM) settings.
iOSmacOStvOS
macOS 10.7+iOS 4.0+
Configuration Keys (17)
Key
Type
Title
Description
Default
Range
ServerURLrequired
string
Server URL
The URL that the device contacts to retrieve device management instructions. The URL must begin with the 'https://' URL scheme, and may contain a port number
(':1234', for example).
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.
—
—
ServerURLPinningCertificateUUIDs
array
Server URL Pinning Certificate Identifiers
An array of strings, each containing the UUID of a certificate to use when evaluating trust to the '.../connect/' URLs of MDM servers.
—
—
ServerURLPinningCertificateUUIDsItemrequired
string
—
A certificate payload UUID.
—
—
ServerCapabilities
array
Server Capabilities
A unique array of strings indicating server capabilities:
- 'com.apple.mdm.per-user-connections': Indicates that the server supports both device and user connections. This must be present when managing Shared iPad or macOS devices.
- 'com.apple.mdm.bootstraptoken': Indicates that the server supports escrowing the Bootstrap Token. This must be present for the device to create a Bootstrap Token and send it to the server. Available as of macOS 11.0.
- 'com.apple.mdm.token': Indicates that the server supports the 'Get-Token' CheckIn message type. This must be present for the device to use 'Get-Token' CheckIn message when appropriate.
Note:
When updating the payload, the 'com.apple.mdm.per-user-connections' capability must not be added or removed. Any such change is an error, and the update is rejected.
—
—
ServerCapabilitiesItems
string
—
—
—
Topicrequired
string
Topic
The topic that MDM listens to for push notifications. The certificate that the server uses to send push notifications must have the same topic in its subject. The topic must begin with the 'com.apple.mgmt.' prefix.
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.
—
—
IdentityCertificateUUIDrequired
string
Identity Certificate UUID
The UUID of the certificate payload for the device's identity. It may also point to a SCEP payload.
—
—
ManagedAppleID
string
Managed Apple Account
The Managed Apple Account of the user. Previously required for profile-driven user enrollment.
Removed as of iOS 18 and macOS 15.
—
—
AccessRights
integer
Access Rights
Logical OR of the following bit flags:
- '1': Allow inspection of installed configuration profiles.
- '2': Allow installation and removal of configuration profiles.
- '4': Allow device lock and passcode removal.
- '8': Allow device erase.
- '16': Allow query of device information (device capacity, serial number).
- '32': Allow query of network information (phone/SIM numbers, MAC addresses).
- '64': Allow inspection of installed provisioning profiles.
- '128': Allow installation and removal of provisioning profiles.
- '256': Allow inspection of installed applications.
- '512': Allow restriction-related queries.
- '1024': Allow security-related queries.
- '2048': Allow manipulation of settings.
- '4096': Allow app management.
Don't set to '0'. Specify '1' if you specify '2'. Specify '64' if you specify '128'. Ignored if you set a value for 'ManagedAppleID'.
Note:
When updating the payload, the addition of any access right is an error, and the update is rejected.
—
—
CheckInURL
string
Check In URL
The URL that the device should use to check in during installation. The URL must begin with the 'https://' URL scheme and may contain a port number (':1234', for example). If not set, the system uses 'ServerURL'.
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.
—
—
CheckInURLPinningCertificateUUIDs
array
Check-In URL Pinning Certificate Identifiers
An array of strings, each containing the payload UUID of a certificate to use when evaluating trust to the '.../checkin/' URLs of MDM servers.
—
—
CheckInURLPinningCertificateUUIDsItemrequired
string
—
A certificate payload UUID.
—
—
CheckOutWhenRemoved
boolean
Check-Out When Removed
If 'true', the device attempts to send a 'Check-Out' message to the 'CheckInURL' when the profile is removed.
false
—
PinningRevocationCheckRequired
boolean
Pinning Revocation Check Required
If 'true', the system fails the connection attempt unless it obtains a verified positive response during certificate revocation checks.
If 'false', the system performs revocation checks on a best-attempt basis, where failure to reach the server isn't considered fatal.
false
—
PromptUserToAllowBootstrapTokenForAuthentication
boolean
Prompt User to Allow Bootstrap Token for Authentication
If 'true', the system warns the user that they need to reboot into RecoveryOS and allow the MDM to use the bootstrap token for authentication for certain sensitive operations such as enabling kernel extensions or installing some types of software updates. If the MDM doesn't need to perform these operations, it can leave this key set to 'false', and the user isn't notified.
The SettingsCommand.Command.Settings.MDMOptions.MDMOptions command overrides this default value.
This setting only applies to devices that have 'BootstrapTokenRequiredForSoftwareUpdate' or 'BootstrapTokenRequiredForKernelExtensionApproval' set to 'true' in their SecurityInfoResponse.SecurityInfo.
DEP-enrolled devices are automatically allowed to use the bootstrap token for authentication.
Available in macOS 11 and later.
false
—
SignMessage
boolean
Sign Message
If 'true', each message coming from the device carries the additional 'Mdm-Signature' HTTP header.
false
—
UseDevelopmentAPNS
boolean
Use Development APNS
If 'true', the device uses the development APNS servers. Otherwise, the device uses the production servers.
Set to 'false' if your Apple Push Notification Service certificate was issued by the Apple Push Certificate Portal ('https://identity.apple.com/pushcert'). That portal only issues certificates for the production push environment.
false
—
AssignedManagedAppleID
string
Assigned Managed Apple Account
The Managed Apple Account pre-assigned to the authenticated user. Required for account-driven enrollments. Available in iOS 15 and later, and macOS 14 and later.
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.
—
—
EnrollmentMode
string
Enrollment Mode
The enrollment mode the server indicates to use when enrolling. Required for account-driven enrollment. Available in iOS 15 and macOS 14, and later.
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.
—
RequiredAppIDForMDM
integer
Required App ID for MDM on Unsupervised Device
This property specifies an iTunes Store ID for an app the system can install with the InstallApplicationCommand, without any approval from the user. The MDM vendor or managing organization generally provides this app, which enhances the management experience for the user. The device shows the user details about this app in the account-driven enrollment process prior to installing the MDM profile. Use this property with account-driven MDM enrollments that normally require user approval for app installs through MDM.
Only account-driven enrollments support this property and other enrollment types ignore it.
Available in iOS 15.1 and later.
Note:
When updating the payload, the value of this key must not change. Any change is an error, and the update is rejected.