Files
apple_device-management/mdm/profiles/com.apple.security.certificatepreference.yaml
T
2025-09-15 20:38:03 -04:00

46 lines
1.6 KiB
YAML

title: Certificate Preference
description: The payload that configures a certificate preference.
payload:
payloadtype: com.apple.security.certificatepreference
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 a Certificate Preference item in the user's keychain that references
a certificate payload included in the same profile. Can only appear in a user
profile (not a device profile). See also "com.apple.security.identitypreference"
for setting up identity preferences.
payloadkeys:
- key: Name
type: <string>
presence: required
content: An email address (in RFC 822 format) or other name for which a preferred
certificate is requested.
- 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: |-
A `CertificatePreference` payload lets you identify a certificate preference item in the user's keychain that references a certificate payload included in the same profile. It can only appear in a user profile, not a device profile. You can include multiple `CertificatePreference` payloads as needed.
See also `IdentityPreference` for information about setting up identity preferences.