8ee92f5194
- Implement NV index mode for TPM 2.0 key protector 0001-protectors-Implement-NV-index.patch - Fall back to passphrase mode when the key protector fails to unlock the disk 0002-cryptodisk-Fallback-to-passphrase.patch - Wipe out the cached key cleanly 0003-cryptodisk-wipe-out-the-cached-keys-from-protectors.patch - Make diskfiler to look up cryptodisk devices first 0004-diskfilter-look-up-cryptodisk-devices-first.patch - Version bump to 2.12~rc1 * Added: - grub-2.12~rc1.tar.xz * Removed: - grub-2.06.tar.xz * Patch dropped merged by new version: - grub2-GRUB_CMDLINE_LINUX_RECOVERY-for-recovery-mode.patch - grub2-s390x-02-kexec-module-added-to-emu.patch - grub2-efi-chainloader-root.patch - grub2-Fix-incorrect-netmask-on-ppc64.patch - 0001-osdep-Introduce-include-grub-osdep-major.h-and-use-i.patch - 0002-osdep-linux-hostdisk-Use-stat-instead-of-udevadm-for.patch - 0002-net-read-bracketed-ipv6-addrs-and-port-numbers.patch - grub2-s390x-10-keep-network-at-kexec.patch - 0001-Fix-build-error-in-binutils-2.36.patch - 0001-emu-fix-executable-stack-marking.patch - 0046-squash-verifiers-Move-verifiers-API-to-kernel-image.patch - 0001-30_uefi-firmware-fix-printf-format-with-null-byte.patch - 0001-tpm-Pass-unknown-error-as-non-fatal-but-debug-print-.patch - 0001-Filter-out-POSIX-locale-for-translation.patch OBS-URL: https://build.opensuse.org/request/show/1105405 OBS-URL: https://build.opensuse.org/package/show/Base:System/grub2?expand=0&rev=458
60 lines
2.3 KiB
Diff
60 lines
2.3 KiB
Diff
From f7b9580133cf346d77f345d175fa5cb8a591be16 Mon Sep 17 00:00:00 2001
|
|
From: Daniel Axtens <dja@axtens.net>
|
|
Date: Sat, 15 Aug 2020 02:00:57 +1000
|
|
Subject: [PATCH 05/23] docs/grub: Document signing grub under UEFI
|
|
|
|
Before adding information about how grub is signed with an appended
|
|
signature scheme, it's worth adding some information about how it
|
|
can currently be signed for UEFI.
|
|
|
|
Signed-off-by: Daniel Axtens <dja@axtens.net>
|
|
---
|
|
docs/grub.texi | 22 +++++++++++++++++++++-
|
|
1 file changed, 21 insertions(+), 1 deletion(-)
|
|
|
|
--- a/docs/grub.texi
|
|
+++ b/docs/grub.texi
|
|
@@ -6345,6 +6345,7 @@
|
|
* Secure Boot Advanced Targeting:: Embedded information for generation number based revocation
|
|
* Measured Boot:: Measuring boot components
|
|
* Lockdown:: Lockdown when booting on a secure setup
|
|
+* Signing GRUB itself:: Ensuring the integrity of the GRUB core image
|
|
@end menu
|
|
|
|
@node Authentication and authorisation
|
|
@@ -6423,7 +6424,7 @@
|
|
|
|
GRUB's @file{core.img} can optionally provide enforcement that all files
|
|
subsequently read from disk are covered by a valid digital signature.
|
|
-This document does @strong{not} cover how to ensure that your
|
|
+This section does @strong{not} cover how to ensure that your
|
|
platform's firmware (e.g., Coreboot) validates @file{core.img}.
|
|
|
|
If environment variable @code{check_signatures}
|
|
@@ -6586,6 +6587,25 @@
|
|
The @samp{lockdown} variable is set to @samp{y} when the GRUB is locked down.
|
|
Otherwise it does not exit.
|
|
|
|
+@node Signing GRUB itself
|
|
+@section Signing GRUB itself
|
|
+
|
|
+To ensure a complete secure-boot chain, there must be a way for the code that
|
|
+loads GRUB to verify the integrity of the core image.
|
|
+
|
|
+This is ultimately platform-specific and individual platforms can define their
|
|
+own mechanisms. However, there are general-purpose mechanisms that can be used
|
|
+with GRUB.
|
|
+
|
|
+@section Signing GRUB for UEFI secure boot
|
|
+
|
|
+On UEFI platforms, @file{core.img} is a PE binary. Therefore, it can be signed
|
|
+with a tool such as @command{pesign} or @command{sbsign}. Refer to the
|
|
+suggestions in @pxref{UEFI secure boot and shim} to ensure that the final
|
|
+image works under UEFI secure boot and can maintain the secure-boot chain. It
|
|
+will also be necessary to enrol the public key used into a relevant firmware
|
|
+key database.
|
|
+
|
|
@node Platform limitations
|
|
@chapter Platform limitations
|
|
|