2 HII Config Access protocol implementation of SecureBoot configuration module.
4 Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #include "SecureBootConfigImpl.h"
17 CHAR16 mSecureBootStorageName
[] = L
"SECUREBOOT_CONFIGURATION";
19 SECUREBOOT_CONFIG_PRIVATE_DATA mSecureBootConfigPrivateDateTemplate
= {
20 SECUREBOOT_CONFIG_PRIVATE_DATA_SIGNATURE
,
22 SecureBootExtractConfig
,
23 SecureBootRouteConfig
,
28 HII_VENDOR_DEVICE_PATH mSecureBootHiiVendorDevicePath
= {
34 (UINT8
) (sizeof (VENDOR_DEVICE_PATH
)),
35 (UINT8
) ((sizeof (VENDOR_DEVICE_PATH
)) >> 8)
38 SECUREBOOT_CONFIG_FORM_SET_GUID
42 END_ENTIRE_DEVICE_PATH_SUBTYPE
,
44 (UINT8
) (END_DEVICE_PATH_LENGTH
),
45 (UINT8
) ((END_DEVICE_PATH_LENGTH
) >> 8)
51 BOOLEAN mIsEnterSecureBootForm
= FALSE
;
54 // OID ASN.1 Value for Hash Algorithms
56 UINT8 mHashOidValue
[] = {
57 0x2A, 0x86, 0x48, 0x86, 0xF7, 0x0D, 0x02, 0x05, // OBJ_md5
58 0x2B, 0x0E, 0x03, 0x02, 0x1A, // OBJ_sha1
59 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x04, // OBJ_sha224
60 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x01, // OBJ_sha256
61 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x02, // OBJ_sha384
62 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x03, // OBJ_sha512
65 HASH_TABLE mHash
[] = {
66 { L
"SHA1", 20, &mHashOidValue
[8], 5, Sha1GetContextSize
, Sha1Init
, Sha1Update
, Sha1Final
},
67 { L
"SHA224", 28, &mHashOidValue
[13], 9, NULL
, NULL
, NULL
, NULL
},
68 { L
"SHA256", 32, &mHashOidValue
[22], 9, Sha256GetContextSize
, Sha256Init
, Sha256Update
, Sha256Final
},
69 { L
"SHA384", 48, &mHashOidValue
[31], 9, Sha384GetContextSize
, Sha384Init
, Sha384Update
, Sha384Final
},
70 { L
"SHA512", 64, &mHashOidValue
[40], 9, Sha512GetContextSize
, Sha512Init
, Sha512Update
, Sha512Final
}
74 // Variable Definitions
76 UINT32 mPeCoffHeaderOffset
= 0;
77 WIN_CERTIFICATE
*mCertificate
= NULL
;
78 IMAGE_TYPE mImageType
;
79 UINT8
*mImageBase
= NULL
;
81 UINT8 mImageDigest
[MAX_DIGEST_SIZE
];
82 UINTN mImageDigestSize
;
84 EFI_IMAGE_SECURITY_DATA_DIRECTORY
*mSecDataDir
= NULL
;
85 EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION mNtHeader
;
88 // Possible DER-encoded certificate file suffixes, end with NULL pointer.
90 CHAR16
* mDerEncodedSuffix
[] = {
96 CHAR16
* mSupportX509Suffix
= L
"*.cer/der/crt";
99 This code checks if the FileSuffix is one of the possible DER-encoded certificate suffix.
101 @param[in] FileSuffix The suffix of the input certificate file
103 @retval TRUE It's a DER-encoded certificate.
104 @retval FALSE It's NOT a DER-encoded certificate.
108 IsDerEncodeCertificate (
109 IN CONST CHAR16
*FileSuffix
113 for (Index
= 0; mDerEncodedSuffix
[Index
] != NULL
; Index
++) {
114 if (StrCmp (FileSuffix
, mDerEncodedSuffix
[Index
]) == 0) {
122 Set Secure Boot option into variable space.
124 @param[in] VarValue The option of Secure Boot.
126 @retval EFI_SUCCESS The operation is finished successfully.
127 @retval Others Other errors as indicated.
131 SaveSecureBootVariable (
137 Status
= gRT
->SetVariable (
138 EFI_SECURE_BOOT_ENABLE_NAME
,
139 &gEfiSecureBootEnableDisableGuid
,
140 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
,
148 Create a time based data payload by concatenating the EFI_VARIABLE_AUTHENTICATION_2
149 descriptor with the input data. NO authentication is required in this function.
151 @param[in, out] DataSize On input, the size of Data buffer in bytes.
152 On output, the size of data returned in Data
154 @param[in, out] Data On input, Pointer to data buffer to be wrapped or
155 pointer to NULL to wrap an empty payload.
156 On output, Pointer to the new payload date buffer allocated from pool,
157 it's caller's responsibility to free the memory when finish using it.
159 @retval EFI_SUCCESS Create time based payload successfully.
160 @retval EFI_OUT_OF_RESOURCES There are not enough memory resourses to create time based payload.
161 @retval EFI_INVALID_PARAMETER The parameter is invalid.
162 @retval Others Unexpected error happens.
166 CreateTimeBasedPayload (
167 IN OUT UINTN
*DataSize
,
175 EFI_VARIABLE_AUTHENTICATION_2
*DescriptorData
;
176 UINTN DescriptorSize
;
179 if (Data
== NULL
|| DataSize
== NULL
) {
180 return EFI_INVALID_PARAMETER
;
184 // In Setup mode or Custom mode, the variable does not need to be signed but the
185 // parameters to the SetVariable() call still need to be prepared as authenticated
186 // variable. So we create EFI_VARIABLE_AUTHENTICATED_2 descriptor without certificate
190 PayloadSize
= *DataSize
;
192 DescriptorSize
= OFFSET_OF (EFI_VARIABLE_AUTHENTICATION_2
, AuthInfo
) + OFFSET_OF (WIN_CERTIFICATE_UEFI_GUID
, CertData
);
193 NewData
= (UINT8
*) AllocateZeroPool (DescriptorSize
+ PayloadSize
);
194 if (NewData
== NULL
) {
195 return EFI_OUT_OF_RESOURCES
;
198 if ((Payload
!= NULL
) && (PayloadSize
!= 0)) {
199 CopyMem (NewData
+ DescriptorSize
, Payload
, PayloadSize
);
202 DescriptorData
= (EFI_VARIABLE_AUTHENTICATION_2
*) (NewData
);
204 ZeroMem (&Time
, sizeof (EFI_TIME
));
205 Status
= gRT
->GetTime (&Time
, NULL
);
206 if (EFI_ERROR (Status
)) {
215 CopyMem (&DescriptorData
->TimeStamp
, &Time
, sizeof (EFI_TIME
));
217 DescriptorData
->AuthInfo
.Hdr
.dwLength
= OFFSET_OF (WIN_CERTIFICATE_UEFI_GUID
, CertData
);
218 DescriptorData
->AuthInfo
.Hdr
.wRevision
= 0x0200;
219 DescriptorData
->AuthInfo
.Hdr
.wCertificateType
= WIN_CERT_TYPE_EFI_GUID
;
220 CopyGuid (&DescriptorData
->AuthInfo
.CertType
, &gEfiCertPkcs7Guid
);
222 if (Payload
!= NULL
) {
226 *DataSize
= DescriptorSize
+ PayloadSize
;
232 Internal helper function to delete a Variable given its name and GUID, NO authentication
235 @param[in] VariableName Name of the Variable.
236 @param[in] VendorGuid GUID of the Variable.
238 @retval EFI_SUCCESS Variable deleted successfully.
239 @retval Others The driver failed to start the device.
244 IN CHAR16
*VariableName
,
245 IN EFI_GUID
*VendorGuid
254 GetVariable2 (VariableName
, VendorGuid
, &Variable
, NULL
);
255 if (Variable
== NULL
) {
262 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
| EFI_VARIABLE_BOOTSERVICE_ACCESS
263 | EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
265 Status
= CreateTimeBasedPayload (&DataSize
, &Data
);
266 if (EFI_ERROR (Status
)) {
267 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
271 Status
= gRT
->SetVariable (
286 Set the platform secure boot mode into "Custom" or "Standard" mode.
288 @param[in] SecureBootMode New secure boot mode: STANDARD_SECURE_BOOT_MODE or
289 CUSTOM_SECURE_BOOT_MODE.
291 @return EFI_SUCCESS The platform has switched to the special mode successfully.
292 @return other Fail to operate the secure boot mode.
297 IN UINT8 SecureBootMode
300 return gRT
->SetVariable (
301 EFI_CUSTOM_MODE_NAME
,
302 &gEfiCustomModeEnableGuid
,
303 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
,
310 Generate the PK signature list from the X509 Certificate storing file (.cer)
312 @param[in] X509File FileHandle of X509 Certificate storing file.
313 @param[out] PkCert Point to the data buffer to store the signature list.
315 @return EFI_UNSUPPORTED Unsupported Key Length.
316 @return EFI_OUT_OF_RESOURCES There are not enough memory resourses to form the signature list.
320 CreatePkX509SignatureList (
321 IN EFI_FILE_HANDLE X509File
,
322 OUT EFI_SIGNATURE_LIST
**PkCert
328 EFI_SIGNATURE_DATA
*PkCertData
;
334 Status
= ReadFileContent (X509File
, (VOID
**) &X509Data
, &X509DataSize
, 0);
335 if (EFI_ERROR (Status
)) {
338 ASSERT (X509Data
!= NULL
);
341 // Allocate space for PK certificate list and initialize it.
342 // Create PK database entry with SignatureHeaderSize equals 0.
344 *PkCert
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (
345 sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1
348 if (*PkCert
== NULL
) {
349 Status
= EFI_OUT_OF_RESOURCES
;
353 (*PkCert
)->SignatureListSize
= (UINT32
) (sizeof(EFI_SIGNATURE_LIST
)
354 + sizeof(EFI_SIGNATURE_DATA
) - 1
356 (*PkCert
)->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
357 (*PkCert
)->SignatureHeaderSize
= 0;
358 CopyGuid (&(*PkCert
)->SignatureType
, &gEfiCertX509Guid
);
359 PkCertData
= (EFI_SIGNATURE_DATA
*) ((UINTN
)(*PkCert
)
360 + sizeof(EFI_SIGNATURE_LIST
)
361 + (*PkCert
)->SignatureHeaderSize
);
362 CopyGuid (&PkCertData
->SignatureOwner
, &gEfiGlobalVariableGuid
);
364 // Fill the PK database with PKpub data from X509 certificate file.
366 CopyMem (&(PkCertData
->SignatureData
[0]), X509Data
, X509DataSize
);
370 if (X509Data
!= NULL
) {
374 if (EFI_ERROR(Status
) && *PkCert
!= NULL
) {
383 Enroll new PK into the System without original PK's authentication.
385 The SignatureOwner GUID will be the same with PK's vendorguid.
387 @param[in] PrivateData The module's private data.
389 @retval EFI_SUCCESS New PK enrolled successfully.
390 @retval EFI_INVALID_PARAMETER The parameter is invalid.
391 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
396 IN SECUREBOOT_CONFIG_PRIVATE_DATA
* Private
402 EFI_SIGNATURE_LIST
*PkCert
;
406 if (Private
->FileContext
->FileName
== NULL
) {
407 return EFI_INVALID_PARAMETER
;
412 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
413 if (EFI_ERROR (Status
)) {
418 // Parse the file's postfix. Only support DER encoded X.509 certificate files.
420 NameLength
= StrLen (Private
->FileContext
->FileName
);
421 if (NameLength
<= 4) {
422 return EFI_INVALID_PARAMETER
;
424 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
425 if (!IsDerEncodeCertificate(FilePostFix
)) {
426 DEBUG ((EFI_D_ERROR
, "Unsupported file type, only DER encoded certificate (%s) is supported.", mSupportX509Suffix
));
427 return EFI_INVALID_PARAMETER
;
429 DEBUG ((EFI_D_INFO
, "FileName= %s\n", Private
->FileContext
->FileName
));
430 DEBUG ((EFI_D_INFO
, "FilePostFix = %s\n", FilePostFix
));
433 // Prase the selected PK file and generature PK certificate list.
435 Status
= CreatePkX509SignatureList (
436 Private
->FileContext
->FHandle
,
439 if (EFI_ERROR (Status
)) {
442 ASSERT (PkCert
!= NULL
);
445 // Set Platform Key variable.
447 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
448 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
449 DataSize
= PkCert
->SignatureListSize
;
450 Status
= CreateTimeBasedPayload (&DataSize
, (UINT8
**) &PkCert
);
451 if (EFI_ERROR (Status
)) {
452 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
456 Status
= gRT
->SetVariable(
457 EFI_PLATFORM_KEY_NAME
,
458 &gEfiGlobalVariableGuid
,
463 if (EFI_ERROR (Status
)) {
464 if (Status
== EFI_OUT_OF_RESOURCES
) {
465 DEBUG ((EFI_D_ERROR
, "Enroll PK failed with out of resource.\n"));
472 if (PkCert
!= NULL
) {
476 if (Private
->FileContext
->FHandle
!= NULL
) {
477 CloseFile (Private
->FileContext
->FHandle
);
478 Private
->FileContext
->FHandle
= NULL
;
485 Remove the PK variable.
487 @retval EFI_SUCCESS Delete PK successfully.
488 @retval Others Could not allow to delete PK.
498 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
499 if (EFI_ERROR (Status
)) {
503 Status
= DeleteVariable (
504 EFI_PLATFORM_KEY_NAME
,
505 &gEfiGlobalVariableGuid
511 Enroll a new KEK item from public key storing file (*.pbk).
513 @param[in] PrivateData The module's private data.
515 @retval EFI_SUCCESS New KEK enrolled successfully.
516 @retval EFI_INVALID_PARAMETER The parameter is invalid.
517 @retval EFI_UNSUPPORTED Unsupported command.
518 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
523 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
529 EFI_SIGNATURE_LIST
*KekSigList
;
532 CPL_KEY_INFO
*KeyInfo
;
533 EFI_SIGNATURE_DATA
*KEKSigData
;
534 UINTN KekSigListSize
;
549 // Form the KeKpub certificate list into EFI_SIGNATURE_LIST type.
550 // First, We have to parse out public key data from the pbk key file.
552 Status
= ReadFileContent (
553 Private
->FileContext
->FHandle
,
558 if (EFI_ERROR (Status
)) {
561 ASSERT (KeyBlob
!= NULL
);
562 KeyInfo
= (CPL_KEY_INFO
*) KeyBlob
;
563 if (KeyInfo
->KeyLengthInBits
/ 8 != WIN_CERT_UEFI_RSA2048_SIZE
) {
564 DEBUG ((DEBUG_ERROR
, "Unsupported key length, Only RSA2048 is supported.\n"));
565 Status
= EFI_UNSUPPORTED
;
570 // Convert the Public key to fix octet string format represented in RSA PKCS#1.
572 KeyLenInBytes
= KeyInfo
->KeyLengthInBits
/ 8;
573 KeyBuffer
= AllocateZeroPool (KeyLenInBytes
);
574 if (KeyBuffer
== NULL
) {
575 Status
= EFI_OUT_OF_RESOURCES
;
579 (UINTN
*) (KeyBlob
+ sizeof (CPL_KEY_INFO
)),
580 KeyLenInBytes
/ sizeof (UINTN
),
584 CopyMem(KeyBlob
+ sizeof(CPL_KEY_INFO
), KeyBuffer
, KeyLenInBytes
);
587 // Form an new EFI_SIGNATURE_LIST.
589 KekSigListSize
= sizeof(EFI_SIGNATURE_LIST
)
590 + sizeof(EFI_SIGNATURE_DATA
) - 1
591 + WIN_CERT_UEFI_RSA2048_SIZE
;
593 KekSigList
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (KekSigListSize
);
594 if (KekSigList
== NULL
) {
595 Status
= EFI_OUT_OF_RESOURCES
;
599 KekSigList
->SignatureListSize
= sizeof(EFI_SIGNATURE_LIST
)
600 + sizeof(EFI_SIGNATURE_DATA
) - 1
601 + WIN_CERT_UEFI_RSA2048_SIZE
;
602 KekSigList
->SignatureHeaderSize
= 0;
603 KekSigList
->SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + WIN_CERT_UEFI_RSA2048_SIZE
;
604 CopyGuid (&KekSigList
->SignatureType
, &gEfiCertRsa2048Guid
);
606 KEKSigData
= (EFI_SIGNATURE_DATA
*)((UINT8
*)KekSigList
+ sizeof(EFI_SIGNATURE_LIST
));
607 CopyGuid (&KEKSigData
->SignatureOwner
, Private
->SignatureGUID
);
609 KEKSigData
->SignatureData
,
610 KeyBlob
+ sizeof(CPL_KEY_INFO
),
611 WIN_CERT_UEFI_RSA2048_SIZE
615 // Check if KEK entry has been already existed.
616 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
617 // new KEK to original variable.
619 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
620 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
621 Status
= CreateTimeBasedPayload (&KekSigListSize
, (UINT8
**) &KekSigList
);
622 if (EFI_ERROR (Status
)) {
623 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
627 Status
= gRT
->GetVariable(
628 EFI_KEY_EXCHANGE_KEY_NAME
,
629 &gEfiGlobalVariableGuid
,
634 if (Status
== EFI_BUFFER_TOO_SMALL
) {
635 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
636 } else if (Status
!= EFI_NOT_FOUND
) {
641 // Done. Now we have formed the correct KEKpub database item, just set it into variable storage,
643 Status
= gRT
->SetVariable(
644 EFI_KEY_EXCHANGE_KEY_NAME
,
645 &gEfiGlobalVariableGuid
,
650 if (EFI_ERROR (Status
)) {
656 CloseFile (Private
->FileContext
->FHandle
);
657 Private
->FileContext
->FHandle
= NULL
;
658 Private
->FileContext
->FileName
= NULL
;
660 if (Private
->SignatureGUID
!= NULL
) {
661 FreePool (Private
->SignatureGUID
);
662 Private
->SignatureGUID
= NULL
;
665 if (KeyBlob
!= NULL
) {
668 if (KeyBuffer
!= NULL
) {
669 FreePool (KeyBuffer
);
671 if (KekSigList
!= NULL
) {
672 FreePool (KekSigList
);
679 Enroll a new KEK item from X509 certificate file.
681 @param[in] PrivateData The module's private data.
683 @retval EFI_SUCCESS New X509 is enrolled successfully.
684 @retval EFI_INVALID_PARAMETER The parameter is invalid.
685 @retval EFI_UNSUPPORTED Unsupported command.
686 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
691 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
697 EFI_SIGNATURE_DATA
*KEKSigData
;
698 EFI_SIGNATURE_LIST
*KekSigList
;
700 UINTN KekSigListSize
;
710 Status
= ReadFileContent (
711 Private
->FileContext
->FHandle
,
716 if (EFI_ERROR (Status
)) {
719 ASSERT (X509Data
!= NULL
);
721 KekSigListSize
= sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
;
722 KekSigList
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (KekSigListSize
);
723 if (KekSigList
== NULL
) {
724 Status
= EFI_OUT_OF_RESOURCES
;
729 // Fill Certificate Database parameters.
731 KekSigList
->SignatureListSize
= (UINT32
) KekSigListSize
;
732 KekSigList
->SignatureHeaderSize
= 0;
733 KekSigList
->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
734 CopyGuid (&KekSigList
->SignatureType
, &gEfiCertX509Guid
);
736 KEKSigData
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) KekSigList
+ sizeof (EFI_SIGNATURE_LIST
));
737 CopyGuid (&KEKSigData
->SignatureOwner
, Private
->SignatureGUID
);
738 CopyMem (KEKSigData
->SignatureData
, X509Data
, X509DataSize
);
741 // Check if KEK been already existed.
742 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
743 // new kek to original variable
745 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
746 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
747 Status
= CreateTimeBasedPayload (&KekSigListSize
, (UINT8
**) &KekSigList
);
748 if (EFI_ERROR (Status
)) {
749 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
753 Status
= gRT
->GetVariable(
754 EFI_KEY_EXCHANGE_KEY_NAME
,
755 &gEfiGlobalVariableGuid
,
760 if (Status
== EFI_BUFFER_TOO_SMALL
) {
761 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
762 } else if (Status
!= EFI_NOT_FOUND
) {
766 Status
= gRT
->SetVariable(
767 EFI_KEY_EXCHANGE_KEY_NAME
,
768 &gEfiGlobalVariableGuid
,
773 if (EFI_ERROR (Status
)) {
779 CloseFile (Private
->FileContext
->FHandle
);
780 Private
->FileContext
->FileName
= NULL
;
781 Private
->FileContext
->FHandle
= NULL
;
783 if (Private
->SignatureGUID
!= NULL
) {
784 FreePool (Private
->SignatureGUID
);
785 Private
->SignatureGUID
= NULL
;
788 if (KekSigList
!= NULL
) {
789 FreePool (KekSigList
);
796 Enroll new KEK into the System without PK's authentication.
797 The SignatureOwner GUID will be Private->SignatureGUID.
799 @param[in] PrivateData The module's private data.
801 @retval EFI_SUCCESS New KEK enrolled successful.
802 @retval EFI_INVALID_PARAMETER The parameter is invalid.
803 @retval others Fail to enroll KEK data.
807 EnrollKeyExchangeKey (
808 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
815 if ((Private
->FileContext
->FileName
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
816 return EFI_INVALID_PARAMETER
;
819 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
820 if (EFI_ERROR (Status
)) {
825 // Parse the file's postfix. Supports DER-encoded X509 certificate,
826 // and .pbk as RSA public key file.
828 NameLength
= StrLen (Private
->FileContext
->FileName
);
829 if (NameLength
<= 4) {
830 return EFI_INVALID_PARAMETER
;
832 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
833 if (IsDerEncodeCertificate(FilePostFix
)) {
834 return EnrollX509ToKek (Private
);
835 } else if (CompareMem (FilePostFix
, L
".pbk",4) == 0) {
836 return EnrollRsa2048ToKek (Private
);
838 return EFI_INVALID_PARAMETER
;
843 Enroll a new X509 certificate into Signature Database (DB or DBX or DBT) without
844 KEK's authentication.
846 @param[in] PrivateData The module's private data.
847 @param[in] VariableName Variable name of signature database, must be
848 EFI_IMAGE_SECURITY_DATABASE or EFI_IMAGE_SECURITY_DATABASE1.
850 @retval EFI_SUCCESS New X509 is enrolled successfully.
851 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
856 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
857 IN CHAR16
*VariableName
863 EFI_SIGNATURE_LIST
*SigDBCert
;
864 EFI_SIGNATURE_DATA
*SigDBCertData
;
875 SigDBCertData
= NULL
;
878 Status
= ReadFileContent (
879 Private
->FileContext
->FHandle
,
884 if (EFI_ERROR (Status
)) {
887 ASSERT (X509Data
!= NULL
);
889 SigDBSize
= sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
;
891 Data
= AllocateZeroPool (SigDBSize
);
893 Status
= EFI_OUT_OF_RESOURCES
;
898 // Fill Certificate Database parameters.
900 SigDBCert
= (EFI_SIGNATURE_LIST
*) Data
;
901 SigDBCert
->SignatureListSize
= (UINT32
) SigDBSize
;
902 SigDBCert
->SignatureHeaderSize
= 0;
903 SigDBCert
->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
904 CopyGuid (&SigDBCert
->SignatureType
, &gEfiCertX509Guid
);
906 SigDBCertData
= (EFI_SIGNATURE_DATA
*) ((UINT8
* ) SigDBCert
+ sizeof (EFI_SIGNATURE_LIST
));
907 CopyGuid (&SigDBCertData
->SignatureOwner
, Private
->SignatureGUID
);
908 CopyMem ((UINT8
* ) (SigDBCertData
->SignatureData
), X509Data
, X509DataSize
);
911 // Check if signature database entry has been already existed.
912 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
913 // new signature data to original variable
915 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
916 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
917 Status
= CreateTimeBasedPayload (&SigDBSize
, (UINT8
**) &Data
);
918 if (EFI_ERROR (Status
)) {
919 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
923 Status
= gRT
->GetVariable(
925 &gEfiImageSecurityDatabaseGuid
,
930 if (Status
== EFI_BUFFER_TOO_SMALL
) {
931 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
932 } else if (Status
!= EFI_NOT_FOUND
) {
936 Status
= gRT
->SetVariable(
938 &gEfiImageSecurityDatabaseGuid
,
943 if (EFI_ERROR (Status
)) {
949 CloseFile (Private
->FileContext
->FHandle
);
950 Private
->FileContext
->FileName
= NULL
;
951 Private
->FileContext
->FHandle
= NULL
;
953 if (Private
->SignatureGUID
!= NULL
) {
954 FreePool (Private
->SignatureGUID
);
955 Private
->SignatureGUID
= NULL
;
962 if (X509Data
!= NULL
) {
970 Check whether signature is in specified database.
972 @param[in] VariableName Name of database variable that is searched in.
973 @param[in] Signature Pointer to signature that is searched for.
974 @param[in] SignatureSize Size of Signature.
976 @return TRUE Found the signature in the variable database.
977 @return FALSE Not found the signature in the variable database.
981 IsSignatureFoundInDatabase (
982 IN CHAR16
*VariableName
,
984 IN UINTN SignatureSize
988 EFI_SIGNATURE_LIST
*CertList
;
989 EFI_SIGNATURE_DATA
*Cert
;
997 // Read signature database variable.
1002 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1003 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
1007 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1012 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1013 if (EFI_ERROR (Status
)) {
1018 // Enumerate all signature data in SigDB to check if executable's signature exists.
1020 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
1021 while ((DataSize
> 0) && (DataSize
>= CertList
->SignatureListSize
)) {
1022 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
1023 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
1024 if ((CertList
->SignatureSize
== sizeof(EFI_SIGNATURE_DATA
) - 1 + SignatureSize
) && (CompareGuid(&CertList
->SignatureType
, &gEfiCertX509Guid
))) {
1025 for (Index
= 0; Index
< CertCount
; Index
++) {
1026 if (CompareMem (Cert
->SignatureData
, Signature
, SignatureSize
) == 0) {
1028 // Find the signature in database.
1033 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
1041 DataSize
-= CertList
->SignatureListSize
;
1042 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
1054 Calculate the hash of a certificate data with the specified hash algorithm.
1056 @param[in] CertData The certificate data to be hashed.
1057 @param[in] CertSize The certificate size in bytes.
1058 @param[in] HashAlg The specified hash algorithm.
1059 @param[out] CertHash The output digest of the certificate
1061 @retval TRUE Successfully got the hash of the CertData.
1062 @retval FALSE Failed to get the hash of CertData.
1082 if (HashAlg
>= HASHALG_MAX
) {
1087 // Retrieve the TBSCertificate for Hash Calculation.
1089 if (!X509GetTBSCert (CertData
, CertSize
, &TBSCert
, &TBSCertSize
)) {
1094 // 1. Initialize context of hash.
1096 CtxSize
= mHash
[HashAlg
].GetContextSize ();
1097 HashCtx
= AllocatePool (CtxSize
);
1098 ASSERT (HashCtx
!= NULL
);
1101 // 2. Initialize a hash context.
1103 Status
= mHash
[HashAlg
].HashInit (HashCtx
);
1109 // 3. Calculate the hash.
1111 Status
= mHash
[HashAlg
].HashUpdate (HashCtx
, TBSCert
, TBSCertSize
);
1117 // 4. Get the hash result.
1119 ZeroMem (CertHash
, mHash
[HashAlg
].DigestLength
);
1120 Status
= mHash
[HashAlg
].HashFinal (HashCtx
, CertHash
);
1123 if (HashCtx
!= NULL
) {
1131 Check whether the hash of an X.509 certificate is in forbidden database (DBX).
1133 @param[in] Certificate Pointer to X.509 Certificate that is searched for.
1134 @param[in] CertSize Size of X.509 Certificate.
1136 @return TRUE Found the certificate hash in the forbidden database.
1137 @return FALSE Certificate hash is Not found in the forbidden database.
1141 IsCertHashFoundInDbx (
1142 IN UINT8
*Certificate
,
1148 EFI_SIGNATURE_LIST
*DbxList
;
1149 EFI_SIGNATURE_DATA
*CertHash
;
1150 UINTN CertHashCount
;
1153 UINT8 CertDigest
[MAX_DIGEST_SIZE
];
1155 UINTN SiglistHeaderSize
;
1160 HashAlg
= HASHALG_MAX
;
1164 // Read signature database variable.
1167 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1168 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
1172 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1177 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1178 if (EFI_ERROR (Status
)) {
1183 // Check whether the certificate hash exists in the forbidden database.
1185 DbxList
= (EFI_SIGNATURE_LIST
*) Data
;
1186 while ((DataSize
> 0) && (DataSize
>= DbxList
->SignatureListSize
)) {
1188 // Determine Hash Algorithm of Certificate in the forbidden database.
1190 if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
1191 HashAlg
= HASHALG_SHA256
;
1192 } else if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
1193 HashAlg
= HASHALG_SHA384
;
1194 } else if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
1195 HashAlg
= HASHALG_SHA512
;
1197 DataSize
-= DbxList
->SignatureListSize
;
1198 DbxList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) DbxList
+ DbxList
->SignatureListSize
);
1203 // Calculate the hash value of current db certificate for comparision.
1205 if (!CalculateCertHash (Certificate
, CertSize
, HashAlg
, CertDigest
)) {
1209 SiglistHeaderSize
= sizeof (EFI_SIGNATURE_LIST
) + DbxList
->SignatureHeaderSize
;
1210 CertHash
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) DbxList
+ SiglistHeaderSize
);
1211 CertHashCount
= (DbxList
->SignatureListSize
- SiglistHeaderSize
) / DbxList
->SignatureSize
;
1212 for (Index
= 0; Index
< CertHashCount
; Index
++) {
1214 // Iterate each Signature Data Node within this CertList for verify.
1216 DbxCertHash
= CertHash
->SignatureData
;
1217 if (CompareMem (DbxCertHash
, CertDigest
, mHash
[HashAlg
].DigestLength
) == 0) {
1219 // Hash of Certificate is found in forbidden database.
1224 CertHash
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertHash
+ DbxList
->SignatureSize
);
1227 DataSize
-= DbxList
->SignatureListSize
;
1228 DbxList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) DbxList
+ DbxList
->SignatureListSize
);
1240 Check whether the signature list exists in given variable data.
1242 It searches the signature list for the ceritificate hash by CertType.
1243 If the signature list is found, get the offset of Database for the
1244 next hash of a certificate.
1246 @param[in] Database Variable data to save signature list.
1247 @param[in] DatabaseSize Variable size.
1248 @param[in] SignatureType The type of the signature.
1249 @param[out] Offset The offset to save a new hash of certificate.
1251 @return TRUE The signature list is found in the forbidden database.
1252 @return FALSE The signature list is not found in the forbidden database.
1255 GetSignaturelistOffset (
1256 IN EFI_SIGNATURE_LIST
*Database
,
1257 IN UINTN DatabaseSize
,
1258 IN EFI_GUID
*SignatureType
,
1262 EFI_SIGNATURE_LIST
*SigList
;
1265 if ((Database
== NULL
) || (DatabaseSize
== 0)) {
1271 SiglistSize
= DatabaseSize
;
1272 while ((SiglistSize
> 0) && (SiglistSize
>= SigList
->SignatureListSize
)) {
1273 if (CompareGuid (&SigList
->SignatureType
, SignatureType
)) {
1274 *Offset
= DatabaseSize
- SiglistSize
;
1277 SiglistSize
-= SigList
->SignatureListSize
;
1278 SigList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) SigList
+ SigList
->SignatureListSize
);
1285 Enroll a new X509 certificate hash into Signature Database (dbx) without
1286 KEK's authentication.
1288 @param[in] PrivateData The module's private data.
1289 @param[in] HashAlg The hash algorithm to enroll the certificate.
1290 @param[in] RevocationDate The revocation date of the certificate.
1291 @param[in] RevocationTime The revocation time of the certificate.
1292 @param[in] AlwaysRevocation Indicate whether the certificate is always revoked.
1294 @retval EFI_SUCCESS New X509 is enrolled successfully.
1295 @retval EFI_INVALID_PARAMETER The parameter is invalid.
1296 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
1300 EnrollX509HashtoSigDB (
1301 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
1303 IN EFI_HII_DATE
*RevocationDate
,
1304 IN EFI_HII_TIME
*RevocationTime
,
1305 IN BOOLEAN AlwaysRevocation
1311 EFI_SIGNATURE_LIST
*SignatureList
;
1312 UINTN SignatureListSize
;
1318 EFI_SIGNATURE_DATA
*SignatureData
;
1319 UINTN SignatureSize
;
1320 EFI_GUID SignatureType
;
1322 UINT8 CertHash
[MAX_DIGEST_SIZE
];
1323 UINT16
* FilePostFix
;
1330 SignatureData
= NULL
;
1331 SignatureList
= NULL
;
1335 if ((Private
->FileContext
->FileName
== NULL
) || (Private
->FileContext
->FHandle
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
1336 return EFI_INVALID_PARAMETER
;
1339 Status
= SetSecureBootMode (CUSTOM_SECURE_BOOT_MODE
);
1340 if (EFI_ERROR (Status
)) {
1345 // Parse the file's postfix.
1347 NameLength
= StrLen (Private
->FileContext
->FileName
);
1348 if (NameLength
<= 4) {
1349 return EFI_INVALID_PARAMETER
;
1351 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
1352 if (!IsDerEncodeCertificate(FilePostFix
)) {
1354 // Only supports DER-encoded X509 certificate.
1356 return EFI_INVALID_PARAMETER
;
1360 // Get the certificate from file and calculate its hash.
1362 Status
= ReadFileContent (
1363 Private
->FileContext
->FHandle
,
1368 if (EFI_ERROR (Status
)) {
1371 ASSERT (X509Data
!= NULL
);
1373 if (!CalculateCertHash (X509Data
, X509DataSize
, HashAlg
, CertHash
)) {
1378 // Get the variable for enrollment.
1381 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1382 if (Status
== EFI_BUFFER_TOO_SMALL
) {
1383 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1385 return EFI_OUT_OF_RESOURCES
;
1388 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1389 if (EFI_ERROR (Status
)) {
1395 // Allocate memory for Signature and fill the Signature
1397 SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + sizeof (EFI_TIME
) + mHash
[HashAlg
].DigestLength
;
1398 SignatureData
= (EFI_SIGNATURE_DATA
*) AllocateZeroPool (SignatureSize
);
1399 if (SignatureData
== NULL
) {
1400 return EFI_OUT_OF_RESOURCES
;
1402 CopyGuid (&SignatureData
->SignatureOwner
, Private
->SignatureGUID
);
1403 CopyMem (SignatureData
->SignatureData
, CertHash
, mHash
[HashAlg
].DigestLength
);
1408 if (!AlwaysRevocation
) {
1409 Time
= (EFI_TIME
*)(&SignatureData
->SignatureData
+ mHash
[HashAlg
].DigestLength
);
1410 Time
->Year
= RevocationDate
->Year
;
1411 Time
->Month
= RevocationDate
->Month
;
1412 Time
->Day
= RevocationDate
->Day
;
1413 Time
->Hour
= RevocationTime
->Hour
;
1414 Time
->Minute
= RevocationTime
->Minute
;
1415 Time
->Second
= RevocationTime
->Second
;
1419 // Determine the GUID for certificate hash.
1422 case HASHALG_SHA256
:
1423 SignatureType
= gEfiCertX509Sha256Guid
;
1425 case HASHALG_SHA384
:
1426 SignatureType
= gEfiCertX509Sha384Guid
;
1428 case HASHALG_SHA512
:
1429 SignatureType
= gEfiCertX509Sha512Guid
;
1436 // Add signature into the new variable data buffer
1438 if (GetSignaturelistOffset((EFI_SIGNATURE_LIST
*)Data
, DataSize
, &SignatureType
, &Offset
)) {
1440 // Add the signature to the found signaturelist.
1442 DbSize
= DataSize
+ SignatureSize
;
1443 NewData
= AllocateZeroPool (DbSize
);
1444 if (NewData
== NULL
) {
1445 Status
= EFI_OUT_OF_RESOURCES
;
1449 SignatureList
= (EFI_SIGNATURE_LIST
*)(Data
+ Offset
);
1450 SignatureListSize
= (UINTN
) ReadUnaligned32 ((UINT32
*)&SignatureList
->SignatureListSize
);
1451 CopyMem (NewData
, Data
, Offset
+ SignatureListSize
);
1453 SignatureList
= (EFI_SIGNATURE_LIST
*)(NewData
+ Offset
);
1454 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureListSize
, (UINT32
)(SignatureListSize
+ SignatureSize
));
1456 Offset
+= SignatureListSize
;
1457 CopyMem (NewData
+ Offset
, SignatureData
, SignatureSize
);
1458 CopyMem (NewData
+ Offset
+ SignatureSize
, Data
+ Offset
, DataSize
- Offset
);
1465 // Create a new signaturelist, and add the signature into the signaturelist.
1467 DbSize
= DataSize
+ sizeof(EFI_SIGNATURE_LIST
) + SignatureSize
;
1468 NewData
= AllocateZeroPool (DbSize
);
1469 if (NewData
== NULL
) {
1470 Status
= EFI_OUT_OF_RESOURCES
;
1474 // Fill Certificate Database parameters.
1476 SignatureList
= (EFI_SIGNATURE_LIST
*) (NewData
+ DataSize
);
1477 SignatureListSize
= sizeof(EFI_SIGNATURE_LIST
) + SignatureSize
;
1478 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureListSize
, (UINT32
) SignatureListSize
);
1479 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureSize
, (UINT32
) SignatureSize
);
1480 CopyGuid (&SignatureList
->SignatureType
, &SignatureType
);
1481 CopyMem ((UINT8
* ) SignatureList
+ sizeof (EFI_SIGNATURE_LIST
), SignatureData
, SignatureSize
);
1482 if ((DataSize
!= 0) && (Data
!= NULL
)) {
1483 CopyMem (NewData
, Data
, DataSize
);
1490 Status
= CreateTimeBasedPayload (&DataSize
, (UINT8
**) &Data
);
1491 if (EFI_ERROR (Status
)) {
1495 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
1496 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
1497 Status
= gRT
->SetVariable(
1498 EFI_IMAGE_SECURITY_DATABASE1
,
1499 &gEfiImageSecurityDatabaseGuid
,
1504 if (EFI_ERROR (Status
)) {
1509 CloseFile (Private
->FileContext
->FHandle
);
1510 Private
->FileContext
->FileName
= NULL
;
1511 Private
->FileContext
->FHandle
= NULL
;
1513 if (Private
->SignatureGUID
!= NULL
) {
1514 FreePool (Private
->SignatureGUID
);
1515 Private
->SignatureGUID
= NULL
;
1522 if (SignatureData
!= NULL
) {
1523 FreePool (SignatureData
);
1526 if (X509Data
!= NULL
) {
1527 FreePool (X509Data
);
1534 Check whether a certificate from a file exists in dbx.
1536 @param[in] PrivateData The module's private data.
1537 @param[in] VariableName Variable name of signature database, must be
1538 EFI_IMAGE_SECURITY_DATABASE1.
1540 @retval TRUE The X509 certificate is found in dbx successfully.
1541 @retval FALSE The X509 certificate is not found in dbx.
1545 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
1546 IN CHAR16
*VariableName
1555 // Read the certificate from file
1559 Status
= ReadFileContent (
1560 Private
->FileContext
->FHandle
,
1565 if (EFI_ERROR (Status
)) {
1570 // Check the raw certificate.
1573 if (IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE1
, X509Data
, X509DataSize
)) {
1579 // Check the hash of certificate.
1581 if (IsCertHashFoundInDbx (X509Data
, X509DataSize
)) {
1587 if (X509Data
!= NULL
) {
1588 FreePool (X509Data
);
1595 Load PE/COFF image information into internal buffer and check its validity.
1597 @retval EFI_SUCCESS Successful
1598 @retval EFI_UNSUPPORTED Invalid PE/COFF file
1599 @retval EFI_ABORTED Serious error occurs, like file I/O error etc.
1607 EFI_IMAGE_DOS_HEADER
*DosHdr
;
1608 EFI_IMAGE_NT_HEADERS32
*NtHeader32
;
1609 EFI_IMAGE_NT_HEADERS64
*NtHeader64
;
1614 // Read the Dos header
1616 DosHdr
= (EFI_IMAGE_DOS_HEADER
*)(mImageBase
);
1617 if (DosHdr
->e_magic
== EFI_IMAGE_DOS_SIGNATURE
)
1620 // DOS image header is present,
1621 // So read the PE header after the DOS image header
1623 mPeCoffHeaderOffset
= DosHdr
->e_lfanew
;
1627 mPeCoffHeaderOffset
= 0;
1631 // Read PE header and check the signature validity and machine compatibility
1633 NtHeader32
= (EFI_IMAGE_NT_HEADERS32
*) (mImageBase
+ mPeCoffHeaderOffset
);
1634 if (NtHeader32
->Signature
!= EFI_IMAGE_NT_SIGNATURE
)
1636 return EFI_UNSUPPORTED
;
1639 mNtHeader
.Pe32
= NtHeader32
;
1642 // Check the architecture field of PE header and get the Certificate Data Directory data
1643 // Note the size of FileHeader field is constant for both IA32 and X64 arch
1645 if ((NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_IA32
)
1646 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_EBC
)
1647 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_ARMTHUMB_MIXED
)) {
1649 // 32-bits Architecture
1651 mImageType
= ImageType_IA32
;
1652 mSecDataDir
= (EFI_IMAGE_SECURITY_DATA_DIRECTORY
*) &(NtHeader32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]);
1654 else if ((NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_IA64
)
1655 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_X64
)
1656 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_AARCH64
)) {
1658 // 64-bits Architecture
1660 mImageType
= ImageType_X64
;
1661 NtHeader64
= (EFI_IMAGE_NT_HEADERS64
*) (mImageBase
+ mPeCoffHeaderOffset
);
1662 mSecDataDir
= (EFI_IMAGE_SECURITY_DATA_DIRECTORY
*) &(NtHeader64
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]);
1664 return EFI_UNSUPPORTED
;
1671 Calculate hash of Pe/Coff image based on the authenticode image hashing in
1672 PE/COFF Specification 8.0 Appendix A
1674 @param[in] HashAlg Hash algorithm type.
1676 @retval TRUE Successfully hash image.
1677 @retval FALSE Fail in hash image.
1687 EFI_IMAGE_SECTION_HEADER
*Section
;
1692 UINTN SumOfBytesHashed
;
1693 EFI_IMAGE_SECTION_HEADER
*SectionHeader
;
1698 SectionHeader
= NULL
;
1701 if ((HashAlg
!= HASHALG_SHA1
) && (HashAlg
!= HASHALG_SHA256
)) {
1706 // Initialize context of hash.
1708 ZeroMem (mImageDigest
, MAX_DIGEST_SIZE
);
1710 if (HashAlg
== HASHALG_SHA1
) {
1711 mImageDigestSize
= SHA1_DIGEST_SIZE
;
1712 mCertType
= gEfiCertSha1Guid
;
1713 } else if (HashAlg
== HASHALG_SHA256
) {
1714 mImageDigestSize
= SHA256_DIGEST_SIZE
;
1715 mCertType
= gEfiCertSha256Guid
;
1718 CtxSize
= mHash
[HashAlg
].GetContextSize();
1720 HashCtx
= AllocatePool (CtxSize
);
1721 ASSERT (HashCtx
!= NULL
);
1723 // 1. Load the image header into memory.
1725 // 2. Initialize a SHA hash context.
1726 Status
= mHash
[HashAlg
].HashInit(HashCtx
);
1731 // Measuring PE/COFF Image Header;
1732 // But CheckSum field and SECURITY data directory (certificate) are excluded
1734 if (mNtHeader
.Pe32
->FileHeader
.Machine
== IMAGE_FILE_MACHINE_IA64
&& mNtHeader
.Pe32
->OptionalHeader
.Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1736 // NOTE: Some versions of Linux ELILO for Itanium have an incorrect magic value
1737 // in the PE/COFF Header. If the MachineType is Itanium(IA64) and the
1738 // Magic value in the OptionalHeader is EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
1739 // then override the magic value to EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
1741 Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
1744 // Get the magic value from the PE/COFF Optional Header
1746 Magic
= mNtHeader
.Pe32
->OptionalHeader
.Magic
;
1750 // 3. Calculate the distance from the base of the image header to the image checksum address.
1751 // 4. Hash the image header from its base to beginning of the image checksum.
1753 HashBase
= mImageBase
;
1754 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1758 HashSize
= (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32
->OptionalHeader
.CheckSum
) - HashBase
);
1761 // Use PE32+ offset.
1763 HashSize
= (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32Plus
->OptionalHeader
.CheckSum
) - HashBase
);
1766 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1771 // 5. Skip over the image checksum (it occupies a single ULONG).
1772 // 6. Get the address of the beginning of the Cert Directory.
1773 // 7. Hash everything from the end of the checksum to the start of the Cert Directory.
1775 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1779 HashBase
= (UINT8
*) &mNtHeader
.Pe32
->OptionalHeader
.CheckSum
+ sizeof (UINT32
);
1780 HashSize
= (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]) - HashBase
);
1783 // Use PE32+ offset.
1785 HashBase
= (UINT8
*) &mNtHeader
.Pe32Plus
->OptionalHeader
.CheckSum
+ sizeof (UINT32
);
1786 HashSize
= (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]) - HashBase
);
1789 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1794 // 8. Skip over the Cert Directory. (It is sizeof(IMAGE_DATA_DIRECTORY) bytes.)
1795 // 9. Hash everything from the end of the Cert Directory to the end of image header.
1797 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1801 HashBase
= (UINT8
*) &mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1];
1802 HashSize
= mNtHeader
.Pe32
->OptionalHeader
.SizeOfHeaders
- (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1]) - mImageBase
);
1805 // Use PE32+ offset.
1807 HashBase
= (UINT8
*) &mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1];
1808 HashSize
= mNtHeader
.Pe32Plus
->OptionalHeader
.SizeOfHeaders
- (UINTN
) ((UINT8
*) (&mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1]) - mImageBase
);
1811 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1816 // 10. Set the SUM_OF_BYTES_HASHED to the size of the header.
1818 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1822 SumOfBytesHashed
= mNtHeader
.Pe32
->OptionalHeader
.SizeOfHeaders
;
1827 SumOfBytesHashed
= mNtHeader
.Pe32Plus
->OptionalHeader
.SizeOfHeaders
;
1831 // 11. Build a temporary table of pointers to all the IMAGE_SECTION_HEADER
1832 // structures in the image. The 'NumberOfSections' field of the image
1833 // header indicates how big the table should be. Do not include any
1834 // IMAGE_SECTION_HEADERs in the table whose 'SizeOfRawData' field is zero.
1836 SectionHeader
= (EFI_IMAGE_SECTION_HEADER
*) AllocateZeroPool (sizeof (EFI_IMAGE_SECTION_HEADER
) * mNtHeader
.Pe32
->FileHeader
.NumberOfSections
);
1837 ASSERT (SectionHeader
!= NULL
);
1839 // 12. Using the 'PointerToRawData' in the referenced section headers as
1840 // a key, arrange the elements in the table in ascending order. In other
1841 // words, sort the section headers according to the disk-file offset of
1844 Section
= (EFI_IMAGE_SECTION_HEADER
*) (
1846 mPeCoffHeaderOffset
+
1848 sizeof (EFI_IMAGE_FILE_HEADER
) +
1849 mNtHeader
.Pe32
->FileHeader
.SizeOfOptionalHeader
1851 for (Index
= 0; Index
< mNtHeader
.Pe32
->FileHeader
.NumberOfSections
; Index
++) {
1853 while ((Pos
> 0) && (Section
->PointerToRawData
< SectionHeader
[Pos
- 1].PointerToRawData
)) {
1854 CopyMem (&SectionHeader
[Pos
], &SectionHeader
[Pos
- 1], sizeof (EFI_IMAGE_SECTION_HEADER
));
1857 CopyMem (&SectionHeader
[Pos
], Section
, sizeof (EFI_IMAGE_SECTION_HEADER
));
1862 // 13. Walk through the sorted table, bring the corresponding section
1863 // into memory, and hash the entire section (using the 'SizeOfRawData'
1864 // field in the section header to determine the amount of data to hash).
1865 // 14. Add the section's 'SizeOfRawData' to SUM_OF_BYTES_HASHED .
1866 // 15. Repeat steps 13 and 14 for all the sections in the sorted table.
1868 for (Index
= 0; Index
< mNtHeader
.Pe32
->FileHeader
.NumberOfSections
; Index
++) {
1869 Section
= &SectionHeader
[Index
];
1870 if (Section
->SizeOfRawData
== 0) {
1873 HashBase
= mImageBase
+ Section
->PointerToRawData
;
1874 HashSize
= (UINTN
) Section
->SizeOfRawData
;
1876 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1881 SumOfBytesHashed
+= HashSize
;
1885 // 16. If the file size is greater than SUM_OF_BYTES_HASHED, there is extra
1886 // data in the file that needs to be added to the hash. This data begins
1887 // at file offset SUM_OF_BYTES_HASHED and its length is:
1888 // FileSize - (CertDirectory->Size)
1890 if (mImageSize
> SumOfBytesHashed
) {
1891 HashBase
= mImageBase
+ SumOfBytesHashed
;
1892 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1898 mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
].Size
-
1902 // Use PE32+ offset.
1906 mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
].Size
-
1910 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1916 Status
= mHash
[HashAlg
].HashFinal(HashCtx
, mImageDigest
);
1919 if (HashCtx
!= NULL
) {
1922 if (SectionHeader
!= NULL
) {
1923 FreePool (SectionHeader
);
1929 Recognize the Hash algorithm in PE/COFF Authenticode and calculate hash of
1930 Pe/Coff image based on the authenticated image hashing in PE/COFF Specification
1933 @retval EFI_UNSUPPORTED Hash algorithm is not supported.
1934 @retval EFI_SUCCESS Hash successfully.
1943 WIN_CERTIFICATE_EFI_PKCS
*PkcsCertData
;
1945 PkcsCertData
= (WIN_CERTIFICATE_EFI_PKCS
*) (mImageBase
+ mSecDataDir
->Offset
);
1947 for (Index
= 0; Index
< HASHALG_MAX
; Index
++) {
1949 // Check the Hash algorithm in PE/COFF Authenticode.
1950 // According to PKCS#7 Definition:
1951 // SignedData ::= SEQUENCE {
1953 // digestAlgorithms DigestAlgorithmIdentifiers,
1954 // contentInfo ContentInfo,
1956 // The DigestAlgorithmIdentifiers can be used to determine the hash algorithm in PE/COFF hashing
1957 // This field has the fixed offset (+32) in final Authenticode ASN.1 data.
1958 // Fixed offset (+32) is calculated based on two bytes of length encoding.
1960 if ((*(PkcsCertData
->CertData
+ 1) & TWO_BYTE_ENCODE
) != TWO_BYTE_ENCODE
) {
1962 // Only support two bytes of Long Form of Length Encoding.
1968 if (CompareMem (PkcsCertData
->CertData
+ 32, mHash
[Index
].OidValue
, mHash
[Index
].OidLength
) == 0) {
1973 if (Index
== HASHALG_MAX
) {
1974 return EFI_UNSUPPORTED
;
1978 // HASH PE Image based on Hash algorithm in PE/COFF Authenticode.
1980 if (!HashPeImage(Index
)) {
1981 return EFI_UNSUPPORTED
;
1988 Enroll a new executable's signature into Signature Database.
1990 @param[in] PrivateData The module's private data.
1991 @param[in] VariableName Variable name of signature database, must be
1992 EFI_IMAGE_SECURITY_DATABASE, EFI_IMAGE_SECURITY_DATABASE1
1993 or EFI_IMAGE_SECURITY_DATABASE2.
1995 @retval EFI_SUCCESS New signature is enrolled successfully.
1996 @retval EFI_INVALID_PARAMETER The parameter is invalid.
1997 @retval EFI_UNSUPPORTED Unsupported command.
1998 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2002 EnrollImageSignatureToSigDB (
2003 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
2004 IN CHAR16
*VariableName
2008 EFI_SIGNATURE_LIST
*SigDBCert
;
2009 EFI_SIGNATURE_DATA
*SigDBCertData
;
2014 WIN_CERTIFICATE_UEFI_GUID
*GuidCertData
;
2017 GuidCertData
= NULL
;
2019 if (StrCmp (VariableName
, EFI_IMAGE_SECURITY_DATABASE2
) == 0) {
2020 return EFI_UNSUPPORTED
;
2024 // Form the SigDB certificate list.
2025 // Format the data item into EFI_SIGNATURE_LIST type.
2027 // We need to parse executable's signature data from specified signed executable file.
2028 // In current implementation, we simply trust the pass-in signed executable file.
2029 // In reality, it's OS's responsibility to verify the signed executable file.
2033 // Read the whole file content
2035 Status
= ReadFileContent(
2036 Private
->FileContext
->FHandle
,
2037 (VOID
**) &mImageBase
,
2041 if (EFI_ERROR (Status
)) {
2044 ASSERT (mImageBase
!= NULL
);
2046 Status
= LoadPeImage ();
2047 if (EFI_ERROR (Status
)) {
2051 if (mSecDataDir
->SizeOfCert
== 0) {
2052 if (!HashPeImage (HASHALG_SHA256
)) {
2053 Status
= EFI_SECURITY_VIOLATION
;
2059 // Read the certificate data
2061 mCertificate
= (WIN_CERTIFICATE
*)(mImageBase
+ mSecDataDir
->Offset
);
2063 if (mCertificate
->wCertificateType
== WIN_CERT_TYPE_EFI_GUID
) {
2064 GuidCertData
= (WIN_CERTIFICATE_UEFI_GUID
*) mCertificate
;
2065 if (CompareMem (&GuidCertData
->CertType
, &gEfiCertTypeRsa2048Sha256Guid
, sizeof(EFI_GUID
)) != 0) {
2066 Status
= EFI_ABORTED
;
2070 if (!HashPeImage (HASHALG_SHA256
)) {
2071 Status
= EFI_ABORTED
;
2075 } else if (mCertificate
->wCertificateType
== WIN_CERT_TYPE_PKCS_SIGNED_DATA
) {
2077 Status
= HashPeImageByType ();
2078 if (EFI_ERROR (Status
)) {
2082 Status
= EFI_ABORTED
;
2088 // Create a new SigDB entry.
2090 SigDBSize
= sizeof(EFI_SIGNATURE_LIST
)
2091 + sizeof(EFI_SIGNATURE_DATA
) - 1
2092 + (UINT32
) mImageDigestSize
;
2094 Data
= (UINT8
*) AllocateZeroPool (SigDBSize
);
2096 Status
= EFI_OUT_OF_RESOURCES
;
2101 // Adjust the Certificate Database parameters.
2103 SigDBCert
= (EFI_SIGNATURE_LIST
*) Data
;
2104 SigDBCert
->SignatureListSize
= (UINT32
) SigDBSize
;
2105 SigDBCert
->SignatureHeaderSize
= 0;
2106 SigDBCert
->SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + (UINT32
) mImageDigestSize
;
2107 CopyGuid (&SigDBCert
->SignatureType
, &mCertType
);
2109 SigDBCertData
= (EFI_SIGNATURE_DATA
*)((UINT8
*)SigDBCert
+ sizeof(EFI_SIGNATURE_LIST
));
2110 CopyGuid (&SigDBCertData
->SignatureOwner
, Private
->SignatureGUID
);
2111 CopyMem (SigDBCertData
->SignatureData
, mImageDigest
, mImageDigestSize
);
2113 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
2114 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
2115 Status
= CreateTimeBasedPayload (&SigDBSize
, (UINT8
**) &Data
);
2116 if (EFI_ERROR (Status
)) {
2117 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
2122 // Check if SigDB variable has been already existed.
2123 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
2124 // new signature data to original variable
2127 Status
= gRT
->GetVariable(
2129 &gEfiImageSecurityDatabaseGuid
,
2134 if (Status
== EFI_BUFFER_TOO_SMALL
) {
2135 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
2136 } else if (Status
!= EFI_NOT_FOUND
) {
2141 // Enroll the variable.
2143 Status
= gRT
->SetVariable(
2145 &gEfiImageSecurityDatabaseGuid
,
2150 if (EFI_ERROR (Status
)) {
2156 CloseFile (Private
->FileContext
->FHandle
);
2157 Private
->FileContext
->FHandle
= NULL
;
2158 Private
->FileContext
->FileName
= NULL
;
2160 if (Private
->SignatureGUID
!= NULL
) {
2161 FreePool (Private
->SignatureGUID
);
2162 Private
->SignatureGUID
= NULL
;
2169 if (mImageBase
!= NULL
) {
2170 FreePool (mImageBase
);
2178 Enroll signature into DB/DBX/DBT without KEK's authentication.
2179 The SignatureOwner GUID will be Private->SignatureGUID.
2181 @param[in] PrivateData The module's private data.
2182 @param[in] VariableName Variable name of signature database, must be
2183 EFI_IMAGE_SECURITY_DATABASE or EFI_IMAGE_SECURITY_DATABASE1.
2185 @retval EFI_SUCCESS New signature enrolled successfully.
2186 @retval EFI_INVALID_PARAMETER The parameter is invalid.
2187 @retval others Fail to enroll signature data.
2191 EnrollSignatureDatabase (
2192 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
2193 IN CHAR16
*VariableName
2196 UINT16
* FilePostFix
;
2200 if ((Private
->FileContext
->FileName
== NULL
) || (Private
->FileContext
->FHandle
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
2201 return EFI_INVALID_PARAMETER
;
2204 Status
= SetSecureBootMode (CUSTOM_SECURE_BOOT_MODE
);
2205 if (EFI_ERROR (Status
)) {
2210 // Parse the file's postfix.
2212 NameLength
= StrLen (Private
->FileContext
->FileName
);
2213 if (NameLength
<= 4) {
2214 return EFI_INVALID_PARAMETER
;
2216 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
2217 if (IsDerEncodeCertificate (FilePostFix
)) {
2219 // Supports DER-encoded X509 certificate.
2221 return EnrollX509toSigDB (Private
, VariableName
);
2224 return EnrollImageSignatureToSigDB (Private
, VariableName
);
2228 List all signatures in specified signature database (e.g. KEK/DB/DBX/DBT)
2229 by GUID in the page for user to select and delete as needed.
2231 @param[in] PrivateData Module's private data.
2232 @param[in] VariableName The variable name of the vendor's signature database.
2233 @param[in] VendorGuid A unique identifier for the vendor.
2234 @param[in] LabelNumber Label number to insert opcodes.
2235 @param[in] FormId Form ID of current page.
2236 @param[in] QuestionIdBase Base question id of the signature list.
2238 @retval EFI_SUCCESS Success to update the signature list page
2239 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
2244 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2245 IN CHAR16
*VariableName
,
2246 IN EFI_GUID
*VendorGuid
,
2247 IN UINT16 LabelNumber
,
2248 IN EFI_FORM_ID FormId
,
2249 IN EFI_QUESTION_ID QuestionIdBase
2256 VOID
*StartOpCodeHandle
;
2257 VOID
*EndOpCodeHandle
;
2258 EFI_IFR_GUID_LABEL
*StartLabel
;
2259 EFI_IFR_GUID_LABEL
*EndLabel
;
2262 EFI_SIGNATURE_LIST
*CertList
;
2263 EFI_SIGNATURE_DATA
*Cert
;
2264 UINT32 ItemDataSize
;
2266 EFI_STRING_ID GuidID
;
2273 StartOpCodeHandle
= NULL
;
2274 EndOpCodeHandle
= NULL
;
2277 // Initialize the container for dynamic opcodes.
2279 StartOpCodeHandle
= HiiAllocateOpCodeHandle ();
2280 if (StartOpCodeHandle
== NULL
) {
2281 Status
= EFI_OUT_OF_RESOURCES
;
2285 EndOpCodeHandle
= HiiAllocateOpCodeHandle ();
2286 if (EndOpCodeHandle
== NULL
) {
2287 Status
= EFI_OUT_OF_RESOURCES
;
2292 // Create Hii Extend Label OpCode.
2294 StartLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
2298 sizeof (EFI_IFR_GUID_LABEL
)
2300 StartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
2301 StartLabel
->Number
= LabelNumber
;
2303 EndLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
2307 sizeof (EFI_IFR_GUID_LABEL
)
2309 EndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
2310 EndLabel
->Number
= LABEL_END
;
2316 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, Data
);
2317 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2321 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2323 Status
= EFI_OUT_OF_RESOURCES
;
2327 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, Data
);
2328 if (EFI_ERROR (Status
)) {
2332 GuidStr
= AllocateZeroPool (100);
2333 if (GuidStr
== NULL
) {
2334 Status
= EFI_OUT_OF_RESOURCES
;
2339 // Enumerate all KEK pub data.
2341 ItemDataSize
= (UINT32
) DataSize
;
2342 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
2345 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
2347 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
)) {
2348 Help
= STRING_TOKEN (STR_CERT_TYPE_RSA2048_SHA256_GUID
);
2349 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
)) {
2350 Help
= STRING_TOKEN (STR_CERT_TYPE_PCKS7_GUID
);
2351 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertSha1Guid
)) {
2352 Help
= STRING_TOKEN (STR_CERT_TYPE_SHA1_GUID
);
2353 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertSha256Guid
)) {
2354 Help
= STRING_TOKEN (STR_CERT_TYPE_SHA256_GUID
);
2355 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
2356 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA256_GUID
);
2357 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
2358 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA384_GUID
);
2359 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
2360 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA512_GUID
);
2363 // The signature type is not supported in current implementation.
2365 ItemDataSize
-= CertList
->SignatureListSize
;
2366 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2370 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2371 for (Index
= 0; Index
< CertCount
; Index
++) {
2372 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
2373 + sizeof (EFI_SIGNATURE_LIST
)
2374 + CertList
->SignatureHeaderSize
2375 + Index
* CertList
->SignatureSize
);
2377 // Display GUID and help
2379 GuidToString (&Cert
->SignatureOwner
, GuidStr
, 100);
2380 GuidID
= HiiSetString (PrivateData
->HiiHandle
, 0, GuidStr
, NULL
);
2381 HiiCreateCheckBoxOpCode (
2383 (EFI_QUESTION_ID
) (QuestionIdBase
+ GuidIndex
++),
2388 EFI_IFR_FLAG_CALLBACK
,
2394 ItemDataSize
-= CertList
->SignatureListSize
;
2395 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2400 PrivateData
->HiiHandle
,
2401 &gSecureBootConfigFormSetGuid
,
2407 if (StartOpCodeHandle
!= NULL
) {
2408 HiiFreeOpCodeHandle (StartOpCodeHandle
);
2411 if (EndOpCodeHandle
!= NULL
) {
2412 HiiFreeOpCodeHandle (EndOpCodeHandle
);
2419 if (GuidStr
!= NULL
) {
2427 Delete a KEK entry from KEK database.
2429 @param[in] PrivateData Module's private data.
2430 @param[in] QuestionId Question id of the KEK item to delete.
2432 @retval EFI_SUCCESS Delete kek item successfully.
2433 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2437 DeleteKeyExchangeKey (
2438 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2439 IN EFI_QUESTION_ID QuestionId
2448 EFI_SIGNATURE_LIST
*CertList
;
2449 EFI_SIGNATURE_LIST
*NewCertList
;
2450 EFI_SIGNATURE_DATA
*Cert
;
2453 BOOLEAN IsKEKItemFound
;
2455 UINTN DeleteKekIndex
;
2463 DeleteKekIndex
= QuestionId
- OPTION_DEL_KEK_QUESTION_ID
;
2465 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
2466 if (EFI_ERROR (Status
)) {
2471 // Get original KEK variable.
2474 Status
= gRT
->GetVariable (EFI_KEY_EXCHANGE_KEY_NAME
, &gEfiGlobalVariableGuid
, NULL
, &DataSize
, NULL
);
2475 if (EFI_ERROR(Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2479 OldData
= (UINT8
*)AllocateZeroPool(DataSize
);
2480 if (OldData
== NULL
) {
2481 Status
= EFI_OUT_OF_RESOURCES
;
2485 Status
= gRT
->GetVariable (EFI_KEY_EXCHANGE_KEY_NAME
, &gEfiGlobalVariableGuid
, &Attr
, &DataSize
, OldData
);
2486 if (EFI_ERROR(Status
)) {
2491 // Allocate space for new variable.
2493 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2495 Status
= EFI_OUT_OF_RESOURCES
;
2500 // Enumerate all KEK pub data and erasing the target item.
2502 IsKEKItemFound
= FALSE
;
2503 KekDataSize
= (UINT32
) DataSize
;
2504 CertList
= (EFI_SIGNATURE_LIST
*) OldData
;
2507 while ((KekDataSize
> 0) && (KekDataSize
>= CertList
->SignatureListSize
)) {
2508 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
) ||
2509 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
)) {
2510 CopyMem (Data
+ Offset
, CertList
, (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
));
2511 NewCertList
= (EFI_SIGNATURE_LIST
*)(Data
+ Offset
);
2512 Offset
+= (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2513 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2514 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2515 for (Index
= 0; Index
< CertCount
; Index
++) {
2516 if (GuidIndex
== DeleteKekIndex
) {
2518 // Find it! Skip it!
2520 NewCertList
->SignatureListSize
-= CertList
->SignatureSize
;
2521 IsKEKItemFound
= TRUE
;
2524 // This item doesn't match. Copy it to the Data buffer.
2526 CopyMem (Data
+ Offset
, Cert
, CertList
->SignatureSize
);
2527 Offset
+= CertList
->SignatureSize
;
2530 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
2534 // This List doesn't match. Copy it to the Data buffer.
2536 CopyMem (Data
+ Offset
, CertList
, CertList
->SignatureListSize
);
2537 Offset
+= CertList
->SignatureListSize
;
2540 KekDataSize
-= CertList
->SignatureListSize
;
2541 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2544 if (!IsKEKItemFound
) {
2546 // Doesn't find the Kek Item!
2548 Status
= EFI_NOT_FOUND
;
2553 // Delete the Signature header if there is no signature in the list.
2555 KekDataSize
= Offset
;
2556 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
2558 ZeroMem (OldData
, KekDataSize
);
2559 while ((KekDataSize
> 0) && (KekDataSize
>= CertList
->SignatureListSize
)) {
2560 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2561 DEBUG ((DEBUG_INFO
, " CertCount = %x\n", CertCount
));
2562 if (CertCount
!= 0) {
2563 CopyMem (OldData
+ Offset
, CertList
, CertList
->SignatureListSize
);
2564 Offset
+= CertList
->SignatureListSize
;
2566 KekDataSize
-= CertList
->SignatureListSize
;
2567 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2571 if ((Attr
& EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
) != 0) {
2572 Status
= CreateTimeBasedPayload (&DataSize
, &OldData
);
2573 if (EFI_ERROR (Status
)) {
2574 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
2579 Status
= gRT
->SetVariable(
2580 EFI_KEY_EXCHANGE_KEY_NAME
,
2581 &gEfiGlobalVariableGuid
,
2586 if (EFI_ERROR (Status
)) {
2587 DEBUG ((DEBUG_ERROR
, "Failed to set variable, Status = %r\n", Status
));
2596 if (OldData
!= NULL
) {
2600 return UpdateDeletePage (
2602 EFI_KEY_EXCHANGE_KEY_NAME
,
2603 &gEfiGlobalVariableGuid
,
2605 FORMID_DELETE_KEK_FORM
,
2606 OPTION_DEL_KEK_QUESTION_ID
2611 Delete a signature entry from siganture database.
2613 @param[in] PrivateData Module's private data.
2614 @param[in] VariableName The variable name of the vendor's signature database.
2615 @param[in] VendorGuid A unique identifier for the vendor.
2616 @param[in] LabelNumber Label number to insert opcodes.
2617 @param[in] FormId Form ID of current page.
2618 @param[in] QuestionIdBase Base question id of the signature list.
2619 @param[in] DeleteIndex Signature index to delete.
2621 @retval EFI_SUCCESS Delete siganture successfully.
2622 @retval EFI_NOT_FOUND Can't find the signature item,
2623 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2627 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2628 IN CHAR16
*VariableName
,
2629 IN EFI_GUID
*VendorGuid
,
2630 IN UINT16 LabelNumber
,
2631 IN EFI_FORM_ID FormId
,
2632 IN EFI_QUESTION_ID QuestionIdBase
,
2633 IN UINTN DeleteIndex
2642 EFI_SIGNATURE_LIST
*CertList
;
2643 EFI_SIGNATURE_LIST
*NewCertList
;
2644 EFI_SIGNATURE_DATA
*Cert
;
2647 BOOLEAN IsItemFound
;
2648 UINT32 ItemDataSize
;
2657 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
2658 if (EFI_ERROR (Status
)) {
2663 // Get original signature list data.
2666 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, NULL
);
2667 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2671 OldData
= (UINT8
*) AllocateZeroPool (DataSize
);
2672 if (OldData
== NULL
) {
2673 Status
= EFI_OUT_OF_RESOURCES
;
2677 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, &Attr
, &DataSize
, OldData
);
2678 if (EFI_ERROR(Status
)) {
2683 // Allocate space for new variable.
2685 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2687 Status
= EFI_OUT_OF_RESOURCES
;
2692 // Enumerate all signature data and erasing the target item.
2694 IsItemFound
= FALSE
;
2695 ItemDataSize
= (UINT32
) DataSize
;
2696 CertList
= (EFI_SIGNATURE_LIST
*) OldData
;
2699 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
2700 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
) ||
2701 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
) ||
2702 CompareGuid (&CertList
->SignatureType
, &gEfiCertSha1Guid
) ||
2703 CompareGuid (&CertList
->SignatureType
, &gEfiCertSha256Guid
) ||
2704 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha256Guid
) ||
2705 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha384Guid
) ||
2706 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha512Guid
)
2709 // Copy EFI_SIGNATURE_LIST header then calculate the signature count in this list.
2711 CopyMem (Data
+ Offset
, CertList
, (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
));
2712 NewCertList
= (EFI_SIGNATURE_LIST
*) (Data
+ Offset
);
2713 Offset
+= (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2714 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2715 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2716 for (Index
= 0; Index
< CertCount
; Index
++) {
2717 if (GuidIndex
== DeleteIndex
) {
2719 // Find it! Skip it!
2721 NewCertList
->SignatureListSize
-= CertList
->SignatureSize
;
2725 // This item doesn't match. Copy it to the Data buffer.
2727 CopyMem (Data
+ Offset
, (UINT8
*)(Cert
), CertList
->SignatureSize
);
2728 Offset
+= CertList
->SignatureSize
;
2731 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
2735 // This List doesn't match. Just copy it to the Data buffer.
2737 CopyMem (Data
+ Offset
, (UINT8
*)(CertList
), CertList
->SignatureListSize
);
2738 Offset
+= CertList
->SignatureListSize
;
2741 ItemDataSize
-= CertList
->SignatureListSize
;
2742 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2747 // Doesn't find the signature Item!
2749 Status
= EFI_NOT_FOUND
;
2754 // Delete the EFI_SIGNATURE_LIST header if there is no signature in the list.
2756 ItemDataSize
= Offset
;
2757 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
2759 ZeroMem (OldData
, ItemDataSize
);
2760 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
2761 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2762 DEBUG ((DEBUG_INFO
, " CertCount = %x\n", CertCount
));
2763 if (CertCount
!= 0) {
2764 CopyMem (OldData
+ Offset
, (UINT8
*)(CertList
), CertList
->SignatureListSize
);
2765 Offset
+= CertList
->SignatureListSize
;
2767 ItemDataSize
-= CertList
->SignatureListSize
;
2768 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2772 if ((Attr
& EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
) != 0) {
2773 Status
= CreateTimeBasedPayload (&DataSize
, &OldData
);
2774 if (EFI_ERROR (Status
)) {
2775 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
2780 Status
= gRT
->SetVariable(
2787 if (EFI_ERROR (Status
)) {
2788 DEBUG ((DEBUG_ERROR
, "Failed to set variable, Status = %r\n", Status
));
2797 if (OldData
!= NULL
) {
2801 return UpdateDeletePage (
2812 This function extracts configuration from variable.
2814 @param[in, out] ConfigData Point to SecureBoot configuration private data.
2818 SecureBootExtractConfigFromVariable (
2819 IN OUT SECUREBOOT_CONFIGURATION
*ConfigData
2822 UINT8
*SecureBootEnable
;
2824 UINT8
*SecureBootMode
;
2827 SecureBootEnable
= NULL
;
2829 SecureBootMode
= NULL
;
2832 // Initilize the Date and Time using system time.
2834 ConfigData
->CertificateFormat
= HASHALG_RAW
;
2835 ConfigData
->AlwaysRevocation
= TRUE
;
2836 gRT
->GetTime (&CurrTime
, NULL
);
2837 ConfigData
->RevocationDate
.Year
= CurrTime
.Year
;
2838 ConfigData
->RevocationDate
.Month
= CurrTime
.Month
;
2839 ConfigData
->RevocationDate
.Day
= CurrTime
.Day
;
2840 ConfigData
->RevocationTime
.Hour
= CurrTime
.Hour
;
2841 ConfigData
->RevocationTime
.Minute
= CurrTime
.Minute
;
2842 ConfigData
->RevocationTime
.Second
= 0;
2845 // If the SecureBootEnable Variable doesn't exist, hide the SecureBoot Enable/Disable
2848 ConfigData
->AttemptSecureBoot
= FALSE
;
2849 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
2850 if (SecureBootEnable
== NULL
) {
2851 ConfigData
->HideSecureBoot
= TRUE
;
2853 ConfigData
->HideSecureBoot
= FALSE
;
2854 if ((*SecureBootEnable
) == SECURE_BOOT_ENABLE
) {
2855 ConfigData
->AttemptSecureBoot
= TRUE
;
2860 // If it is Physical Presence User, set the PhysicalPresent to true.
2862 if (UserPhysicalPresent()) {
2863 ConfigData
->PhysicalPresent
= TRUE
;
2865 ConfigData
->PhysicalPresent
= FALSE
;
2869 // If there is no PK then the Delete Pk button will be gray.
2871 GetVariable2 (EFI_SETUP_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SetupMode
, NULL
);
2872 if (SetupMode
== NULL
|| (*SetupMode
) == SETUP_MODE
) {
2873 ConfigData
->HasPk
= FALSE
;
2875 ConfigData
->HasPk
= TRUE
;
2879 // Get the SecureBootMode from CustomMode variable.
2881 GetVariable2 (EFI_CUSTOM_MODE_NAME
, &gEfiCustomModeEnableGuid
, (VOID
**)&SecureBootMode
, NULL
);
2882 if (SecureBootMode
== NULL
) {
2883 ConfigData
->SecureBootMode
= STANDARD_SECURE_BOOT_MODE
;
2885 ConfigData
->SecureBootMode
= *(SecureBootMode
);
2888 if (SecureBootEnable
!= NULL
) {
2889 FreePool (SecureBootEnable
);
2891 if (SetupMode
!= NULL
) {
2892 FreePool (SetupMode
);
2894 if (SecureBootMode
!= NULL
) {
2895 FreePool (SecureBootMode
);
2900 This function allows a caller to extract the current configuration for one
2901 or more named elements from the target driver.
2903 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
2904 @param[in] Request A null-terminated Unicode string in
2905 <ConfigRequest> format.
2906 @param[out] Progress On return, points to a character in the Request
2907 string. Points to the string's null terminator if
2908 request was successful. Points to the most recent
2909 '&' before the first failing name/value pair (or
2910 the beginning of the string if the failure is in
2911 the first name/value pair) if the request was not
2913 @param[out] Results A null-terminated Unicode string in
2914 <ConfigAltResp> format which has all values filled
2915 in for the names in the Request string. String to
2916 be allocated by the called function.
2918 @retval EFI_SUCCESS The Results is filled with the requested values.
2919 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.
2920 @retval EFI_INVALID_PARAMETER Request is illegal syntax, or unknown name.
2921 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this
2927 SecureBootExtractConfig (
2928 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
2929 IN CONST EFI_STRING Request
,
2930 OUT EFI_STRING
*Progress
,
2931 OUT EFI_STRING
*Results
2937 SECUREBOOT_CONFIGURATION Configuration
;
2938 EFI_STRING ConfigRequest
;
2939 EFI_STRING ConfigRequestHdr
;
2940 SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
;
2941 BOOLEAN AllocatedRequest
;
2944 if (Progress
== NULL
|| Results
== NULL
) {
2945 return EFI_INVALID_PARAMETER
;
2948 AllocatedRequest
= FALSE
;
2949 ConfigRequestHdr
= NULL
;
2950 ConfigRequest
= NULL
;
2954 ZeroMem (&Configuration
, sizeof (Configuration
));
2955 PrivateData
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
2956 *Progress
= Request
;
2958 if ((Request
!= NULL
) && !HiiIsConfigHdrMatch (Request
, &gSecureBootConfigFormSetGuid
, mSecureBootStorageName
)) {
2959 return EFI_NOT_FOUND
;
2963 // Get Configuration from Variable.
2965 SecureBootExtractConfigFromVariable (&Configuration
);
2968 // Update current secure boot state.
2970 GetVariable2 (EFI_SECURE_BOOT_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SecureBoot
, NULL
);
2971 if (SecureBoot
!= NULL
&& *SecureBoot
== SECURE_BOOT_MODE_ENABLE
) {
2972 HiiSetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT
), L
"Enabled", NULL
);
2974 HiiSetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT
), L
"Disabled", NULL
);
2976 if (SecureBoot
!= NULL
) {
2977 FreePool (SecureBoot
);
2980 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
2981 ConfigRequest
= Request
;
2982 if ((Request
== NULL
) || (StrStr (Request
, L
"OFFSET") == NULL
)) {
2984 // Request is set to NULL or OFFSET is NULL, construct full request string.
2986 // Allocate and fill a buffer large enough to hold the <ConfigHdr> template
2987 // followed by "&OFFSET=0&WIDTH=WWWWWWWWWWWWWWWW" followed by a Null-terminator
2989 ConfigRequestHdr
= HiiConstructConfigHdr (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, PrivateData
->DriverHandle
);
2990 Size
= (StrLen (ConfigRequestHdr
) + 32 + 1) * sizeof (CHAR16
);
2991 ConfigRequest
= AllocateZeroPool (Size
);
2992 ASSERT (ConfigRequest
!= NULL
);
2993 AllocatedRequest
= TRUE
;
2994 UnicodeSPrint (ConfigRequest
, Size
, L
"%s&OFFSET=0&WIDTH=%016LX", ConfigRequestHdr
, (UINT64
)BufferSize
);
2995 FreePool (ConfigRequestHdr
);
2996 ConfigRequestHdr
= NULL
;
2999 Status
= gHiiConfigRouting
->BlockToConfig (
3002 (UINT8
*) &Configuration
,
3009 // Free the allocated config request string.
3011 if (AllocatedRequest
) {
3012 FreePool (ConfigRequest
);
3016 // Set Progress string to the original request string.
3018 if (Request
== NULL
) {
3020 } else if (StrStr (Request
, L
"OFFSET") == NULL
) {
3021 *Progress
= Request
+ StrLen (Request
);
3028 This function processes the results of changes in configuration.
3030 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
3031 @param[in] Configuration A null-terminated Unicode string in <ConfigResp>
3033 @param[out] Progress A pointer to a string filled in with the offset of
3034 the most recent '&' before the first failing
3035 name/value pair (or the beginning of the string if
3036 the failure is in the first name/value pair) or
3037 the terminating NULL if all was successful.
3039 @retval EFI_SUCCESS The Results is processed successfully.
3040 @retval EFI_INVALID_PARAMETER Configuration is NULL.
3041 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this
3047 SecureBootRouteConfig (
3048 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
3049 IN CONST EFI_STRING Configuration
,
3050 OUT EFI_STRING
*Progress
3053 UINT8
*SecureBootEnable
;
3054 SECUREBOOT_CONFIGURATION IfrNvData
;
3058 if (Configuration
== NULL
|| Progress
== NULL
) {
3059 return EFI_INVALID_PARAMETER
;
3062 *Progress
= Configuration
;
3063 if (!HiiIsConfigHdrMatch (Configuration
, &gSecureBootConfigFormSetGuid
, mSecureBootStorageName
)) {
3064 return EFI_NOT_FOUND
;
3068 // Get Configuration from Variable.
3070 SecureBootExtractConfigFromVariable (&IfrNvData
);
3073 // Map the Configuration to the configuration block.
3075 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
3076 Status
= gHiiConfigRouting
->ConfigToBlock (
3079 (UINT8
*)&IfrNvData
,
3083 if (EFI_ERROR (Status
)) {
3088 // Store Buffer Storage back to EFI variable if needed
3090 SecureBootEnable
= NULL
;
3091 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
3092 if (NULL
!= SecureBootEnable
) {
3093 FreePool (SecureBootEnable
);
3094 Status
= SaveSecureBootVariable (IfrNvData
.AttemptSecureBoot
);
3095 if (EFI_ERROR (Status
)) {
3100 *Progress
= Configuration
+ StrLen (Configuration
);
3105 This function is called to provide results data to the driver.
3107 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
3108 @param[in] Action Specifies the type of action taken by the browser.
3109 @param[in] QuestionId A unique value which is sent to the original
3110 exporting driver so that it can identify the type
3112 @param[in] Type The type of value for the question.
3113 @param[in] Value A pointer to the data being sent to the original
3115 @param[out] ActionRequest On return, points to the action requested by the
3118 @retval EFI_SUCCESS The callback successfully handled the action.
3119 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the
3120 variable and its data.
3121 @retval EFI_DEVICE_ERROR The variable could not be saved.
3122 @retval EFI_UNSUPPORTED The specified Action is not supported by the
3128 SecureBootCallback (
3129 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
3130 IN EFI_BROWSER_ACTION Action
,
3131 IN EFI_QUESTION_ID QuestionId
,
3133 IN EFI_IFR_TYPE_VALUE
*Value
,
3134 OUT EFI_BROWSER_ACTION_REQUEST
*ActionRequest
3139 SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
;
3141 SECUREBOOT_CONFIGURATION
*IfrNvData
;
3143 UINT8
*SecureBootEnable
;
3144 UINT8
*SecureBootMode
;
3146 CHAR16 PromptString
[100];
3148 SecureBootEnable
= NULL
;
3149 SecureBootMode
= NULL
;
3152 if ((This
== NULL
) || (Value
== NULL
) || (ActionRequest
== NULL
)) {
3153 return EFI_INVALID_PARAMETER
;
3156 if (Action
== EFI_BROWSER_ACTION_FORM_OPEN
) {
3157 if (QuestionId
== KEY_SECURE_BOOT_MODE
) {
3158 mIsEnterSecureBootForm
= TRUE
;
3164 if (Action
== EFI_BROWSER_ACTION_RETRIEVE
) {
3165 Status
= EFI_UNSUPPORTED
;
3166 if (QuestionId
== KEY_SECURE_BOOT_MODE
) {
3167 if (mIsEnterSecureBootForm
) {
3168 Value
->u8
= SECURE_BOOT_MODE_STANDARD
;
3169 Status
= EFI_SUCCESS
;
3175 if ((Action
!= EFI_BROWSER_ACTION_CHANGED
) &&
3176 (Action
!= EFI_BROWSER_ACTION_CHANGING
) &&
3177 (Action
!= EFI_BROWSER_ACTION_FORM_CLOSE
) &&
3178 (Action
!= EFI_BROWSER_ACTION_DEFAULT_STANDARD
)) {
3179 return EFI_UNSUPPORTED
;
3182 Private
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
3185 // Retrieve uncommitted data from Browser
3187 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
3188 IfrNvData
= AllocateZeroPool (BufferSize
);
3189 if (IfrNvData
== NULL
) {
3190 return EFI_OUT_OF_RESOURCES
;
3193 Status
= EFI_SUCCESS
;
3195 HiiGetBrowserData (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, BufferSize
, (UINT8
*) IfrNvData
);
3197 if (Action
== EFI_BROWSER_ACTION_CHANGING
) {
3199 switch (QuestionId
) {
3200 case KEY_SECURE_BOOT_ENABLE
:
3201 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
3202 if (NULL
!= SecureBootEnable
) {
3203 FreePool (SecureBootEnable
);
3204 if (EFI_ERROR (SaveSecureBootVariable (Value
->u8
))) {
3206 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3208 L
"Only Physical Presence User could disable secure boot!",
3211 Status
= EFI_UNSUPPORTED
;
3214 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3216 L
"Configuration changed, please reset the platform to take effect!",
3223 case KEY_SECURE_BOOT_OPTION
:
3224 FreeMenu (&DirectoryMenu
);
3225 FreeMenu (&FsOptionMenu
);
3228 case KEY_SECURE_BOOT_KEK_OPTION
:
3229 case KEY_SECURE_BOOT_DB_OPTION
:
3230 case KEY_SECURE_BOOT_DBX_OPTION
:
3231 case KEY_SECURE_BOOT_DBT_OPTION
:
3233 // Clear Signature GUID.
3235 ZeroMem (IfrNvData
->SignatureGuid
, sizeof (IfrNvData
->SignatureGuid
));
3236 if (Private
->SignatureGUID
== NULL
) {
3237 Private
->SignatureGUID
= (EFI_GUID
*) AllocateZeroPool (sizeof (EFI_GUID
));
3238 if (Private
->SignatureGUID
== NULL
) {
3239 return EFI_OUT_OF_RESOURCES
;
3243 if (QuestionId
== KEY_SECURE_BOOT_DB_OPTION
) {
3244 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DB
;
3245 } else if (QuestionId
== KEY_SECURE_BOOT_DBX_OPTION
) {
3246 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DBX
;
3247 } else if (QuestionId
== KEY_SECURE_BOOT_DBT_OPTION
) {
3248 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DBT
;
3250 LabelId
= FORMID_ENROLL_KEK_FORM
;
3254 // Refresh selected file.
3256 CleanUpPage (LabelId
, Private
);
3259 case SECUREBOOT_ADD_PK_FILE_FORM_ID
:
3260 case FORMID_ENROLL_KEK_FORM
:
3261 case SECUREBOOT_ENROLL_SIGNATURE_TO_DB
:
3262 case SECUREBOOT_ENROLL_SIGNATURE_TO_DBX
:
3263 case SECUREBOOT_ENROLL_SIGNATURE_TO_DBT
:
3264 if (QuestionId
== SECUREBOOT_ADD_PK_FILE_FORM_ID
) {
3265 Private
->FeCurrentState
= FileExplorerStateEnrollPkFile
;
3266 } else if (QuestionId
== FORMID_ENROLL_KEK_FORM
) {
3267 Private
->FeCurrentState
= FileExplorerStateEnrollKekFile
;
3268 } else if (QuestionId
== SECUREBOOT_ENROLL_SIGNATURE_TO_DB
) {
3269 Private
->FeCurrentState
= FileExplorerStateEnrollSignatureFileToDb
;
3270 } else if (QuestionId
== SECUREBOOT_ENROLL_SIGNATURE_TO_DBX
) {
3271 Private
->FeCurrentState
= FileExplorerStateEnrollSignatureFileToDbx
;
3272 IfrNvData
->CertificateFormat
= HASHALG_SHA256
;
3274 Private
->FeCurrentState
= FileExplorerStateEnrollSignatureFileToDbt
;
3277 Private
->FeDisplayContext
= FileExplorerDisplayUnknown
;
3278 CleanUpPage (FORM_FILE_EXPLORER_ID
, Private
);
3279 UpdateFileExplorer (Private
, 0);
3282 case KEY_SECURE_BOOT_DELETE_PK
:
3285 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3287 L
"Are you sure you want to delete PK? Secure boot will be disabled!",
3288 L
"Press 'Y' to delete PK and exit, 'N' to discard change and return",
3291 if (Key
.UnicodeChar
== 'y' || Key
.UnicodeChar
== 'Y') {
3292 Status
= DeletePlatformKey ();
3293 if (EFI_ERROR (Status
)) {
3295 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3297 L
"Only Physical Presence User could delete PK in custom mode!",
3305 case KEY_DELETE_KEK
:
3308 EFI_KEY_EXCHANGE_KEY_NAME
,
3309 &gEfiGlobalVariableGuid
,
3311 FORMID_DELETE_KEK_FORM
,
3312 OPTION_DEL_KEK_QUESTION_ID
3316 case SECUREBOOT_DELETE_SIGNATURE_FROM_DB
:
3319 EFI_IMAGE_SECURITY_DATABASE
,
3320 &gEfiImageSecurityDatabaseGuid
,
3322 SECUREBOOT_DELETE_SIGNATURE_FROM_DB
,
3323 OPTION_DEL_DB_QUESTION_ID
3327 case SECUREBOOT_DELETE_SIGNATURE_FROM_DBX
:
3330 EFI_IMAGE_SECURITY_DATABASE1
,
3331 &gEfiImageSecurityDatabaseGuid
,
3333 SECUREBOOT_DELETE_SIGNATURE_FROM_DBX
,
3334 OPTION_DEL_DBX_QUESTION_ID
3339 case SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
:
3342 EFI_IMAGE_SECURITY_DATABASE2
,
3343 &gEfiImageSecurityDatabaseGuid
,
3345 SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
,
3346 OPTION_DEL_DBT_QUESTION_ID
3351 case KEY_VALUE_SAVE_AND_EXIT_KEK
:
3352 Status
= EnrollKeyExchangeKey (Private
);
3353 if (EFI_ERROR (Status
)) {
3355 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3357 L
"ERROR: Unsupported file type!",
3358 L
"Only supports DER-encoded X509 certificate",
3364 case KEY_VALUE_SAVE_AND_EXIT_DB
:
3365 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE
);
3366 if (EFI_ERROR (Status
)) {
3368 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3370 L
"ERROR: Unsupported file type!",
3371 L
"Only supports DER-encoded X509 certificate and executable EFI image",
3377 case KEY_VALUE_SAVE_AND_EXIT_DBX
:
3378 if (IsX509CertInDbx (Private
, EFI_IMAGE_SECURITY_DATABASE1
)) {
3380 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3382 L
"Enrollment failed! Same certificate had already been in the dbx!",
3388 if ((IfrNvData
!= NULL
) && (IfrNvData
->CertificateFormat
< HASHALG_MAX
)) {
3389 Status
= EnrollX509HashtoSigDB (
3391 IfrNvData
->CertificateFormat
,
3392 &IfrNvData
->RevocationDate
,
3393 &IfrNvData
->RevocationTime
,
3394 IfrNvData
->AlwaysRevocation
3397 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE1
);
3399 if (EFI_ERROR (Status
)) {
3401 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3403 L
"ERROR: Unsupported file type!",
3404 L
"Only supports DER-encoded X509 certificate and executable EFI image",
3410 case KEY_VALUE_SAVE_AND_EXIT_DBT
:
3411 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE2
);
3412 if (EFI_ERROR (Status
)) {
3414 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3416 L
"ERROR: Unsupported file type!",
3417 L
"Only supports DER-encoded X509 certificate.",
3424 if (QuestionId
>= FILE_OPTION_GOTO_OFFSET
) {
3425 UpdateFileExplorer (Private
, QuestionId
);
3426 } else if ((QuestionId
>= OPTION_DEL_KEK_QUESTION_ID
) &&
3427 (QuestionId
< (OPTION_DEL_KEK_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
3428 DeleteKeyExchangeKey (Private
, QuestionId
);
3429 } else if ((QuestionId
>= OPTION_DEL_DB_QUESTION_ID
) &&
3430 (QuestionId
< (OPTION_DEL_DB_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
3433 EFI_IMAGE_SECURITY_DATABASE
,
3434 &gEfiImageSecurityDatabaseGuid
,
3436 SECUREBOOT_DELETE_SIGNATURE_FROM_DB
,
3437 OPTION_DEL_DB_QUESTION_ID
,
3438 QuestionId
- OPTION_DEL_DB_QUESTION_ID
3440 } else if ((QuestionId
>= OPTION_DEL_DBX_QUESTION_ID
) &&
3441 (QuestionId
< (OPTION_DEL_DBX_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
3444 EFI_IMAGE_SECURITY_DATABASE1
,
3445 &gEfiImageSecurityDatabaseGuid
,
3447 SECUREBOOT_DELETE_SIGNATURE_FROM_DBX
,
3448 OPTION_DEL_DBX_QUESTION_ID
,
3449 QuestionId
- OPTION_DEL_DBX_QUESTION_ID
3451 } else if ((QuestionId
>= OPTION_DEL_DBT_QUESTION_ID
) &&
3452 (QuestionId
< (OPTION_DEL_DBT_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
3455 EFI_IMAGE_SECURITY_DATABASE2
,
3456 &gEfiImageSecurityDatabaseGuid
,
3458 SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
,
3459 OPTION_DEL_DBT_QUESTION_ID
,
3460 QuestionId
- OPTION_DEL_DBT_QUESTION_ID
3465 } else if (Action
== EFI_BROWSER_ACTION_CHANGED
) {
3466 switch (QuestionId
) {
3467 case KEY_SECURE_BOOT_ENABLE
:
3468 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
3470 case KEY_VALUE_SAVE_AND_EXIT_PK
:
3471 Status
= EnrollPlatformKey (Private
);
3472 if (EFI_ERROR (Status
)) {
3475 sizeof (PromptString
),
3476 L
"Only DER encoded certificate file (%s) is supported.",
3480 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
3482 L
"ERROR: Unsupported file type!",
3487 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_RESET
;
3491 case KEY_VALUE_NO_SAVE_AND_EXIT_PK
:
3492 case KEY_VALUE_NO_SAVE_AND_EXIT_KEK
:
3493 case KEY_VALUE_NO_SAVE_AND_EXIT_DB
:
3494 case KEY_VALUE_NO_SAVE_AND_EXIT_DBX
:
3495 case KEY_VALUE_NO_SAVE_AND_EXIT_DBT
:
3496 if (Private
->FileContext
->FHandle
!= NULL
) {
3497 CloseFile (Private
->FileContext
->FHandle
);
3498 Private
->FileContext
->FHandle
= NULL
;
3499 Private
->FileContext
->FileName
= NULL
;
3502 if (Private
->SignatureGUID
!= NULL
) {
3503 FreePool (Private
->SignatureGUID
);
3504 Private
->SignatureGUID
= NULL
;
3506 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
3509 case KEY_SECURE_BOOT_MODE
:
3510 mIsEnterSecureBootForm
= FALSE
;
3513 case KEY_SECURE_BOOT_KEK_GUID
:
3514 case KEY_SECURE_BOOT_SIGNATURE_GUID_DB
:
3515 case KEY_SECURE_BOOT_SIGNATURE_GUID_DBX
:
3516 case KEY_SECURE_BOOT_SIGNATURE_GUID_DBT
:
3517 ASSERT (Private
->SignatureGUID
!= NULL
);
3518 Status
= StringToGuid (
3519 IfrNvData
->SignatureGuid
,
3520 StrLen (IfrNvData
->SignatureGuid
),
3521 Private
->SignatureGUID
3523 if (EFI_ERROR (Status
)) {
3527 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
3530 case KEY_SECURE_BOOT_DELETE_PK
:
3531 GetVariable2 (EFI_SETUP_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SetupMode
, NULL
);
3532 if (SetupMode
== NULL
|| (*SetupMode
) == SETUP_MODE
) {
3533 IfrNvData
->DeletePk
= TRUE
;
3534 IfrNvData
->HasPk
= FALSE
;
3535 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_SUBMIT
;
3537 IfrNvData
->DeletePk
= FALSE
;
3538 IfrNvData
->HasPk
= TRUE
;
3539 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
3541 if (SetupMode
!= NULL
) {
3542 FreePool (SetupMode
);
3546 if (QuestionId
>= FILE_OPTION_OFFSET
&& QuestionId
< FILE_OPTION_GOTO_OFFSET
) {
3547 if (UpdateFileExplorer (Private
, QuestionId
)) {
3548 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
3553 } else if (Action
== EFI_BROWSER_ACTION_DEFAULT_STANDARD
) {
3554 if (QuestionId
== KEY_HIDE_SECURE_BOOT
) {
3555 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
3556 if (SecureBootEnable
== NULL
) {
3557 IfrNvData
->HideSecureBoot
= TRUE
;
3559 FreePool (SecureBootEnable
);
3560 IfrNvData
->HideSecureBoot
= FALSE
;
3562 Value
->b
= IfrNvData
->HideSecureBoot
;
3564 } else if (Action
== EFI_BROWSER_ACTION_FORM_CLOSE
) {
3566 // Force the platform back to Standard Mode once user leave the setup screen.
3568 GetVariable2 (EFI_CUSTOM_MODE_NAME
, &gEfiCustomModeEnableGuid
, (VOID
**)&SecureBootMode
, NULL
);
3569 if (NULL
!= SecureBootMode
&& *SecureBootMode
== CUSTOM_SECURE_BOOT_MODE
) {
3570 IfrNvData
->SecureBootMode
= STANDARD_SECURE_BOOT_MODE
;
3571 SetSecureBootMode(STANDARD_SECURE_BOOT_MODE
);
3573 if (SecureBootMode
!= NULL
) {
3574 FreePool (SecureBootMode
);
3578 if (!EFI_ERROR (Status
)) {
3579 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
3580 HiiSetBrowserData (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, BufferSize
, (UINT8
*) IfrNvData
, NULL
);
3582 FreePool (IfrNvData
);
3588 This function publish the SecureBoot configuration Form.
3590 @param[in, out] PrivateData Points to SecureBoot configuration private data.
3592 @retval EFI_SUCCESS HII Form is installed successfully.
3593 @retval EFI_OUT_OF_RESOURCES Not enough resource for HII Form installation.
3594 @retval Others Other errors as indicated.
3598 InstallSecureBootConfigForm (
3599 IN OUT SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
3603 EFI_HII_HANDLE HiiHandle
;
3604 EFI_HANDLE DriverHandle
;
3605 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
3607 DriverHandle
= NULL
;
3608 ConfigAccess
= &PrivateData
->ConfigAccess
;
3609 Status
= gBS
->InstallMultipleProtocolInterfaces (
3611 &gEfiDevicePathProtocolGuid
,
3612 &mSecureBootHiiVendorDevicePath
,
3613 &gEfiHiiConfigAccessProtocolGuid
,
3617 if (EFI_ERROR (Status
)) {
3621 PrivateData
->DriverHandle
= DriverHandle
;
3624 // Publish the HII package list
3626 HiiHandle
= HiiAddPackages (
3627 &gSecureBootConfigFormSetGuid
,
3629 SecureBootConfigDxeStrings
,
3630 SecureBootConfigBin
,
3633 if (HiiHandle
== NULL
) {
3634 gBS
->UninstallMultipleProtocolInterfaces (
3636 &gEfiDevicePathProtocolGuid
,
3637 &mSecureBootHiiVendorDevicePath
,
3638 &gEfiHiiConfigAccessProtocolGuid
,
3642 return EFI_OUT_OF_RESOURCES
;
3645 PrivateData
->HiiHandle
= HiiHandle
;
3647 PrivateData
->FileContext
= AllocateZeroPool (sizeof (SECUREBOOT_FILE_CONTEXT
));
3648 PrivateData
->MenuEntry
= AllocateZeroPool (sizeof (SECUREBOOT_MENU_ENTRY
));
3650 if (PrivateData
->FileContext
== NULL
|| PrivateData
->MenuEntry
== NULL
) {
3651 UninstallSecureBootConfigForm (PrivateData
);
3652 return EFI_OUT_OF_RESOURCES
;
3655 PrivateData
->FeCurrentState
= FileExplorerStateInActive
;
3656 PrivateData
->FeDisplayContext
= FileExplorerDisplayUnknown
;
3658 InitializeListHead (&FsOptionMenu
.Head
);
3659 InitializeListHead (&DirectoryMenu
.Head
);
3662 // Init OpCode Handle and Allocate space for creation of Buffer
3664 mStartOpCodeHandle
= HiiAllocateOpCodeHandle ();
3665 if (mStartOpCodeHandle
== NULL
) {
3666 UninstallSecureBootConfigForm (PrivateData
);
3667 return EFI_OUT_OF_RESOURCES
;
3670 mEndOpCodeHandle
= HiiAllocateOpCodeHandle ();
3671 if (mEndOpCodeHandle
== NULL
) {
3672 UninstallSecureBootConfigForm (PrivateData
);
3673 return EFI_OUT_OF_RESOURCES
;
3677 // Create Hii Extend Label OpCode as the start opcode
3679 mStartLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
3683 sizeof (EFI_IFR_GUID_LABEL
)
3685 mStartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3688 // Create Hii Extend Label OpCode as the end opcode
3690 mEndLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
3694 sizeof (EFI_IFR_GUID_LABEL
)
3696 mEndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3697 mEndLabel
->Number
= LABEL_END
;
3703 This function removes SecureBoot configuration Form.
3705 @param[in, out] PrivateData Points to SecureBoot configuration private data.
3709 UninstallSecureBootConfigForm (
3710 IN OUT SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
3714 // Uninstall HII package list
3716 if (PrivateData
->HiiHandle
!= NULL
) {
3717 HiiRemovePackages (PrivateData
->HiiHandle
);
3718 PrivateData
->HiiHandle
= NULL
;
3722 // Uninstall HII Config Access Protocol
3724 if (PrivateData
->DriverHandle
!= NULL
) {
3725 gBS
->UninstallMultipleProtocolInterfaces (
3726 PrivateData
->DriverHandle
,
3727 &gEfiDevicePathProtocolGuid
,
3728 &mSecureBootHiiVendorDevicePath
,
3729 &gEfiHiiConfigAccessProtocolGuid
,
3730 &PrivateData
->ConfigAccess
,
3733 PrivateData
->DriverHandle
= NULL
;
3736 if (PrivateData
->SignatureGUID
!= NULL
) {
3737 FreePool (PrivateData
->SignatureGUID
);
3740 if (PrivateData
->MenuEntry
!= NULL
) {
3741 FreePool (PrivateData
->MenuEntry
);
3744 if (PrivateData
->FileContext
!= NULL
) {
3745 FreePool (PrivateData
->FileContext
);
3748 FreePool (PrivateData
);
3750 FreeMenu (&DirectoryMenu
);
3751 FreeMenu (&FsOptionMenu
);
3753 if (mStartOpCodeHandle
!= NULL
) {
3754 HiiFreeOpCodeHandle (mStartOpCodeHandle
);
3757 if (mEndOpCodeHandle
!= NULL
) {
3758 HiiFreeOpCodeHandle (mEndOpCodeHandle
);