LegacyProfile

The declaration to configure a legacy profile.

Declaration

object LegacyProfile

Properties

Name Type Description

Name	Type	Description
`ProfileURL` Required	string	The URL of the profile to download and install, which needs to start with `https://`, and must be hosted by the MDM server. If a user enrollment triggers this configuration, the system silently ignores any MDMv1 payloads in macOS where the User Enrollment Mode setting is `forbidden`. In iOS, the system rejects the entire profile.

ProfileURL Required

string

The URL of the profile to download and install, which needs to start with https://, and must be hosted by the MDM server.

If a user enrollment triggers this configuration, the system silently ignores any MDMv1 payloads in macOS where the User Enrollment Mode setting is forbidden. In iOS, the system rejects the entire profile.

Discussion

Specify com.apple.configuration.legacy as the declaration type.

This declaration specifies an MDMv1 profile for the device to download and install.

The profile may contain any payload type other than the following:

com.apple.mdm
com.apple.declarations

Configuration availability


Allowed in supervised enrollment	iOS, macOS, Shared iPad, tvOS, visionOS, watchOS
Allowed in device enrollment	iOS, Shared iPad, tvOS, visionOS
Allowed in user enrollment	iOS, macOS, Shared iPad, visionOS
Allowed in local enrollment	iOS, macOS, Shared iPad, tvOS, visionOS, watchOS
Allowed in system scope	iOS, macOS, Shared iPad, tvOS, visionOS, watchOS
Allowed in user scope	macOS, Shared iPad

Configuration example

{
    "Type": "com.apple.configuration.legacy",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "ProfileURL": "https://www.example.com/profiles/passcode.mobileconfig"
    }
}