Files
apple_device-management/mdm/profiles/com.apple.security.identitypreference.yaml
Cyrus Daboo 97a11a861f Seed2
2026-06-22 15:55:19 -04:00

52 lines
1.7 KiB
YAML

title: Identity Preference
description: The payload that configures the user's identity on the device.
payload:
payloadtype: com.apple.security.identitypreference
supportedOS:
iOS:
introduced: n/a
macOS:
introduced: '10.12'
multiple: true
devicechannel: false
userchannel: true
supervised: false
requiresdep: false
userapprovedmdm: false
allowmanualinstall: true
userenrollment:
mode: allowed
tvOS:
introduced: n/a
visionOS:
introduced: n/a
watchOS:
introduced: n/a
content: Defines an Identity Preference item in the user's keychain that references
a identity payload included in the same profile. Can only appear in a user profile
(not a device profile). See also "com.apple.security.certificatepreference" for
setting up certificate preferences.
payloadkeys:
- key: Name
type: <string>
presence: required
content: The email address (in RFC 822 format), DNS host name, or other name that
uniquely identifies a service requiring this identity.
- key: PayloadCertificateUUID
type: <string>
presence: required
content: The UUID of the certificate payload within the same profile to use for
the identity credential.
notes:
- title: ''
content: |-
This payload specifies an `IdentityPreference` item in the user's keychain that references an identity payload included in the same profile. It can only appear in a user profile, not in a device profile.
You can include multiple `IdentityPreference` payloads as needed.
See also `CertificatePreference` for setting up certificate preferences.
examples:
- title: Profile example
files:
- file: examples/mdm/profiles/com.apple.security.identitypreference/example1.plist