Education Configuration
com.apple.education
The payload that configures the users, groups, and departments within an educational organization.
Configuration Keys (12)
| Key | Type | Title |
|---|---|---|
OrganizationNamerequiredThe organization's display name. The system displays this name in the iOS login screen. | string | Organization Name |
OrganizationUUIDrequiredThe 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. | string | Organization UUID |
PayloadCertificateUUIDrequiredThe 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. | string | Payload 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. | array | Groups |
UsersrequiredFor 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. | array | Users |
LeaderPayloadCertificateAnchorUUIDThe 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. | array | Leader Payload Certificate Anchor UUIDs |
MemberPayloadCertificateAnchorUUIDThe 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. | array | Member Payload Certificate Anchor UUIDs |
ResourcePayloadCertificateUUIDThe 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. | string | Resource Payload Certificate UUID |
UserIdentifierrequiredThe 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. | string | User 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. | array | Departments |
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. | array | Device Groups |
ScreenObservationPermissionModificationAllowedIf 'true', the system allows students enrolled in managed classes to modify their teacher's permissions for screen observation on their device. Default: false | boolean | Allow students to modify screen observation permissions |
GroupsItemAn array of dictionaries defining groups. | dict | GroupsDictionary |
BeaconIDrequiredAn unsigned 16 bit integer specifying this group's unique beacon ID. | integer | Beacon ID |
NamerequiredThe display name of the group. | string | Group Name |
DescriptionThe description of the group. | string | Group Description |
ImageURLDeprecated in iOS 9.3.1 and later. The URL of an image for the group. | string | Group Image URL |
ConfigurationSourceThe source that provided this group, such as SIS, or MDM. | string | Configuration Source |
LeaderIdentifiersThe user identifiers that are leaders of this group. | array | Leader Identifiers |
MemberIdentifiersrequiredThe entries in the Users array that are members of the group. | array | Member Identifiers |
DeviceGroupIdentifiersrequiredThe 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. | array | Device Group Identifiers |
LeaderIdentifiersItemrequiredA user identifier. | string | Leader Identifier |
MemberIdentifiersItemrequiredA member identifier. | string | Member Identifier |
DeviceGroupIdentifiersItemrequiredA device group identifier. | string | Device Group Identifier |
UsersItemA user in the organization. | dict | UsersDictionary |
IdentifierrequiredThe unique identifier for a user in the organization. | string | Identifier |
NamerequiredThe name of the user. | string | Name |
GivenNameThe given name of the user. | string | Given Name |
FamilyNameThe family name of the user. | string | Family Name |
PhoneticGivenNameThe user's phonetic given name. The system uses this name to sort users in the Classroom app and the Shared iPad Login Screen. | string | Phonetic Given Name |
PhoneticFamilyNameThe user's phonetic family name. The system uses this name to sort users in the Classroom app and the Shared iPad login screen. | string | Phonetic Family Name |
ImageURLA 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. | string | Image URL |
FullScreenImageURLDeprecated 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. | string | Fullscreen Image URL |
AppleIDThe 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. | string | Apple ID |
PasscodeTypeThe type of passcode UI to show when the user is at the Login Window. Range: complex, four, six | string | Passcode Type |
LeaderPayloadCertificateAnchorUUIDItemrequiredA certificate payload UUID. | string | UUID |
MemberPayloadCertificateAnchorUUIDItemrequiredA certificate payload UUID. | string | UUID |
DepartmentsItemA department in the organization. | dict | DepartmentsDictionary |
NamerequiredThe display name of the department. | string | Department Name |
GroupBeaconIDsrequiredThe group beacon identifiers that are members of this department. | array | Group Beacon IDs |
GroupBeaconIDsItemrequiredA group beacon identifier. | integer | Group Beacon ID |
DeviceGroupsItemA device group in the organization. | dict | DeviceGroupsDictionary |
IdentifierrequiredThe unique identifier for the device group in the organization. | string | Device Group Identifier |
NamerequiredThe name of the device group, which must be unique in the organization. | string | Device Group Name |
SerialNumbersrequiredThe serial numbers of the devices in the group. | array | Device Group Serial Numbers |
SerialNumbersItemrequiredA serial number. | string | Device Serial Number |