PayloadKit

FDE FileVault

com.apple.MCX.FileVault2

The payload that configures FileVault.

macOS 10.9+
Apple schemaundefined

Not available with User Enrollment · Only one instance per profile · macOS: device channel only

Configuration Keys (14)

Showing 14 of 14 keys

KeyTypeDescriptionDefaultRange
Enablestring

Enable FileVault 2

required
stringSet to 'On' to enable FileVault and set to 'Off' to disable FileVault. Payloads set to 'On' sent through MDM need to either include full authentication information in the payload or have the 'Defer' option set to 'true'. When 'Defer' is 'true', the system prompts for the authentication information when the user enables FileVault.Default: —Range: On, Off
Deferboolean

Defer enabling until logout

booleanIf 'true', the system defers enabling FileVault until the designated user logs out. For details, see 'fdesetup(8)'. Only a local user or a mobile account user can enable FileVault.Default: falseRange: —

User enters username and password

booleanIf 'true', the system enables a prompt for missing user name or password fields.Default: falseRange: —

Create a personal recovery key

booleanIf 'true', the system creates a personal recovery key and displays it to the user.Default: trueRange: —

Show the personal recovery key

booleanIf 'false', the system prevents display of the personal recovery key to the user after the system enables FileVault.Default: trueRange: —

Recovery key path

stringThe path to the location of the recovery key and computer information property list.Default: —Range: —

Certificate

dataThe DER-encoded certificate data if the system creates an institutional recovery key. This key isn't supported on a Mac with Apple silicon.Default: —Range: —

Recovery Key Certificate Payload

stringThe UUID of the payload within the same profile containing the asymmetric recovery key certificate payload.Default: —Range: —
Usernamestring

Username

stringThe user name of the Open Directory user to add to FileVault.Default: —Range: —
Passwordstring

Password

stringThe password of the Open Directory user to add to FileVault. Use the 'UserEntersMissingInfo' key to prompt for this information.Default: —Range: —

Add institutional recovery key to keychain

booleanIf 'true' and you don't include certificate information in this payload, the system uses the keychain created at '/Library/Keychains/FileVaultMaster.keychain' when it adds the institutional recovery key.Default: falseRange: —

Maximum number of times FileVault can be skipped

integerThe maximum number of times users can bypass enabling FileVault before the system requires the user to enable it to log in. If the value is '0', the system requires the user to enable FileVault the next time they attempt to log in. Set this key to '-1' to disable this feature.Default: —Range: -1 – 9999

Dont ask at logout

macOS 10.10+

booleanIf 'true', the system prevents requests to enable FileVault at user logout time.Default: falseRange: —

macOS 14.0+

booleanIf 'true', and installation of this payload occurs after enrolling with MDM in Setup Assistant, the system requests Setup Assistant to enable FileVault at setup time. To use this, enable the Await Device Configured ADE configuration option and send this profile with this key set, before sending the 'DeviceConfiguredCommand'. An admin SecureToken user is required, otherwise the FileVault pane doesn't appear.Default: falseRange: —