Skip to content

Commit

Permalink
Add initial docs section for FileVault (#1082)
Browse files Browse the repository at this point in the history
* Add initial docs for FileVault Configuration

* Fix minor formatting

* Add minor improvements
  • Loading branch information
headmin authored Nov 22, 2024
1 parent c0694d9 commit 65f794e
Showing 1 changed file with 41 additions and 2 deletions.
43 changes: 41 additions & 2 deletions docs/apps/mdm.md
Original file line number Diff line number Diff line change
Expand Up @@ -193,8 +193,8 @@ These configurations are typically applied by assigning a dedicated blueprint du
4. Set an *Inventory Interval* to determine the frequency of inventory collection.
5. Configure data collection options:
- *Collect apps*: Select *Yes* or *No*.
- *Collect certificates**: Select *Yes* or *No*.
- *Collect profiles**: Select *Yes* or *No*.
- *Collect certificates*: Select *Yes* or *No*.
- *Collect profiles*: Select *Yes* or *No*.
6. Click *Save* to create the blueprint.

### Modify a Blueprint
Expand All @@ -211,6 +211,45 @@ These configurations are typically applied by assigning a dedicated blueprint du

For more details on configuring Automated Device Enrollment (ADE), refer to the [Setup an Enrollment Profile](#setup-an-enrollment-profile) section.

## FileVault Configuration

Zentral manages FileVault settings for full disk encryption on macOS devices via MDM. Using a dedicated configuration, it allows the creation and assignment of an individual FileVault configuration to one or more MDM Blueprints. This approach provides centralized control over FileVault application, user experience, and key management, ensuring compliance with the organization’s data encryption policies.

Enforcing FileVault during the Setup Assistant is supported starting from macOS 14.4 and later.

### FileVault Key Escrow

FileVault key escrow ensures that Personal Recovery Keys (PRKs) are securely stored and accessible:

- **Escrow**: Zentral automatically escrows the PRK when FileVault is enabled and enforced via MDM on a device. Zentral deploys a device-specific certificate to encrypt the PRK, ensuring a secure procedure.
- **Authorized Retrieval**: The PRK can be accessed via the Zentral web interface or HTTP API for device recovery. Each retrieval action is audited in the *FileVault PRK Viewed* log, captured per device and transaction.

### Configure FileVault Configuration

To set up a FileVault configuration in Zentral, follow these steps:

1. Navigate to *MDM > Overview > FileVault Configuration*.
2. Configure the following options:
- *Name*: Enter a display name for the configuration.
- *PRK Escrow Location Display Name*: Information shown to the end-user indicating where the PRK is stored.
- *Defer Enablement at Login Only*: Enable FileVault only during login to avoid prompts at logout.
- *Max Bypass Attempts at Login*: Set the number of times users can bypass FileVault enablement at login.
- *Show Recovery Key*: Choose whether to display the PRK to users when FileVault is enabled.
- *Destroy Key on Standby*: Enable this to require a FileVault unlock after hibernation.
- *PRK Rotation Interval (days)*: Specify an interval for automatic PRK rotation and escrow to Zentral. A value of 0 means no rotation.
3. Click *Save* to apply the configuration.

### Using FileVault Configuration Across Blueprints

A single FileVault configuration can be assigned to multiple blueprints, ensuring consistent encryption settings across various device groups.

### Linking a FileVault Configuration to a Blueprint

1. Navigate to *MDM > Overview > Blueprints*.
2. Select or create a blueprint.
3. Choose the desired FileVault configuration from the *FileVault Configuration* dropdown.
4. Click *Save* to link the configuration to the blueprint.

## Apps and Books

To manage and distribute apps from the Mac App Store or iOS/iPadOS App Store through Zentral, a Content Token is required to sync with Apple Business Manager (ABM) or Apple School Manager (ASM).
Expand Down

0 comments on commit 65f794e

Please sign in to comment.