Disk encryption guide: using the key (#25633)

Windows instructions (comment
[here](https://github.com/fleetdm/fleet/pull/25633#issuecomment-2682320481))
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.
This commit is contained in:
Noah Talerman
2025-02-26 14:01:04 -06:00
committed by GitHub
parent 7b7fa2fcd1
commit d690997f26
+30
View File
@@ -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.