/* cc-firmware-security-utils.c * * Copyright (C) 2021 Red Hat, Inc * * This program 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 2 of the License, or * (at your option) any later version. * * This program 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 this program; if not, see . * * Author: Kate Hsuan * * SPDX-License-Identifier: GPL-2.0-or-later */ #include "config.h" #include #include "cc-firmware-security-utils.h" /* we don't need to keep this up to date, as any new attrs added by fwupd >= 1.8.3 will also * come with translated titles *and* descriptions */ static const gchar * fu_security_attr_get_title_fallback (const gchar *appstream_id) { if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SPI_BIOSWE) == 0) { /* TRANSLATORS: Title: firmware refers to the flash chip in the computer */ return _("Firmware Write Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SPI_BLE) == 0) { /* TRANSLATORS: Title: firmware refers to the flash chip in the computer */ return _("Firmware Write Protection Lock"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SPI_SMM_BWP) == 0) { /* TRANSLATORS: Title: SPI refers to the flash chip in the computer */ return _("Firmware BIOS Region"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SPI_DESCRIPTOR) == 0) { /* TRANSLATORS: Title: firmware refers to the flash chip in the computer */ return _("Firmware BIOS Descriptor"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_PREBOOT_DMA_PROTECTION) == 0) { /* TRANSLATORS: Title: DMA as in https://en.wikipedia.org/wiki/DMA_attack */ return _("Pre-boot DMA Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_BOOTGUARD_ENABLED) == 0) { /* TRANSLATORS: Title: BootGuard is a trademark from Intel */ return _("Intel BootGuard"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_BOOTGUARD_VERIFIED) == 0) { /* TRANSLATORS: Title: BootGuard is a trademark from Intel, * verified boot refers to the way the boot process is verified */ return _("Intel BootGuard Verified Boot"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_BOOTGUARD_ACM) == 0) { /* TRANSLATORS: Title: BootGuard is a trademark from Intel, * ACM means to verify the integrity of Initial Boot Block */ return _("Intel BootGuard ACM Protected"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_BOOTGUARD_POLICY) == 0) { /* TRANSLATORS: Title: BootGuard is a trademark from Intel, * error policy is what to do on failure */ return _("Intel BootGuard Error Policy"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_BOOTGUARD_OTP) == 0) { /* TRANSLATORS: Title: BootGuard is a trademark from Intel */ return _("Intel BootGuard Fuse"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_CET_ENABLED) == 0) { /* TRANSLATORS: Title: CET = Control-flow Enforcement Technology, * enabled means supported by the processor */ return _("Intel CET Enabled"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_CET_ACTIVE) == 0) { /* TRANSLATORS: Title: CET = Control-flow Enforcement Technology, * active means being used by the OS */ return _("Intel CET Active"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_INTEL_SMAP) == 0) { /* TRANSLATORS: Title: SMAP = Supervisor Mode Access Prevention */ return _("Intel SMAP"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_ENCRYPTED_RAM) == 0) { /* TRANSLATORS: Title: Memory contents are encrypted, e.g. Intel TME */ return _("Encrypted RAM"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_IOMMU) == 0) { /* TRANSLATORS: Title: * https://en.wikipedia.org/wiki/Input%E2%80%93output_memory_management_unit */ return _("IOMMU Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_KERNEL_LOCKDOWN) == 0) { /* TRANSLATORS: Title: lockdown is a security mode of the kernel */ return _("Linux Kernel Lockdown"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_KERNEL_TAINTED) == 0) { /* TRANSLATORS: Title: if it's tainted or not */ return _("Linux Kernel Verification"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_KERNEL_SWAP) == 0) { /* TRANSLATORS: Title: swap space or swap partition */ return _("Linux Swap"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SUSPEND_TO_RAM) == 0) { /* TRANSLATORS: Title: sleep state */ return _("Suspend To RAM"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SUSPEND_TO_IDLE) == 0) { /* TRANSLATORS: Title: a better sleep state */ return _("Suspend To Idle"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_UEFI_PK) == 0) { /* TRANSLATORS: Title: PK is the 'platform key' for the machine */ return _("UEFI Platform Key"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_UEFI_SECUREBOOT) == 0) { /* TRANSLATORS: Title: SB is a way of locking down UEFI */ return _("UEFI Secure Boot"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_TPM_EMPTY_PCR) == 0) { /* TRANSLATORS: Title: PCRs (Platform Configuration Registers) shouldn't be empty */ return _("TPM Platform Configuration"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_TPM_RECONSTRUCTION_PCR0) == 0) { /* TRANSLATORS: Title: the PCR is rebuilt from the TPM event log */ return _("TPM Reconstruction"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_TPM_VERSION_20) == 0) { /* TRANSLATORS: Title: TPM = Trusted Platform Module */ return _("TPM v2.0"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_MEI_MANUFACTURING_MODE) == 0) { /* TRANSLATORS: Title: MEI = Intel Management Engine */ return _("Intel Management Engine Manufacturing Mode"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_MEI_OVERRIDE_STRAP) == 0) { /* TRANSLATORS: Title: MEI = Intel Management Engine, and the "override" is enabled * with a jumper -- luckily it is probably not accessible to end users on consumer * boards */ return _("Intel Management Engine Override"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_MEI_VERSION) == 0) { /* TRANSLATORS: Title: MEI = Intel Management Engine */ return _("Intel Management Engine Version"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_FWUPD_UPDATES) == 0) { /* TRANSLATORS: Title: if firmware updates are available */ return _("Firmware Updates"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_FWUPD_ATTESTATION) == 0) { /* TRANSLATORS: Title: if we can verify the firmware checksums */ return _("Firmware Attestation"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_FWUPD_PLUGINS) == 0) { /* TRANSLATORS: Title: if the fwupd plugins are all present and correct */ return _("Firmware Updater Verification"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_PLATFORM_DEBUG_ENABLED) == 0 || g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_PLATFORM_DEBUG_LOCKED) == 0) { /* TRANSLATORS: Title: Allows debugging of parts using proprietary hardware */ return _("Platform Debugging"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_SUPPORTED_CPU) == 0) { /* TRANSLATORS: Title: if fwupd supports HSI on this chip */ return _("Processor Security Checks"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_AMD_ROLLBACK_PROTECTION) == 0) { /* TRANSLATORS: Title: if firmware enforces rollback protection */ return _("AMD Rollback Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_AMD_SPI_REPLAY_PROTECTION) == 0) { /* TRANSLATORS: Title: if hardware enforces control of SPI replays */ return _("AMD Firmware Replay Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_AMD_SPI_WRITE_PROTECTION) == 0) { /* TRANSLATORS: Title: if hardware enforces control of SPI writes */ return _("AMD Firmware Write Protection"); } if (g_strcmp0 (appstream_id, FWUPD_SECURITY_ATTR_ID_PLATFORM_FUSED) == 0) { /* TRANSLATORS: Title: if the part has been fused */ return _("Fused Platform"); } return NULL; } const gchar * fwupd_security_attr_result_to_string (FwupdSecurityAttrResult result) { if (result == FWUPD_SECURITY_ATTR_RESULT_VALID) { /* TRANSLATORS: if the stauts is valid. For example security check is valid and key is valid. */ return _("Valid"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_VALID) { /* TRANSLATORS: if the status or key is not valid. */ return _("Not Valid"); } if (result == FWUPD_SECURITY_ATTR_RESULT_ENABLED) { /* TRANSLATORS: if the function is enabled through BIOS or OS settings. */ return _("Enabled"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_ENABLED) { /* TRANSLATORS: if the function is not enabled through BIOS or OS settings. */ return _("Not Enabled"); } if (result == FWUPD_SECURITY_ATTR_RESULT_LOCKED) { /* TRANSLATORS: the memory space or system mode is locked to prevent from malicious modification. */ return _("Locked"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_LOCKED) { /* TRANSLATORS: the memory space or system mode is not locked. */ return _("Not Locked"); } if (result == FWUPD_SECURITY_ATTR_RESULT_ENCRYPTED) { /* TRANSLATORS: The data is encrypted to prevent from malicious reading. */ return _("Encrypted"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_ENCRYPTED) { /* TRANSLATORS: the data in memory is plane text. */ return _("Not Encrypted"); } if (result == FWUPD_SECURITY_ATTR_RESULT_TAINTED) { /* TRANSLATORS: Linux kernel is tainted by third party kernel module. */ return _("Tainted"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_TAINTED) { /* TRANSLATORS: All the loaded kernel module are licensed. */ return _("Not Tainted"); } if (result == FWUPD_SECURITY_ATTR_RESULT_FOUND) { /* TRANSLATORS: the feature can be detected. */ return _("Found"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_FOUND) { /* TRANSLATORS: the feature can't be detected. */ return _("Not Found"); } if (result == FWUPD_SECURITY_ATTR_RESULT_SUPPORTED) { /* TRANSLATORS: the function is supported by hardware. */ return _("Supported"); } if (result == FWUPD_SECURITY_ATTR_RESULT_NOT_SUPPORTED) { /* TRANSLATORS: the function isn't supported by hardware. */ return _("Not Supported"); } return NULL; } /* ->summary and ->description are translated */ FwupdSecurityAttr * fu_security_attr_new_from_variant (GVariantIter *iter) { FwupdSecurityAttr *attr = g_new0 (FwupdSecurityAttr, 1); const gchar *key; GVariant *value; while (g_variant_iter_next (iter, "{&sv}", &key, &value)) { if (g_strcmp0 (key, "AppstreamId") == 0) attr->appstream_id = g_variant_dup_string (value, NULL); else if (g_strcmp0 (key, "Flags") == 0) attr->flags = g_variant_get_uint64(value); else if (g_strcmp0 (key, "HsiLevel") == 0) attr->hsi_level = g_variant_get_uint32 (value); else if (g_strcmp0 (key, "HsiResult") == 0) attr->result = g_variant_get_uint32 (value); else if (g_strcmp0 (key, "HsiResultFallback") == 0) attr->result_fallback = g_variant_get_uint32 (value); else if (g_strcmp0 (key, "Created") == 0) attr->timestamp = g_variant_get_uint64 (value); else if (g_strcmp0 (key, "Description") == 0) attr->description = g_strdup (dgettext ("fwupd", g_variant_get_string (value, NULL))); else if (g_strcmp0 (key, "Summary") == 0) attr->title = g_strdup (dgettext ("fwupd", g_variant_get_string (value, NULL))); g_variant_unref (value); } /* in fwupd <= 1.8.3 org.fwupd.hsi.Uefi.SecureBoot was incorrectly marked as HSI-0 */ if (g_strcmp0 (attr->appstream_id, FWUPD_SECURITY_ATTR_ID_UEFI_SECUREBOOT) == 0) attr->hsi_level = 1; /* fallback for older fwupd versions */ if (attr->appstream_id != NULL && attr->title == NULL) attr->title = g_strdup (fu_security_attr_get_title_fallback (attr->appstream_id)); /* success */ return attr; } void fu_security_attr_free (FwupdSecurityAttr *attr) { g_free (attr->appstream_id); g_free (attr->title); g_free (attr->description); g_free (attr); } gboolean firmware_security_attr_has_flag (FwupdSecurityAttr *attr, FwupdSecurityAttrFlags flag) { return (attr->flags & flag) > 0; } void load_custom_css (const char *path) { g_autoptr (GtkCssProvider) provider = gtk_css_provider_new (); gtk_css_provider_load_from_resource (provider, path); gtk_style_context_add_provider_for_display (gdk_display_get_default (), GTK_STYLE_PROVIDER (provider), GTK_STYLE_PROVIDER_PRIORITY_USER); }