Skip to content

Commit

Permalink
Disk encryption guide: using the key (#25633)
Browse files Browse the repository at this point in the history
Windows instructions (comment
[here](#25633 (comment)))
will be in a separate PR because they still need to be tested. Let's
merge this PR before opening the separate PR for Windows.
  • Loading branch information
noahtalerman authored Feb 26, 2025
1 parent 7b7fa2f commit d690997
Showing 1 changed file with 30 additions and 0 deletions.
30 changes: 30 additions & 0 deletions articles/enforce-disk-encryption.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,36 @@ How to view the disk encryption key:

> The disk encryption key is deleted if a host is transferred to a team with disk encryption turned off. To re-escrow they key, transfer the host back to a team with disk encryption on.
## Use disk encryption key to login

Disk encryption keys are used to login to workstations (hosts) when the end user forgets their password or when the host is returned to the organization after an end user leaves.

### macOS

1. With the macOS host in front of you, restart the host and select the end user's account.

2. Select the question mark icon **(?)** next to the password field and select **Restart and show password reset options**. If you don't see the **(?)** icon, try entering any incorrect password several times.

3. Follow the instructions on the Mac to enter the disk encryption (recovery) key.

### Linux

1. With the Linux host in front of you, restart it.

2. When prompted to unlock the disk, enter the disk encryption key.

3. On the **Host details** page in Fleet, find the local user's username in the **Users** table.

4. Next, add the following script to Fleet (deletes the local password (passphrase)):

```
passwd -d <username>
```

5. Head back to the **Host details** page and select **Actions > Run script** to run the script.

####

## Migrate macOS hosts

When migrating macOS hosts from another MDM solution, in order to complete the process of encrypting the hard drive and escrowing the key in Fleet, your end users must log out or restart their Mac.
Expand Down

0 comments on commit d690997

Please sign in to comment.