1 // SPDX-License-Identifier: GPL-2.0+
3 * Menu-driven UEFI Secure Boot Key Maintenance
5 * Copyright (c) 2022 Masahisa Kojima, Linaro Limited
15 #include <efi_loader.h>
16 #include <efi_config.h>
17 #include <efi_variable.h>
18 #include <crypto/pkcs7_parser.h>
20 struct eficonfig_sig_data {
21 struct efi_signature_list *esl;
22 struct efi_signature_data *esd;
23 struct list_head list;
27 enum efi_sbkey_signature_type {
34 struct eficonfig_sigtype_to_str {
37 enum efi_sbkey_signature_type type;
40 static const struct eficonfig_sigtype_to_str sigtype_to_str[] = {
41 {EFI_CERT_X509_GUID, "X509", SIG_TYPE_X509},
42 {EFI_CERT_SHA256_GUID, "SHA256", SIG_TYPE_HASH},
43 {EFI_CERT_X509_SHA256_GUID, "X509_SHA256 CRL", SIG_TYPE_CRL},
44 {EFI_CERT_X509_SHA384_GUID, "X509_SHA384 CRL", SIG_TYPE_CRL},
45 {EFI_CERT_X509_SHA512_GUID, "X509_SHA512 CRL", SIG_TYPE_CRL},
46 /* U-Boot does not support the following signature types */
47 /* {EFI_CERT_RSA2048_GUID, "RSA2048", SIG_TYPE_RSA2048}, */
48 /* {EFI_CERT_RSA2048_SHA256_GUID, "RSA2048_SHA256", SIG_TYPE_RSA2048}, */
49 /* {EFI_CERT_SHA1_GUID, "SHA1", SIG_TYPE_HASH}, */
50 /* {EFI_CERT_RSA2048_SHA_GUID, "RSA2048_SHA", SIG_TYPE_RSA2048 }, */
51 /* {EFI_CERT_SHA224_GUID, "SHA224", SIG_TYPE_HASH}, */
52 /* {EFI_CERT_SHA384_GUID, "SHA384", SIG_TYPE_HASH}, */
53 /* {EFI_CERT_SHA512_GUID, "SHA512", SIG_TYPE_HASH}, */
57 * file_have_auth_header() - check file has EFI_VARIABLE_AUTHENTICATION_2 header
58 * @buf: pointer to file
60 * Return: true if file has auth header, false otherwise
62 static bool file_have_auth_header(void *buf, efi_uintn_t size)
64 struct efi_variable_authentication_2 *auth = buf;
66 if (auth->auth_info.hdr.wCertificateType != WIN_CERT_TYPE_EFI_GUID)
69 if (guidcmp(&auth->auth_info.cert_type, &efi_guid_cert_type_pkcs7))
76 * eficonfig_process_enroll_key() - enroll key into signature database
78 * @data: pointer to the data for each entry
81 static efi_status_t eficonfig_process_enroll_key(void *data)
87 struct efi_file_handle *f = NULL;
88 struct efi_device_path *full_dp = NULL;
89 struct eficonfig_select_file_info file_info;
91 file_info.current_path = calloc(1, EFICONFIG_FILE_PATH_BUF_SIZE);
92 if (!file_info.current_path) {
93 ret = EFI_OUT_OF_RESOURCES;
97 ret = eficonfig_process_select_file(&file_info);
98 if (ret != EFI_SUCCESS)
101 full_dp = eficonfig_create_device_path(file_info.dp_volume, file_info.current_path);
103 ret = EFI_OUT_OF_RESOURCES;
106 f = efi_file_from_path(full_dp);
113 ret = EFI_CALL(f->getinfo(f, &efi_file_info_guid, &size, NULL));
114 if (ret != EFI_BUFFER_TOO_SMALL)
119 ret = EFI_OUT_OF_RESOURCES;
122 ret = EFI_CALL(f->getinfo(f, &efi_file_info_guid, &size, buf));
123 if (ret != EFI_SUCCESS)
126 size = ((struct efi_file_info *)buf)->file_size;
130 eficonfig_print_msg("ERROR! File is empty.");
131 ret = EFI_INVALID_PARAMETER;
137 ret = EFI_OUT_OF_RESOURCES;
141 ret = EFI_CALL(f->read(f, &size, buf));
142 if (ret != EFI_SUCCESS) {
143 eficonfig_print_msg("ERROR! Failed to read file.");
146 if (!file_have_auth_header(buf, size)) {
147 eficonfig_print_msg("ERROR! Invalid file format. Only .auth variables is allowed.");
148 ret = EFI_INVALID_PARAMETER;
152 attr = EFI_VARIABLE_NON_VOLATILE |
153 EFI_VARIABLE_BOOTSERVICE_ACCESS |
154 EFI_VARIABLE_RUNTIME_ACCESS |
155 EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS;
157 /* PK can enroll only one certificate */
158 if (u16_strcmp(data, u"PK")) {
159 efi_uintn_t db_size = 0;
161 /* check the variable exists. If exists, add APPEND_WRITE attribute */
162 ret = efi_get_variable_int(data, efi_auth_var_get_guid(data), NULL,
163 &db_size, NULL, NULL);
164 if (ret == EFI_BUFFER_TOO_SMALL)
165 attr |= EFI_VARIABLE_APPEND_WRITE;
168 ret = efi_set_variable_int((u16 *)data, efi_auth_var_get_guid((u16 *)data),
169 attr, size, buf, false);
170 if (ret != EFI_SUCCESS)
171 eficonfig_print_msg("ERROR! Failed to update signature database");
174 free(file_info.current_path);
176 efi_free_pool(full_dp);
178 EFI_CALL(f->close(f));
180 /* return to the parent menu */
181 ret = (ret == EFI_ABORTED) ? EFI_NOT_READY : ret;
187 * eficonfig_process_show_siglist() - show signature list content
189 * @data: pointer to the data for each entry
190 * Return: status code
192 static efi_status_t eficonfig_process_show_siglist(void *data)
195 struct eficonfig_sig_data *sg = data;
197 puts(ANSI_CURSOR_HIDE);
198 puts(ANSI_CLEAR_CONSOLE);
199 printf(ANSI_CURSOR_POSITION, 1, 1);
201 printf("\n ** Show Signature Database (%ls) **\n\n"
204 sg->varname, sg->esd->signature_owner.b);
206 for (i = 0; i < ARRAY_SIZE(sigtype_to_str); i++) {
207 if (!guidcmp(&sg->esl->signature_type, &sigtype_to_str[i].sig_type)) {
208 printf(" Signature Type:\n"
209 " %s\n", sigtype_to_str[i].str);
211 switch (sigtype_to_str[i].type) {
214 struct x509_certificate *cert_tmp;
216 cert_tmp = x509_cert_parse(sg->esd->signature_data,
217 sg->esl->signature_size);
222 cert_tmp->subject, cert_tmp->issuer);
227 u32 hash_size = sg->esl->signature_size - sizeof(efi_guid_t) -
228 sizeof(struct efi_time);
229 struct efi_time *time =
230 (struct efi_time *)((u8 *)sg->esd->signature_data +
233 printf(" ToBeSignedHash:\n");
234 print_hex_dump(" ", DUMP_PREFIX_NONE, 16, 1,
235 sg->esd->signature_data, hash_size, false);
236 printf(" TimeOfRevocation:\n"
237 " %d-%d-%d %02d:%02d:%02d\n",
238 time->year, time->month, time->day,
239 time->hour, time->minute, time->second);
244 u32 hash_size = sg->esl->signature_size - sizeof(efi_guid_t);
247 print_hex_dump(" ", DUMP_PREFIX_NONE, 16, 1,
248 sg->esd->signature_data, hash_size, false);
252 eficonfig_print_msg("ERROR! Unsupported format.");
253 return EFI_INVALID_PARAMETER;
261 printf("\n\n Press any key to continue");
268 * prepare_signature_list_menu() - create the signature list menu entry
270 * @efimenu: pointer to the efimenu structure
271 * @varname: pointer to the variable name
272 * @db: pointer to the variable raw data
273 * @db_size: variable data size
274 * @func: callback of each entry
275 * Return: status code
277 static efi_status_t prepare_signature_list_menu(struct efimenu *efi_menu, void *varname,
278 void *db, efi_uintn_t db_size,
279 eficonfig_entry_func func)
283 struct eficonfig_sig_data *sg;
284 struct efi_signature_list *esl;
285 struct efi_signature_data *esd;
286 efi_status_t ret = EFI_SUCCESS;
288 INIT_LIST_HEAD(&efi_menu->list);
295 esd = (struct efi_signature_data *)((u8 *)esl +
296 (sizeof(struct efi_signature_list) +
297 esl->signature_header_size));
298 remain = esl->signature_list_size - sizeof(struct efi_signature_list) -
299 esl->signature_header_size;
300 for (; remain > 0; remain -= esl->signature_size) {
304 if (num >= EFICONFIG_ENTRY_NUM_MAX - 1) {
305 ret = EFI_OUT_OF_RESOURCES;
309 sg = calloc(1, sizeof(struct eficonfig_sig_data));
311 ret = EFI_OUT_OF_RESOURCES;
315 snprintf(buf, sizeof(buf), "%pUL", &esd->signature_owner);
319 ret = EFI_OUT_OF_RESOURCES;
325 sg->varname = varname;
326 ret = eficonfig_append_menu_entry(efi_menu, title, func, sg);
327 if (ret != EFI_SUCCESS) {
332 esd = (struct efi_signature_data *)((u8 *)esd + esl->signature_size);
336 size -= esl->signature_list_size;
337 esl = (struct efi_signature_list *)((u8 *)esl + esl->signature_list_size);
340 ret = eficonfig_append_quit_entry(efi_menu);
346 * enumerate_and_show_signature_database() - enumerate and show the signature database
348 * @data: pointer to the data for each entry
349 * Return: status code
351 static efi_status_t enumerate_and_show_signature_database(void *varname)
357 struct efimenu *efi_menu;
358 struct list_head *pos, *n;
359 struct eficonfig_entry *entry;
361 db = efi_get_var(varname, efi_auth_var_get_guid(varname), &db_size);
363 eficonfig_print_msg("There is no entry in the signature database.");
364 return EFI_NOT_FOUND;
367 efi_menu = calloc(1, sizeof(struct efimenu));
370 return EFI_OUT_OF_RESOURCES;
373 ret = prepare_signature_list_menu(efi_menu, varname, db, db_size,
374 eficonfig_process_show_siglist);
375 if (ret != EFI_SUCCESS)
378 snprintf(buf, sizeof(buf), " ** Show Signature Database (%ls) **", (u16 *)varname);
379 ret = eficonfig_process_common(efi_menu, buf);
381 list_for_each_safe(pos, n, &efi_menu->list) {
382 entry = list_entry(pos, struct eficonfig_entry, list);
385 eficonfig_destroy(efi_menu);
392 * eficonfig_process_show_signature_database() - process show signature database
394 * @data: pointer to the data for each entry
395 * Return: status code
397 static efi_status_t eficonfig_process_show_signature_database(void *data)
402 ret = enumerate_and_show_signature_database(data);
403 if (ret != EFI_SUCCESS && ret != EFI_NOT_READY)
407 /* return to the parent menu */
408 ret = (ret == EFI_ABORTED) ? EFI_NOT_READY : ret;
413 static struct eficonfig_item key_config_menu_items[] = {
414 {"Enroll New Key", eficonfig_process_enroll_key},
415 {"Show Signature Database", eficonfig_process_show_signature_database},
416 {"Quit", eficonfig_process_quit},
420 * eficonfig_process_set_secure_boot_key() - display the key configuration menu
422 * @data: pointer to the data for each entry
423 * Return: status code
425 static efi_status_t eficonfig_process_set_secure_boot_key(void *data)
430 struct efimenu *efi_menu;
432 for (i = 0; i < ARRAY_SIZE(key_config_menu_items); i++)
433 key_config_menu_items[i].data = data;
435 snprintf(header_str, sizeof(header_str), " ** Configure %ls **", (u16 *)data);
438 efi_menu = eficonfig_create_fixed_menu(key_config_menu_items,
439 ARRAY_SIZE(key_config_menu_items));
441 ret = eficonfig_process_common(efi_menu, header_str);
442 eficonfig_destroy(efi_menu);
444 if (ret == EFI_ABORTED)
448 /* return to the parent menu */
449 ret = (ret == EFI_ABORTED) ? EFI_NOT_READY : ret;
454 static const struct eficonfig_item secure_boot_menu_items[] = {
455 {"PK", eficonfig_process_set_secure_boot_key, u"PK"},
456 {"KEK", eficonfig_process_set_secure_boot_key, u"KEK"},
457 {"db", eficonfig_process_set_secure_boot_key, u"db"},
458 {"dbx", eficonfig_process_set_secure_boot_key, u"dbx"},
459 {"Quit", eficonfig_process_quit},
463 * eficonfig_process_secure_boot_config() - display the key list menu
465 * @data: pointer to the data for each entry
466 * Return: status code
468 efi_status_t eficonfig_process_secure_boot_config(void *data)
471 struct efimenu *efi_menu;
476 snprintf(header_str, sizeof(header_str),
477 " ** UEFI Secure Boot Key Configuration (SecureBoot : %s) **",
478 (efi_secure_boot_enabled() ? "ON" : "OFF"));
480 efi_menu = eficonfig_create_fixed_menu(secure_boot_menu_items,
481 ARRAY_SIZE(secure_boot_menu_items));
483 ret = EFI_OUT_OF_RESOURCES;
487 ret = eficonfig_process_common(efi_menu, header_str);
488 eficonfig_destroy(efi_menu);
490 if (ret == EFI_ABORTED)
494 /* return to the parent menu */
495 ret = (ret == EFI_ABORTED) ? EFI_NOT_READY : ret;