PayloadKit

Education Configuration

com.apple.education

The payload that configures the users, groups, and departments within an educational organization.

iOSmacOS
macOS 10.14+iOS 9.3+exclusive

Configuration Keys (12)

KeyTypeTitle
OrganizationNamerequired

The organization's display name. The system displays this name in the iOS login screen.

stringOrganization Name
OrganizationUUIDrequired

The organization's UUID identifier. This identifier can be any valid UUID. All teacher and student devices that need to communicate with one another must have the same organization UUID, particularly if they originated from different Device Enrollment Programs.

stringOrganization UUID
PayloadCertificateUUIDrequired

The UUID of an identity certificate payload within the same profile to use for performing client authentication with other devices. This property supports PKCS12 certificates. Required to configure Classroom. Has no effect on the configuration of the Shared iPad login screen.

stringPayload Certificate UUID
Groupsrequired

_For Shared iPad profiles:_ The array of dictionaries that defines which groups the user can select in the Login Window. _For leader/teacher profiles:_ The array of dictionaries that defines the groups that the user can control. _For member/student profiles:_ The array of dictionaries that defines the groups where the user is a member.

arrayGroups
Usersrequired

For Shared iPad profiles: The array of dictionaries that define the users that the system displays in the iOS Login Window. _For leader/teacher profiles:_ The array of dictionaries that define users that are members of the teacher's groups. _For member/student profiles:_ The array of dictionaries that needs to contain the definition of the user specified in the 'UserIdentifier' key. With one-to-one member devices, this key should include only the device user and the teacher but not other class members.

arrayUsers
LeaderPayloadCertificateAnchorUUID

The array of UUIDs referring to certificate payloads within the same profile that the system uses to authorize leader peer certificate identities. This array needs to contain all necessary certificates to validate the entire chain of trust. Leader certificates needs to have the common name prefix leader, which is case insensitive. This property doesn't support identity payloads or PKCS12 certificates. Required when configuring a student device for Classroom, and ignored when configuring an instructor device. Has no effect on the configuration of the Shared iPad login screen.

arrayLeader Payload Certificate Anchor UUIDs
MemberPayloadCertificateAnchorUUID

The array of UUIDs referring to certificate payloads within the same profile that the system uses to authorize group member peer certificate identities. This array must contain all certificates needed to validate the entire chain of trust. Member certificates must have the common name prefix member (case insensitive). This property doesn't support identity payloads or PKCS12 certificates. Required when configuring a student device for Classroom, and ignored when configuring an instructor device. Has no effect on the configuration of the Shared iPad login screen.

arrayMember Payload Certificate Anchor UUIDs
ResourcePayloadCertificateUUID

The UUID of an identity certificate payload within the same profile that the system uses to perform client authentication when fetching additional resources, such as student images. If set, the system uses this key to configure both Classroom and the Shared iPad login screen. If not set, the system uses MDM client identity.

stringResource Payload Certificate UUID
UserIdentifierrequired

The unique string that identifies the user of this device within the organization. Don't set this value in payloads intended to configure the Shared iPad login screen.

stringUser Identifier
Departments

_For Shared iPad profiles:_ The array of dictionaries that defines which departments the system displays in the Shared iPad login screen. If set, the system uses this key to configure both Classroom and the Shared iPad login screen.

arrayDepartments
DeviceGroups

_For leader/teacher profiles:_ The array of dictionaries that defines which device groups the leader can assign devices to. Not included in member payloads.

arrayDevice Groups
ScreenObservationPermissionModificationAllowed

If 'true', the system allows students enrolled in managed classes to modify their teacher's permissions for screen observation on their device.

Default: false

booleanAllow students to modify screen observation permissions
GroupsItem

An array of dictionaries defining groups.

dictGroupsDictionary
BeaconIDrequired

An unsigned 16 bit integer specifying this group's unique beacon ID.

integerBeacon ID
Namerequired

The display name of the group.

stringGroup Name
Description

The description of the group.

stringGroup Description
ImageURL

Deprecated in iOS 9.3.1 and later. The URL of an image for the group.

stringGroup Image URL
ConfigurationSource

The source that provided this group, such as SIS, or MDM.

stringConfiguration Source
LeaderIdentifiers

The user identifiers that are leaders of this group.

arrayLeader Identifiers
MemberIdentifiersrequired

The entries in the Users array that are members of the group.

arrayMember Identifiers
DeviceGroupIdentifiersrequired

The identifiers that refer to entries in the 'DeviceGroups' array to which the instructor can assign users from this class. Has no effect on the configuration of the Shared iPad login screen.

arrayDevice Group Identifiers
LeaderIdentifiersItemrequired

A user identifier.

stringLeader Identifier
MemberIdentifiersItemrequired

A member identifier.

stringMember Identifier
DeviceGroupIdentifiersItemrequired

A device group identifier.

stringDevice Group Identifier
UsersItem

A user in the organization.

dictUsersDictionary
Identifierrequired

The unique identifier for a user in the organization.

stringIdentifier
Namerequired

The name of the user.

stringName
GivenName

The given name of the user.

stringGiven Name
FamilyName

The family name of the user.

stringFamily Name
PhoneticGivenName

The user's phonetic given name. The system uses this name to sort users in the Classroom app and the Shared iPad Login Screen.

stringPhonetic Given Name
PhoneticFamilyName

The user's phonetic family name. The system uses this name to sort users in the Classroom app and the Shared iPad login screen.

stringPhonetic Family Name
ImageURL

A string that contains a URL pointing to an image of the user. The system displays this image in the iOS login screen and in the Classroom app. The recommended resolution is 256 x 256 pixels (512 x 512 pixels on a 2x device). The recommended formats are JPEG, PNG, and TIFF. The system uses the 'ResourcePayloadCertificateUUID' identity certificate or the MDM client identity to perform authentication when fetching the image.

stringImage URL
FullScreenImageURL

Deprecated in iOS 9.3.1 and later. The URL pointing to an image of the user. The system uses the 'ResourcePayloadCertificateUUID' identity certificate or the MDM client identity to perform authentication when fetching the specified resource.

stringFullscreen Image URL
AppleID

The Managed Apple Account for this user. Not required to configure Classroom, but if set the system uses it. Required to configure the Shared iPad login screen.

stringApple ID
PasscodeType

The type of passcode UI to show when the user is at the Login Window.

Range: complex, four, six

stringPasscode Type
LeaderPayloadCertificateAnchorUUIDItemrequired

A certificate payload UUID.

stringUUID
MemberPayloadCertificateAnchorUUIDItemrequired

A certificate payload UUID.

stringUUID
DepartmentsItem

A department in the organization.

dictDepartmentsDictionary
Namerequired

The display name of the department.

stringDepartment Name
GroupBeaconIDsrequired

The group beacon identifiers that are members of this department.

arrayGroup Beacon IDs
GroupBeaconIDsItemrequired

A group beacon identifier.

integerGroup Beacon ID
DeviceGroupsItem

A device group in the organization.

dictDeviceGroupsDictionary
Identifierrequired

The unique identifier for the device group in the organization.

stringDevice Group Identifier
Namerequired

The name of the device group, which must be unique in the organization.

stringDevice Group Name
SerialNumbersrequired

The serial numbers of the devices in the group.

arrayDevice Group Serial Numbers
SerialNumbersItemrequired

A serial number.

stringDevice Serial Number