Full UEFI secure boot on Fedora using signed initrd and systemd-boot
Also posted on Medium
Update april 2024: Work on UKI is progressing in Fedora and with Fedora 40 for many use cases you can now use UKI to get signed images containing kernel and initrd in one. See https://fedoraproject.org/wiki/Changes/Unified_Kernel_Support_Phase_2 for more information.
Although secure boot support has been in place in most distros for a while, most, if not all, still have a missing part in the chain, namely the missing signing of the initrd image. This allows an attacker to tamper with the initrd image without detection. Lennart Pottering wrote a very good blog post about the issue and outlined a solution that can be implemented.
Until measures as outlined there or similar are implemented in the distros, there a couple of solutions ready to set up now. They do however require a little work from the end user.
Option one is to encrypt the boot partition. This works, however you need to use grub and grub still only supports luks version 1. Also you need to decrypt the boot partition using a password or passphrase, as this is the only method grub supports, not other methods such as fido2 or tpm, which is supported by systemd-cryptenroll.
The second option is the one I’m going to describe, that is to sign and verify the initrd image. That way, it does not matter that the boot partition is unencrypted, as there is no secrets in the initrd image, and any tampering will break the signature and the boot process.
In order to sign and validate the initrd image, you will first need to set up and install your own secure boot signing key. To ease setup and use, we use sbctl. First install required packages (if you don’t want to install asciidoc and go on your system, you can use toolbox)
sudo dnf install asciidoc golang systemd-boot-unsigned
Download the sbctl release file, unpack and install (change version as needed)
VERSION=0.9
cd /tmp
curl -L "https://github.com/Foxboron/sbctl/releases/download/${VERSION}/sbctl-${VERSION}.tar.gz" | tar zxvf -
cd "sbctl-${VERSION}"
make
sudo make install
and generate the key by running
sudo sbctl create-keys
If your computer supports it, you can install the key by running
sudo sbctl enroll-keys
If successfull, reboot. If this fails, you will need to manually install the key. This can vary from system to system, but in most cases the following will work
sudo openssl x509 -in /usr/share/secureboot/keys/db/db.pem -outform DER -out /boot/efi/EFI/fedora/DB.cer
- Reboot into BIOS. There will usually be an option under secure boot to add your own key to the DB database from file, where you can browse the EFI partition and find the
DB.cer
file inEFI/fedora
After adding the key, sudo sbctl status
should now a checkmark for installed and secure boot, similar to
Installed: ✔ Sbctl is installed
Owner GUID: a9fbbdb7-a05f-48d5-b63a-08c5df45ee70
Setup Mode: ✔ Disabled
Secure Boot: ✔ Enabled
The next step is setting up systemd-boot and automatic signing of the initrd on kernel upgrades. First we need to change the efi mount from /boot/efi
to /efi
sudo umount /boot/efi
sudo mkdir /efi
sudo sed -i `s-/boot/efi-/efi-' /etc/fstab
sudo mount /efi
sudo ln -s /efi /boot/efi
The last command is because some packages such as fwupd expects to find the efi mount at /boot/efi
Setup systemd-boot and sign it by running
sudo bootctl install
sudo sbctl sign /efi/EFI/systemd/systemd-bootx64.efi
You might want to edit /efi/loader/loader.conf
and add timeout 3
or similar, in order to get a prompt to choose images when booting.
To make sure systemd-boot keeps being signed on updates, we will need the sbsigntools
package installed
sudo dnf install sbsigntools
Then run sudo systemctl edit systemd-boot-update.service
and add the following
[Service]
ExecStart=/bin/sh -c 'sbverify --cert /usr/share/secureboot/keys/db/db.pem /efi/EFI/systemd/systemd-bootx64.efi || sbctl sign /efi/EFI/systemd/systemd-bootx64.efi'
Next, we add dracut configuration for creating a combined and signed file containing efi stub loader, kernel and initrd. Edit /etc/dracut.conf.d/local.conf
and add
uefi=yes
uefi_secureboot_cert=/usr/share/secureboot/keys/db/db.pem
uefi_secureboot_key=/usr/share/secureboot/keys/db/db.key
dracut_rescue_image=no
The reason we disable the rescue image, is that this is very big and will most likely fill your EFI partition.
The last piece is to add a kernel install script to change the systemd-boot entry to load only the combined image. Edit /etc/kernel/install.d/99-use-signed-image.install
with the content
#!/bin/bash
COMMAND="$1"
KERNEL_VERSION="$2"
ENTRY_DIR_ABS="$3"
if ! [[ $COMMAND == add ]]; then
exit 1
fi
MACHINE_ID="$KERNEL_INSTALL_MACHINE_ID"
BOOT_ROOT="$KERNEL_INSTALL_BOOT_ROOT"
if [[ -f /etc/kernel/tries ]]; then
read -r TRIES </etc/kernel/tries
if ! [[ "$TRIES" =~ ^[0-9]+$ ]] ; then
echo "/etc/kernel/tries does not contain an integer." >&2
exit 1
fi
LOADER_ENTRY="$BOOT_ROOT/loader/entries/$MACHINE_ID-$KERNEL_VERSION+$TRIES.conf"
else
LOADER_ENTRY="$BOOT_ROOT/loader/entries/$MACHINE_ID-$KERNEL_VERSION.conf"
fi
<pre class="wp-block-preformatted">sed -i "/^initrd/d" "${LOADER_ENTRY}"
sed -i "/^linux/s/linux$/initrd/" "${LOADER_ENTRY}"
Make the script executable by running sudo chmod 755 /etc/kernel/install.d/99-use-signed-image.install
Everything should now be up and running, the last thing to do is re-run kernel install for the current kernel in order to get a new updated and signd initrd image by running
sudo /bin/kernel-install -v add $(uname -r) /lib/modules/$(uname -r)/vmlinuz
Reboot and you should have a boot that is signed all the way. Run sudo bootctl status
to verify. Current Boot Loader should say systemd-boot and under Default Boot Loader Entry the linux line should point to initrd (this is the combined and signed initrd).
You can now remove the grub boot entry, so that there is no way to boot using the unsigned initrd image. Run sudo efibootmgr -v
to list current boot entries. Then run
sudo efibootmgr -B -b XX
where XX
is the number, for instance 0003
Finally, edit /etc/fwupd/uefi_capsule.conf
and set EnableGrubChainLoad=false