mirror of
https://git.proxmox.com/git/grub2
synced 2025-07-21 22:18:08 +00:00

When the GRUB starts on a secure boot platform, some commands can be used to subvert the protections provided by the verification mechanism and could lead to booting untrusted system. To prevent that situation, allow GRUB to be locked down. That way the code may check if GRUB has been locked down and further restrict the commands that are registered or what subset of their functionality could be used. The lockdown support adds the following components: * The grub_lockdown() function which can be used to lockdown GRUB if, e.g., UEFI Secure Boot is enabled. * The grub_is_lockdown() function which can be used to check if the GRUB was locked down. * A verifier that flags OS kernels, the GRUB modules, Device Trees and ACPI tables as GRUB_VERIFY_FLAGS_DEFER_AUTH to defer verification to other verifiers. These files are only successfully verified if another registered verifier returns success. Otherwise, the whole verification process fails. For example, PE/COFF binaries verification can be done by the shim_lock verifier which validates the signatures using the shim_lock protocol. However, the verification is not deferred directly to the shim_lock verifier. The shim_lock verifier is hooked into the verification process instead. * A set of grub_{command,extcmd}_lockdown functions that can be used by code registering command handlers, to only register unsafe commands if the GRUB has not been locked down. Signed-off-by: Javier Martinez Canillas <javierm@redhat.com> Reviewed-by: Daniel Kiper <daniel.kiper@oracle.com>
81 lines
2.2 KiB
C
81 lines
2.2 KiB
C
/*
|
|
* GRUB -- GRand Unified Bootloader
|
|
* Copyright (C) 2020 Free Software Foundation, Inc.
|
|
*
|
|
* GRUB is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* GRUB is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with GRUB. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#include <grub/dl.h>
|
|
#include <grub/file.h>
|
|
#include <grub/lockdown.h>
|
|
#include <grub/verify.h>
|
|
|
|
static int lockdown = GRUB_LOCKDOWN_DISABLED;
|
|
|
|
static grub_err_t
|
|
lockdown_verifier_init (grub_file_t io __attribute__ ((unused)),
|
|
enum grub_file_type type,
|
|
void **context __attribute__ ((unused)),
|
|
enum grub_verify_flags *flags)
|
|
{
|
|
*flags = GRUB_VERIFY_FLAGS_SKIP_VERIFICATION;
|
|
|
|
switch (type & GRUB_FILE_TYPE_MASK)
|
|
{
|
|
case GRUB_FILE_TYPE_GRUB_MODULE:
|
|
case GRUB_FILE_TYPE_LINUX_KERNEL:
|
|
case GRUB_FILE_TYPE_MULTIBOOT_KERNEL:
|
|
case GRUB_FILE_TYPE_XEN_HYPERVISOR:
|
|
case GRUB_FILE_TYPE_BSD_KERNEL:
|
|
case GRUB_FILE_TYPE_XNU_KERNEL:
|
|
case GRUB_FILE_TYPE_PLAN9_KERNEL:
|
|
case GRUB_FILE_TYPE_NTLDR:
|
|
case GRUB_FILE_TYPE_TRUECRYPT:
|
|
case GRUB_FILE_TYPE_FREEDOS:
|
|
case GRUB_FILE_TYPE_PXECHAINLOADER:
|
|
case GRUB_FILE_TYPE_PCCHAINLOADER:
|
|
case GRUB_FILE_TYPE_COREBOOT_CHAINLOADER:
|
|
case GRUB_FILE_TYPE_EFI_CHAINLOADED_IMAGE:
|
|
case GRUB_FILE_TYPE_ACPI_TABLE:
|
|
case GRUB_FILE_TYPE_DEVICE_TREE_IMAGE:
|
|
*flags = GRUB_VERIFY_FLAGS_DEFER_AUTH;
|
|
|
|
/* Fall through. */
|
|
|
|
default:
|
|
return GRUB_ERR_NONE;
|
|
}
|
|
}
|
|
|
|
struct grub_file_verifier lockdown_verifier =
|
|
{
|
|
.name = "lockdown_verifier",
|
|
.init = lockdown_verifier_init,
|
|
};
|
|
|
|
void
|
|
grub_lockdown (void)
|
|
{
|
|
lockdown = GRUB_LOCKDOWN_ENABLED;
|
|
|
|
grub_verifier_register (&lockdown_verifier);
|
|
}
|
|
|
|
int
|
|
grub_is_lockdown (void)
|
|
{
|
|
return lockdown;
|
|
}
|