2 HII Config Access protocol implementation of SecureBoot configuration module.
4 Copyright (c) 2011 - 2017, 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"
16 #include <Library/BaseCryptLib.h>
18 CHAR16 mSecureBootStorageName
[] = L
"SECUREBOOT_CONFIGURATION";
20 SECUREBOOT_CONFIG_PRIVATE_DATA mSecureBootConfigPrivateDateTemplate
= {
21 SECUREBOOT_CONFIG_PRIVATE_DATA_SIGNATURE
,
23 SecureBootExtractConfig
,
24 SecureBootRouteConfig
,
29 HII_VENDOR_DEVICE_PATH mSecureBootHiiVendorDevicePath
= {
35 (UINT8
) (sizeof (VENDOR_DEVICE_PATH
)),
36 (UINT8
) ((sizeof (VENDOR_DEVICE_PATH
)) >> 8)
39 SECUREBOOT_CONFIG_FORM_SET_GUID
43 END_ENTIRE_DEVICE_PATH_SUBTYPE
,
45 (UINT8
) (END_DEVICE_PATH_LENGTH
),
46 (UINT8
) ((END_DEVICE_PATH_LENGTH
) >> 8)
52 BOOLEAN mIsEnterSecureBootForm
= FALSE
;
55 // OID ASN.1 Value for Hash Algorithms
57 UINT8 mHashOidValue
[] = {
58 0x2A, 0x86, 0x48, 0x86, 0xF7, 0x0D, 0x02, 0x05, // OBJ_md5
59 0x2B, 0x0E, 0x03, 0x02, 0x1A, // OBJ_sha1
60 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x04, // OBJ_sha224
61 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x01, // OBJ_sha256
62 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x02, // OBJ_sha384
63 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x03, // OBJ_sha512
66 HASH_TABLE mHash
[] = {
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";
98 SECUREBOOT_CONFIG_PRIVATE_DATA
*gSecureBootPrivateData
= NULL
;
101 This code cleans up enrolled file by closing file & free related resources attached to
104 @param[in] FileContext FileContext cached in SecureBootConfig driver
109 IN SECUREBOOT_FILE_CONTEXT
*FileContext
112 if (FileContext
->FHandle
!= NULL
) {
113 CloseFile (FileContext
->FHandle
);
114 FileContext
->FHandle
= NULL
;
117 if (FileContext
->FileName
!= NULL
){
118 FreePool(FileContext
->FileName
);
119 FileContext
->FileName
= NULL
;
121 FileContext
->FileType
= UNKNOWN_FILE_TYPE
;
126 This code checks if the FileSuffix is one of the possible DER-encoded certificate suffix.
128 @param[in] FileSuffix The suffix of the input certificate file
130 @retval TRUE It's a DER-encoded certificate.
131 @retval FALSE It's NOT a DER-encoded certificate.
135 IsDerEncodeCertificate (
136 IN CONST CHAR16
*FileSuffix
140 for (Index
= 0; mDerEncodedSuffix
[Index
] != NULL
; Index
++) {
141 if (StrCmp (FileSuffix
, mDerEncodedSuffix
[Index
]) == 0) {
149 This code checks if the file content complies with EFI_VARIABLE_AUTHENTICATION_2 format
150 The function reads file content but won't open/close given FileHandle.
152 @param[in] FileHandle The FileHandle to be checked
154 @retval TRUE The content is EFI_VARIABLE_AUTHENTICATION_2 format.
155 @retval FALSE The content is NOT a EFI_VARIABLE_AUTHENTICATION_2 format.
159 IsAuthentication2Format (
160 IN EFI_FILE_HANDLE FileHandle
164 EFI_VARIABLE_AUTHENTICATION_2
*Auth2
;
165 BOOLEAN IsAuth2Format
;
167 IsAuth2Format
= FALSE
;
170 // Read the whole file content
172 Status
= ReadFileContent(
174 (VOID
**) &mImageBase
,
178 if (EFI_ERROR (Status
)) {
182 Auth2
= (EFI_VARIABLE_AUTHENTICATION_2
*)mImageBase
;
183 if (Auth2
->AuthInfo
.Hdr
.wCertificateType
!= WIN_CERT_TYPE_EFI_GUID
) {
187 if (CompareGuid(&gEfiCertPkcs7Guid
, &Auth2
->AuthInfo
.CertType
)) {
188 IsAuth2Format
= TRUE
;
193 // Do not close File. simply check file content
195 if (mImageBase
!= NULL
) {
196 FreePool (mImageBase
);
200 return IsAuth2Format
;
204 Set Secure Boot option into variable space.
206 @param[in] VarValue The option of Secure Boot.
208 @retval EFI_SUCCESS The operation is finished successfully.
209 @retval Others Other errors as indicated.
213 SaveSecureBootVariable (
219 Status
= gRT
->SetVariable (
220 EFI_SECURE_BOOT_ENABLE_NAME
,
221 &gEfiSecureBootEnableDisableGuid
,
222 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
,
230 Create a time based data payload by concatenating the EFI_VARIABLE_AUTHENTICATION_2
231 descriptor with the input data. NO authentication is required in this function.
233 @param[in, out] DataSize On input, the size of Data buffer in bytes.
234 On output, the size of data returned in Data
236 @param[in, out] Data On input, Pointer to data buffer to be wrapped or
237 pointer to NULL to wrap an empty payload.
238 On output, Pointer to the new payload date buffer allocated from pool,
239 it's caller's responsibility to free the memory when finish using it.
241 @retval EFI_SUCCESS Create time based payload successfully.
242 @retval EFI_OUT_OF_RESOURCES There are not enough memory resourses to create time based payload.
243 @retval EFI_INVALID_PARAMETER The parameter is invalid.
244 @retval Others Unexpected error happens.
248 CreateTimeBasedPayload (
249 IN OUT UINTN
*DataSize
,
257 EFI_VARIABLE_AUTHENTICATION_2
*DescriptorData
;
258 UINTN DescriptorSize
;
261 if (Data
== NULL
|| DataSize
== NULL
) {
262 return EFI_INVALID_PARAMETER
;
266 // In Setup mode or Custom mode, the variable does not need to be signed but the
267 // parameters to the SetVariable() call still need to be prepared as authenticated
268 // variable. So we create EFI_VARIABLE_AUTHENTICATED_2 descriptor without certificate
272 PayloadSize
= *DataSize
;
274 DescriptorSize
= OFFSET_OF (EFI_VARIABLE_AUTHENTICATION_2
, AuthInfo
) + OFFSET_OF (WIN_CERTIFICATE_UEFI_GUID
, CertData
);
275 NewData
= (UINT8
*) AllocateZeroPool (DescriptorSize
+ PayloadSize
);
276 if (NewData
== NULL
) {
277 return EFI_OUT_OF_RESOURCES
;
280 if ((Payload
!= NULL
) && (PayloadSize
!= 0)) {
281 CopyMem (NewData
+ DescriptorSize
, Payload
, PayloadSize
);
284 DescriptorData
= (EFI_VARIABLE_AUTHENTICATION_2
*) (NewData
);
286 ZeroMem (&Time
, sizeof (EFI_TIME
));
287 Status
= gRT
->GetTime (&Time
, NULL
);
288 if (EFI_ERROR (Status
)) {
297 CopyMem (&DescriptorData
->TimeStamp
, &Time
, sizeof (EFI_TIME
));
299 DescriptorData
->AuthInfo
.Hdr
.dwLength
= OFFSET_OF (WIN_CERTIFICATE_UEFI_GUID
, CertData
);
300 DescriptorData
->AuthInfo
.Hdr
.wRevision
= 0x0200;
301 DescriptorData
->AuthInfo
.Hdr
.wCertificateType
= WIN_CERT_TYPE_EFI_GUID
;
302 CopyGuid (&DescriptorData
->AuthInfo
.CertType
, &gEfiCertPkcs7Guid
);
304 if (Payload
!= NULL
) {
308 *DataSize
= DescriptorSize
+ PayloadSize
;
314 Internal helper function to delete a Variable given its name and GUID, NO authentication
317 @param[in] VariableName Name of the Variable.
318 @param[in] VendorGuid GUID of the Variable.
320 @retval EFI_SUCCESS Variable deleted successfully.
321 @retval Others The driver failed to start the device.
326 IN CHAR16
*VariableName
,
327 IN EFI_GUID
*VendorGuid
336 GetVariable2 (VariableName
, VendorGuid
, &Variable
, NULL
);
337 if (Variable
== NULL
) {
344 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
| EFI_VARIABLE_BOOTSERVICE_ACCESS
345 | EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
347 Status
= CreateTimeBasedPayload (&DataSize
, &Data
);
348 if (EFI_ERROR (Status
)) {
349 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
353 Status
= gRT
->SetVariable (
368 Set the platform secure boot mode into "Custom" or "Standard" mode.
370 @param[in] SecureBootMode New secure boot mode: STANDARD_SECURE_BOOT_MODE or
371 CUSTOM_SECURE_BOOT_MODE.
373 @return EFI_SUCCESS The platform has switched to the special mode successfully.
374 @return other Fail to operate the secure boot mode.
379 IN UINT8 SecureBootMode
382 return gRT
->SetVariable (
383 EFI_CUSTOM_MODE_NAME
,
384 &gEfiCustomModeEnableGuid
,
385 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
,
392 Generate the PK signature list from the X509 Certificate storing file (.cer)
394 @param[in] X509File FileHandle of X509 Certificate storing file.
395 @param[out] PkCert Point to the data buffer to store the signature list.
397 @return EFI_UNSUPPORTED Unsupported Key Length.
398 @return EFI_OUT_OF_RESOURCES There are not enough memory resourses to form the signature list.
402 CreatePkX509SignatureList (
403 IN EFI_FILE_HANDLE X509File
,
404 OUT EFI_SIGNATURE_LIST
**PkCert
410 EFI_SIGNATURE_DATA
*PkCertData
;
416 Status
= ReadFileContent (X509File
, (VOID
**) &X509Data
, &X509DataSize
, 0);
417 if (EFI_ERROR (Status
)) {
420 ASSERT (X509Data
!= NULL
);
423 // Allocate space for PK certificate list and initialize it.
424 // Create PK database entry with SignatureHeaderSize equals 0.
426 *PkCert
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (
427 sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1
430 if (*PkCert
== NULL
) {
431 Status
= EFI_OUT_OF_RESOURCES
;
435 (*PkCert
)->SignatureListSize
= (UINT32
) (sizeof(EFI_SIGNATURE_LIST
)
436 + sizeof(EFI_SIGNATURE_DATA
) - 1
438 (*PkCert
)->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
439 (*PkCert
)->SignatureHeaderSize
= 0;
440 CopyGuid (&(*PkCert
)->SignatureType
, &gEfiCertX509Guid
);
441 PkCertData
= (EFI_SIGNATURE_DATA
*) ((UINTN
)(*PkCert
)
442 + sizeof(EFI_SIGNATURE_LIST
)
443 + (*PkCert
)->SignatureHeaderSize
);
444 CopyGuid (&PkCertData
->SignatureOwner
, &gEfiGlobalVariableGuid
);
446 // Fill the PK database with PKpub data from X509 certificate file.
448 CopyMem (&(PkCertData
->SignatureData
[0]), X509Data
, X509DataSize
);
452 if (X509Data
!= NULL
) {
456 if (EFI_ERROR(Status
) && *PkCert
!= NULL
) {
465 Enroll new PK into the System without original PK's authentication.
467 The SignatureOwner GUID will be the same with PK's vendorguid.
469 @param[in] PrivateData The module's private data.
471 @retval EFI_SUCCESS New PK enrolled successfully.
472 @retval EFI_INVALID_PARAMETER The parameter is invalid.
473 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
478 IN SECUREBOOT_CONFIG_PRIVATE_DATA
* Private
484 EFI_SIGNATURE_LIST
*PkCert
;
488 if (Private
->FileContext
->FileName
== NULL
) {
489 return EFI_INVALID_PARAMETER
;
494 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
495 if (EFI_ERROR (Status
)) {
500 // Parse the file's postfix. Only support DER encoded X.509 certificate files.
502 NameLength
= StrLen (Private
->FileContext
->FileName
);
503 if (NameLength
<= 4) {
504 return EFI_INVALID_PARAMETER
;
506 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
507 if (!IsDerEncodeCertificate(FilePostFix
)) {
508 DEBUG ((EFI_D_ERROR
, "Unsupported file type, only DER encoded certificate (%s) is supported.", mSupportX509Suffix
));
509 return EFI_INVALID_PARAMETER
;
511 DEBUG ((EFI_D_INFO
, "FileName= %s\n", Private
->FileContext
->FileName
));
512 DEBUG ((EFI_D_INFO
, "FilePostFix = %s\n", FilePostFix
));
515 // Prase the selected PK file and generature PK certificate list.
517 Status
= CreatePkX509SignatureList (
518 Private
->FileContext
->FHandle
,
521 if (EFI_ERROR (Status
)) {
524 ASSERT (PkCert
!= NULL
);
527 // Set Platform Key variable.
529 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
530 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
531 DataSize
= PkCert
->SignatureListSize
;
532 Status
= CreateTimeBasedPayload (&DataSize
, (UINT8
**) &PkCert
);
533 if (EFI_ERROR (Status
)) {
534 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
538 Status
= gRT
->SetVariable(
539 EFI_PLATFORM_KEY_NAME
,
540 &gEfiGlobalVariableGuid
,
545 if (EFI_ERROR (Status
)) {
546 if (Status
== EFI_OUT_OF_RESOURCES
) {
547 DEBUG ((EFI_D_ERROR
, "Enroll PK failed with out of resource.\n"));
554 if (PkCert
!= NULL
) {
558 CloseEnrolledFile(Private
->FileContext
);
564 Remove the PK variable.
566 @retval EFI_SUCCESS Delete PK successfully.
567 @retval Others Could not allow to delete PK.
577 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
578 if (EFI_ERROR (Status
)) {
582 Status
= DeleteVariable (
583 EFI_PLATFORM_KEY_NAME
,
584 &gEfiGlobalVariableGuid
590 Enroll a new KEK item from public key storing file (*.pbk).
592 @param[in] PrivateData The module's private data.
594 @retval EFI_SUCCESS New KEK enrolled successfully.
595 @retval EFI_INVALID_PARAMETER The parameter is invalid.
596 @retval EFI_UNSUPPORTED Unsupported command.
597 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
602 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
608 EFI_SIGNATURE_LIST
*KekSigList
;
611 CPL_KEY_INFO
*KeyInfo
;
612 EFI_SIGNATURE_DATA
*KEKSigData
;
613 UINTN KekSigListSize
;
628 // Form the KeKpub certificate list into EFI_SIGNATURE_LIST type.
629 // First, We have to parse out public key data from the pbk key file.
631 Status
= ReadFileContent (
632 Private
->FileContext
->FHandle
,
637 if (EFI_ERROR (Status
)) {
640 ASSERT (KeyBlob
!= NULL
);
641 KeyInfo
= (CPL_KEY_INFO
*) KeyBlob
;
642 if (KeyInfo
->KeyLengthInBits
/ 8 != WIN_CERT_UEFI_RSA2048_SIZE
) {
643 DEBUG ((DEBUG_ERROR
, "Unsupported key length, Only RSA2048 is supported.\n"));
644 Status
= EFI_UNSUPPORTED
;
649 // Convert the Public key to fix octet string format represented in RSA PKCS#1.
651 KeyLenInBytes
= KeyInfo
->KeyLengthInBits
/ 8;
652 KeyBuffer
= AllocateZeroPool (KeyLenInBytes
);
653 if (KeyBuffer
== NULL
) {
654 Status
= EFI_OUT_OF_RESOURCES
;
658 (UINTN
*) (KeyBlob
+ sizeof (CPL_KEY_INFO
)),
659 KeyLenInBytes
/ sizeof (UINTN
),
663 CopyMem(KeyBlob
+ sizeof(CPL_KEY_INFO
), KeyBuffer
, KeyLenInBytes
);
666 // Form an new EFI_SIGNATURE_LIST.
668 KekSigListSize
= sizeof(EFI_SIGNATURE_LIST
)
669 + sizeof(EFI_SIGNATURE_DATA
) - 1
670 + WIN_CERT_UEFI_RSA2048_SIZE
;
672 KekSigList
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (KekSigListSize
);
673 if (KekSigList
== NULL
) {
674 Status
= EFI_OUT_OF_RESOURCES
;
678 KekSigList
->SignatureListSize
= sizeof(EFI_SIGNATURE_LIST
)
679 + sizeof(EFI_SIGNATURE_DATA
) - 1
680 + WIN_CERT_UEFI_RSA2048_SIZE
;
681 KekSigList
->SignatureHeaderSize
= 0;
682 KekSigList
->SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + WIN_CERT_UEFI_RSA2048_SIZE
;
683 CopyGuid (&KekSigList
->SignatureType
, &gEfiCertRsa2048Guid
);
685 KEKSigData
= (EFI_SIGNATURE_DATA
*)((UINT8
*)KekSigList
+ sizeof(EFI_SIGNATURE_LIST
));
686 CopyGuid (&KEKSigData
->SignatureOwner
, Private
->SignatureGUID
);
688 KEKSigData
->SignatureData
,
689 KeyBlob
+ sizeof(CPL_KEY_INFO
),
690 WIN_CERT_UEFI_RSA2048_SIZE
694 // Check if KEK entry has been already existed.
695 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
696 // new KEK to original variable.
698 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
699 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
700 Status
= CreateTimeBasedPayload (&KekSigListSize
, (UINT8
**) &KekSigList
);
701 if (EFI_ERROR (Status
)) {
702 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
706 Status
= gRT
->GetVariable(
707 EFI_KEY_EXCHANGE_KEY_NAME
,
708 &gEfiGlobalVariableGuid
,
713 if (Status
== EFI_BUFFER_TOO_SMALL
) {
714 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
715 } else if (Status
!= EFI_NOT_FOUND
) {
720 // Done. Now we have formed the correct KEKpub database item, just set it into variable storage,
722 Status
= gRT
->SetVariable(
723 EFI_KEY_EXCHANGE_KEY_NAME
,
724 &gEfiGlobalVariableGuid
,
729 if (EFI_ERROR (Status
)) {
735 CloseEnrolledFile(Private
->FileContext
);
737 if (Private
->SignatureGUID
!= NULL
) {
738 FreePool (Private
->SignatureGUID
);
739 Private
->SignatureGUID
= NULL
;
742 if (KeyBlob
!= NULL
) {
745 if (KeyBuffer
!= NULL
) {
746 FreePool (KeyBuffer
);
748 if (KekSigList
!= NULL
) {
749 FreePool (KekSigList
);
756 Enroll a new KEK item from X509 certificate file.
758 @param[in] PrivateData The module's private data.
760 @retval EFI_SUCCESS New X509 is enrolled successfully.
761 @retval EFI_INVALID_PARAMETER The parameter is invalid.
762 @retval EFI_UNSUPPORTED Unsupported command.
763 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
768 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
774 EFI_SIGNATURE_DATA
*KEKSigData
;
775 EFI_SIGNATURE_LIST
*KekSigList
;
777 UINTN KekSigListSize
;
787 Status
= ReadFileContent (
788 Private
->FileContext
->FHandle
,
793 if (EFI_ERROR (Status
)) {
796 ASSERT (X509Data
!= NULL
);
798 KekSigListSize
= sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
;
799 KekSigList
= (EFI_SIGNATURE_LIST
*) AllocateZeroPool (KekSigListSize
);
800 if (KekSigList
== NULL
) {
801 Status
= EFI_OUT_OF_RESOURCES
;
806 // Fill Certificate Database parameters.
808 KekSigList
->SignatureListSize
= (UINT32
) KekSigListSize
;
809 KekSigList
->SignatureHeaderSize
= 0;
810 KekSigList
->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
811 CopyGuid (&KekSigList
->SignatureType
, &gEfiCertX509Guid
);
813 KEKSigData
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) KekSigList
+ sizeof (EFI_SIGNATURE_LIST
));
814 CopyGuid (&KEKSigData
->SignatureOwner
, Private
->SignatureGUID
);
815 CopyMem (KEKSigData
->SignatureData
, X509Data
, X509DataSize
);
818 // Check if KEK been already existed.
819 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
820 // new kek to original variable
822 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
823 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
824 Status
= CreateTimeBasedPayload (&KekSigListSize
, (UINT8
**) &KekSigList
);
825 if (EFI_ERROR (Status
)) {
826 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
830 Status
= gRT
->GetVariable(
831 EFI_KEY_EXCHANGE_KEY_NAME
,
832 &gEfiGlobalVariableGuid
,
837 if (Status
== EFI_BUFFER_TOO_SMALL
) {
838 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
839 } else if (Status
!= EFI_NOT_FOUND
) {
843 Status
= gRT
->SetVariable(
844 EFI_KEY_EXCHANGE_KEY_NAME
,
845 &gEfiGlobalVariableGuid
,
850 if (EFI_ERROR (Status
)) {
856 CloseEnrolledFile(Private
->FileContext
);
858 if (Private
->SignatureGUID
!= NULL
) {
859 FreePool (Private
->SignatureGUID
);
860 Private
->SignatureGUID
= NULL
;
863 if (KekSigList
!= NULL
) {
864 FreePool (KekSigList
);
871 Enroll new KEK into the System without PK's authentication.
872 The SignatureOwner GUID will be Private->SignatureGUID.
874 @param[in] PrivateData The module's private data.
876 @retval EFI_SUCCESS New KEK enrolled successful.
877 @retval EFI_INVALID_PARAMETER The parameter is invalid.
878 @retval others Fail to enroll KEK data.
882 EnrollKeyExchangeKey (
883 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
890 if ((Private
->FileContext
->FHandle
== NULL
) || (Private
->FileContext
->FileName
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
891 return EFI_INVALID_PARAMETER
;
894 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
895 if (EFI_ERROR (Status
)) {
900 // Parse the file's postfix. Supports DER-encoded X509 certificate,
901 // and .pbk as RSA public key file.
903 NameLength
= StrLen (Private
->FileContext
->FileName
);
904 if (NameLength
<= 4) {
905 return EFI_INVALID_PARAMETER
;
907 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
908 if (IsDerEncodeCertificate(FilePostFix
)) {
909 return EnrollX509ToKek (Private
);
910 } else if (CompareMem (FilePostFix
, L
".pbk",4) == 0) {
911 return EnrollRsa2048ToKek (Private
);
914 // File type is wrong, simply close it
916 CloseEnrolledFile(Private
->FileContext
);
918 return EFI_INVALID_PARAMETER
;
923 Enroll a new X509 certificate into Signature Database (DB or DBX or DBT) without
924 KEK's authentication.
926 @param[in] PrivateData The module's private data.
927 @param[in] VariableName Variable name of signature database, must be
928 EFI_IMAGE_SECURITY_DATABASE or EFI_IMAGE_SECURITY_DATABASE1.
930 @retval EFI_SUCCESS New X509 is enrolled successfully.
931 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
936 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
937 IN CHAR16
*VariableName
943 EFI_SIGNATURE_LIST
*SigDBCert
;
944 EFI_SIGNATURE_DATA
*SigDBCertData
;
955 SigDBCertData
= NULL
;
958 Status
= ReadFileContent (
959 Private
->FileContext
->FHandle
,
964 if (EFI_ERROR (Status
)) {
967 ASSERT (X509Data
!= NULL
);
969 SigDBSize
= sizeof(EFI_SIGNATURE_LIST
) + sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
;
971 Data
= AllocateZeroPool (SigDBSize
);
973 Status
= EFI_OUT_OF_RESOURCES
;
978 // Fill Certificate Database parameters.
980 SigDBCert
= (EFI_SIGNATURE_LIST
*) Data
;
981 SigDBCert
->SignatureListSize
= (UINT32
) SigDBSize
;
982 SigDBCert
->SignatureHeaderSize
= 0;
983 SigDBCert
->SignatureSize
= (UINT32
) (sizeof(EFI_SIGNATURE_DATA
) - 1 + X509DataSize
);
984 CopyGuid (&SigDBCert
->SignatureType
, &gEfiCertX509Guid
);
986 SigDBCertData
= (EFI_SIGNATURE_DATA
*) ((UINT8
* ) SigDBCert
+ sizeof (EFI_SIGNATURE_LIST
));
987 CopyGuid (&SigDBCertData
->SignatureOwner
, Private
->SignatureGUID
);
988 CopyMem ((UINT8
* ) (SigDBCertData
->SignatureData
), X509Data
, X509DataSize
);
991 // Check if signature database entry has been already existed.
992 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
993 // new signature data to original variable
995 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
996 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
997 Status
= CreateTimeBasedPayload (&SigDBSize
, (UINT8
**) &Data
);
998 if (EFI_ERROR (Status
)) {
999 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
1003 Status
= gRT
->GetVariable(
1005 &gEfiImageSecurityDatabaseGuid
,
1010 if (Status
== EFI_BUFFER_TOO_SMALL
) {
1011 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
1012 } else if (Status
!= EFI_NOT_FOUND
) {
1016 Status
= gRT
->SetVariable(
1018 &gEfiImageSecurityDatabaseGuid
,
1023 if (EFI_ERROR (Status
)) {
1029 CloseEnrolledFile(Private
->FileContext
);
1031 if (Private
->SignatureGUID
!= NULL
) {
1032 FreePool (Private
->SignatureGUID
);
1033 Private
->SignatureGUID
= NULL
;
1040 if (X509Data
!= NULL
) {
1041 FreePool (X509Data
);
1048 Check whether signature is in specified database.
1050 @param[in] VariableName Name of database variable that is searched in.
1051 @param[in] Signature Pointer to signature that is searched for.
1052 @param[in] SignatureSize Size of Signature.
1054 @return TRUE Found the signature in the variable database.
1055 @return FALSE Not found the signature in the variable database.
1059 IsSignatureFoundInDatabase (
1060 IN CHAR16
*VariableName
,
1061 IN UINT8
*Signature
,
1062 IN UINTN SignatureSize
1066 EFI_SIGNATURE_LIST
*CertList
;
1067 EFI_SIGNATURE_DATA
*Cert
;
1075 // Read signature database variable.
1080 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1081 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
1085 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1090 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1091 if (EFI_ERROR (Status
)) {
1096 // Enumerate all signature data in SigDB to check if executable's signature exists.
1098 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
1099 while ((DataSize
> 0) && (DataSize
>= CertList
->SignatureListSize
)) {
1100 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
1101 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
1102 if ((CertList
->SignatureSize
== sizeof(EFI_SIGNATURE_DATA
) - 1 + SignatureSize
) && (CompareGuid(&CertList
->SignatureType
, &gEfiCertX509Guid
))) {
1103 for (Index
= 0; Index
< CertCount
; Index
++) {
1104 if (CompareMem (Cert
->SignatureData
, Signature
, SignatureSize
) == 0) {
1106 // Find the signature in database.
1111 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
1119 DataSize
-= CertList
->SignatureListSize
;
1120 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
1132 Calculate the hash of a certificate data with the specified hash algorithm.
1134 @param[in] CertData The certificate data to be hashed.
1135 @param[in] CertSize The certificate size in bytes.
1136 @param[in] HashAlg The specified hash algorithm.
1137 @param[out] CertHash The output digest of the certificate
1139 @retval TRUE Successfully got the hash of the CertData.
1140 @retval FALSE Failed to get the hash of CertData.
1160 if (HashAlg
>= HASHALG_MAX
) {
1165 // Retrieve the TBSCertificate for Hash Calculation.
1167 if (!X509GetTBSCert (CertData
, CertSize
, &TBSCert
, &TBSCertSize
)) {
1172 // 1. Initialize context of hash.
1174 CtxSize
= mHash
[HashAlg
].GetContextSize ();
1175 HashCtx
= AllocatePool (CtxSize
);
1176 ASSERT (HashCtx
!= NULL
);
1179 // 2. Initialize a hash context.
1181 Status
= mHash
[HashAlg
].HashInit (HashCtx
);
1187 // 3. Calculate the hash.
1189 Status
= mHash
[HashAlg
].HashUpdate (HashCtx
, TBSCert
, TBSCertSize
);
1195 // 4. Get the hash result.
1197 ZeroMem (CertHash
, mHash
[HashAlg
].DigestLength
);
1198 Status
= mHash
[HashAlg
].HashFinal (HashCtx
, CertHash
);
1201 if (HashCtx
!= NULL
) {
1209 Check whether the hash of an X.509 certificate is in forbidden database (DBX).
1211 @param[in] Certificate Pointer to X.509 Certificate that is searched for.
1212 @param[in] CertSize Size of X.509 Certificate.
1214 @return TRUE Found the certificate hash in the forbidden database.
1215 @return FALSE Certificate hash is Not found in the forbidden database.
1219 IsCertHashFoundInDbx (
1220 IN UINT8
*Certificate
,
1226 EFI_SIGNATURE_LIST
*DbxList
;
1227 EFI_SIGNATURE_DATA
*CertHash
;
1228 UINTN CertHashCount
;
1231 UINT8 CertDigest
[MAX_DIGEST_SIZE
];
1233 UINTN SiglistHeaderSize
;
1238 HashAlg
= HASHALG_MAX
;
1242 // Read signature database variable.
1245 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1246 if (Status
!= EFI_BUFFER_TOO_SMALL
) {
1250 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1255 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1256 if (EFI_ERROR (Status
)) {
1261 // Check whether the certificate hash exists in the forbidden database.
1263 DbxList
= (EFI_SIGNATURE_LIST
*) Data
;
1264 while ((DataSize
> 0) && (DataSize
>= DbxList
->SignatureListSize
)) {
1266 // Determine Hash Algorithm of Certificate in the forbidden database.
1268 if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
1269 HashAlg
= HASHALG_SHA256
;
1270 } else if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
1271 HashAlg
= HASHALG_SHA384
;
1272 } else if (CompareGuid (&DbxList
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
1273 HashAlg
= HASHALG_SHA512
;
1275 DataSize
-= DbxList
->SignatureListSize
;
1276 DbxList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) DbxList
+ DbxList
->SignatureListSize
);
1281 // Calculate the hash value of current db certificate for comparision.
1283 if (!CalculateCertHash (Certificate
, CertSize
, HashAlg
, CertDigest
)) {
1287 SiglistHeaderSize
= sizeof (EFI_SIGNATURE_LIST
) + DbxList
->SignatureHeaderSize
;
1288 CertHash
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) DbxList
+ SiglistHeaderSize
);
1289 CertHashCount
= (DbxList
->SignatureListSize
- SiglistHeaderSize
) / DbxList
->SignatureSize
;
1290 for (Index
= 0; Index
< CertHashCount
; Index
++) {
1292 // Iterate each Signature Data Node within this CertList for verify.
1294 DbxCertHash
= CertHash
->SignatureData
;
1295 if (CompareMem (DbxCertHash
, CertDigest
, mHash
[HashAlg
].DigestLength
) == 0) {
1297 // Hash of Certificate is found in forbidden database.
1302 CertHash
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertHash
+ DbxList
->SignatureSize
);
1305 DataSize
-= DbxList
->SignatureListSize
;
1306 DbxList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) DbxList
+ DbxList
->SignatureListSize
);
1318 Check whether the signature list exists in given variable data.
1320 It searches the signature list for the ceritificate hash by CertType.
1321 If the signature list is found, get the offset of Database for the
1322 next hash of a certificate.
1324 @param[in] Database Variable data to save signature list.
1325 @param[in] DatabaseSize Variable size.
1326 @param[in] SignatureType The type of the signature.
1327 @param[out] Offset The offset to save a new hash of certificate.
1329 @return TRUE The signature list is found in the forbidden database.
1330 @return FALSE The signature list is not found in the forbidden database.
1333 GetSignaturelistOffset (
1334 IN EFI_SIGNATURE_LIST
*Database
,
1335 IN UINTN DatabaseSize
,
1336 IN EFI_GUID
*SignatureType
,
1340 EFI_SIGNATURE_LIST
*SigList
;
1343 if ((Database
== NULL
) || (DatabaseSize
== 0)) {
1349 SiglistSize
= DatabaseSize
;
1350 while ((SiglistSize
> 0) && (SiglistSize
>= SigList
->SignatureListSize
)) {
1351 if (CompareGuid (&SigList
->SignatureType
, SignatureType
)) {
1352 *Offset
= DatabaseSize
- SiglistSize
;
1355 SiglistSize
-= SigList
->SignatureListSize
;
1356 SigList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) SigList
+ SigList
->SignatureListSize
);
1363 Enroll a new X509 certificate hash into Signature Database (dbx) without
1364 KEK's authentication.
1366 @param[in] PrivateData The module's private data.
1367 @param[in] HashAlg The hash algorithm to enroll the certificate.
1368 @param[in] RevocationDate The revocation date of the certificate.
1369 @param[in] RevocationTime The revocation time of the certificate.
1370 @param[in] AlwaysRevocation Indicate whether the certificate is always revoked.
1372 @retval EFI_SUCCESS New X509 is enrolled successfully.
1373 @retval EFI_INVALID_PARAMETER The parameter is invalid.
1374 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
1378 EnrollX509HashtoSigDB (
1379 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
1381 IN EFI_HII_DATE
*RevocationDate
,
1382 IN EFI_HII_TIME
*RevocationTime
,
1383 IN BOOLEAN AlwaysRevocation
1389 EFI_SIGNATURE_LIST
*SignatureList
;
1390 UINTN SignatureListSize
;
1396 EFI_SIGNATURE_DATA
*SignatureData
;
1397 UINTN SignatureSize
;
1398 EFI_GUID SignatureType
;
1400 UINT8 CertHash
[MAX_DIGEST_SIZE
];
1401 UINT16
* FilePostFix
;
1408 SignatureData
= NULL
;
1409 SignatureList
= NULL
;
1413 if ((Private
->FileContext
->FileName
== NULL
) || (Private
->FileContext
->FHandle
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
1414 return EFI_INVALID_PARAMETER
;
1417 Status
= SetSecureBootMode (CUSTOM_SECURE_BOOT_MODE
);
1418 if (EFI_ERROR (Status
)) {
1423 // Parse the file's postfix.
1425 NameLength
= StrLen (Private
->FileContext
->FileName
);
1426 if (NameLength
<= 4) {
1427 return EFI_INVALID_PARAMETER
;
1429 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
1430 if (!IsDerEncodeCertificate(FilePostFix
)) {
1432 // Only supports DER-encoded X509 certificate.
1434 return EFI_INVALID_PARAMETER
;
1438 // Get the certificate from file and calculate its hash.
1440 Status
= ReadFileContent (
1441 Private
->FileContext
->FHandle
,
1446 if (EFI_ERROR (Status
)) {
1449 ASSERT (X509Data
!= NULL
);
1451 if (!CalculateCertHash (X509Data
, X509DataSize
, HashAlg
, CertHash
)) {
1456 // Get the variable for enrollment.
1459 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, NULL
);
1460 if (Status
== EFI_BUFFER_TOO_SMALL
) {
1461 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
1463 return EFI_OUT_OF_RESOURCES
;
1466 Status
= gRT
->GetVariable (EFI_IMAGE_SECURITY_DATABASE1
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, Data
);
1467 if (EFI_ERROR (Status
)) {
1473 // Allocate memory for Signature and fill the Signature
1475 SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + sizeof (EFI_TIME
) + mHash
[HashAlg
].DigestLength
;
1476 SignatureData
= (EFI_SIGNATURE_DATA
*) AllocateZeroPool (SignatureSize
);
1477 if (SignatureData
== NULL
) {
1478 return EFI_OUT_OF_RESOURCES
;
1480 CopyGuid (&SignatureData
->SignatureOwner
, Private
->SignatureGUID
);
1481 CopyMem (SignatureData
->SignatureData
, CertHash
, mHash
[HashAlg
].DigestLength
);
1486 if (!AlwaysRevocation
) {
1487 Time
= (EFI_TIME
*)(&SignatureData
->SignatureData
+ mHash
[HashAlg
].DigestLength
);
1488 Time
->Year
= RevocationDate
->Year
;
1489 Time
->Month
= RevocationDate
->Month
;
1490 Time
->Day
= RevocationDate
->Day
;
1491 Time
->Hour
= RevocationTime
->Hour
;
1492 Time
->Minute
= RevocationTime
->Minute
;
1493 Time
->Second
= RevocationTime
->Second
;
1497 // Determine the GUID for certificate hash.
1500 case HASHALG_SHA256
:
1501 SignatureType
= gEfiCertX509Sha256Guid
;
1503 case HASHALG_SHA384
:
1504 SignatureType
= gEfiCertX509Sha384Guid
;
1506 case HASHALG_SHA512
:
1507 SignatureType
= gEfiCertX509Sha512Guid
;
1514 // Add signature into the new variable data buffer
1516 if (GetSignaturelistOffset((EFI_SIGNATURE_LIST
*)Data
, DataSize
, &SignatureType
, &Offset
)) {
1518 // Add the signature to the found signaturelist.
1520 DbSize
= DataSize
+ SignatureSize
;
1521 NewData
= AllocateZeroPool (DbSize
);
1522 if (NewData
== NULL
) {
1523 Status
= EFI_OUT_OF_RESOURCES
;
1527 SignatureList
= (EFI_SIGNATURE_LIST
*)(Data
+ Offset
);
1528 SignatureListSize
= (UINTN
) ReadUnaligned32 ((UINT32
*)&SignatureList
->SignatureListSize
);
1529 CopyMem (NewData
, Data
, Offset
+ SignatureListSize
);
1531 SignatureList
= (EFI_SIGNATURE_LIST
*)(NewData
+ Offset
);
1532 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureListSize
, (UINT32
)(SignatureListSize
+ SignatureSize
));
1534 Offset
+= SignatureListSize
;
1535 CopyMem (NewData
+ Offset
, SignatureData
, SignatureSize
);
1536 CopyMem (NewData
+ Offset
+ SignatureSize
, Data
+ Offset
, DataSize
- Offset
);
1543 // Create a new signaturelist, and add the signature into the signaturelist.
1545 DbSize
= DataSize
+ sizeof(EFI_SIGNATURE_LIST
) + SignatureSize
;
1546 NewData
= AllocateZeroPool (DbSize
);
1547 if (NewData
== NULL
) {
1548 Status
= EFI_OUT_OF_RESOURCES
;
1552 // Fill Certificate Database parameters.
1554 SignatureList
= (EFI_SIGNATURE_LIST
*) (NewData
+ DataSize
);
1555 SignatureListSize
= sizeof(EFI_SIGNATURE_LIST
) + SignatureSize
;
1556 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureListSize
, (UINT32
) SignatureListSize
);
1557 WriteUnaligned32 ((UINT32
*) &SignatureList
->SignatureSize
, (UINT32
) SignatureSize
);
1558 CopyGuid (&SignatureList
->SignatureType
, &SignatureType
);
1559 CopyMem ((UINT8
* ) SignatureList
+ sizeof (EFI_SIGNATURE_LIST
), SignatureData
, SignatureSize
);
1560 if ((DataSize
!= 0) && (Data
!= NULL
)) {
1561 CopyMem (NewData
, Data
, DataSize
);
1568 Status
= CreateTimeBasedPayload (&DataSize
, (UINT8
**) &Data
);
1569 if (EFI_ERROR (Status
)) {
1573 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
1574 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
1575 Status
= gRT
->SetVariable(
1576 EFI_IMAGE_SECURITY_DATABASE1
,
1577 &gEfiImageSecurityDatabaseGuid
,
1582 if (EFI_ERROR (Status
)) {
1588 CloseEnrolledFile(Private
->FileContext
);
1590 if (Private
->SignatureGUID
!= NULL
) {
1591 FreePool (Private
->SignatureGUID
);
1592 Private
->SignatureGUID
= NULL
;
1599 if (SignatureData
!= NULL
) {
1600 FreePool (SignatureData
);
1603 if (X509Data
!= NULL
) {
1604 FreePool (X509Data
);
1611 Check whether a certificate from a file exists in dbx.
1613 @param[in] PrivateData The module's private data.
1614 @param[in] VariableName Variable name of signature database, must be
1615 EFI_IMAGE_SECURITY_DATABASE1.
1617 @retval TRUE The X509 certificate is found in dbx successfully.
1618 @retval FALSE The X509 certificate is not found in dbx.
1622 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
1623 IN CHAR16
*VariableName
1632 // Read the certificate from file
1636 Status
= ReadFileContent (
1637 Private
->FileContext
->FHandle
,
1642 if (EFI_ERROR (Status
)) {
1647 // Check the raw certificate.
1650 if (IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE1
, X509Data
, X509DataSize
)) {
1656 // Check the hash of certificate.
1658 if (IsCertHashFoundInDbx (X509Data
, X509DataSize
)) {
1664 if (X509Data
!= NULL
) {
1665 FreePool (X509Data
);
1672 Reads contents of a PE/COFF image in memory buffer.
1674 Caution: This function may receive untrusted input.
1675 PE/COFF image is external input, so this function will make sure the PE/COFF image content
1676 read is within the image buffer.
1678 @param FileHandle Pointer to the file handle to read the PE/COFF image.
1679 @param FileOffset Offset into the PE/COFF image to begin the read operation.
1680 @param ReadSize On input, the size in bytes of the requested read operation.
1681 On output, the number of bytes actually read.
1682 @param Buffer Output buffer that contains the data read from the PE/COFF image.
1684 @retval EFI_SUCCESS The specified portion of the PE/COFF image was read and the size
1688 SecureBootConfigImageRead (
1689 IN VOID
*FileHandle
,
1690 IN UINTN FileOffset
,
1691 IN OUT UINTN
*ReadSize
,
1697 if (FileHandle
== NULL
|| ReadSize
== NULL
|| Buffer
== NULL
) {
1698 return EFI_INVALID_PARAMETER
;
1701 if (MAX_ADDRESS
- FileOffset
< *ReadSize
) {
1702 return EFI_INVALID_PARAMETER
;
1705 EndPosition
= FileOffset
+ *ReadSize
;
1706 if (EndPosition
> mImageSize
) {
1707 *ReadSize
= (UINT32
)(mImageSize
- FileOffset
);
1710 if (FileOffset
>= mImageSize
) {
1714 CopyMem (Buffer
, (UINT8
*)((UINTN
) FileHandle
+ FileOffset
), *ReadSize
);
1720 Load PE/COFF image information into internal buffer and check its validity.
1722 @retval EFI_SUCCESS Successful
1723 @retval EFI_UNSUPPORTED Invalid PE/COFF file
1724 @retval EFI_ABORTED Serious error occurs, like file I/O error etc.
1732 EFI_IMAGE_DOS_HEADER
*DosHdr
;
1733 EFI_IMAGE_NT_HEADERS32
*NtHeader32
;
1734 EFI_IMAGE_NT_HEADERS64
*NtHeader64
;
1735 PE_COFF_LOADER_IMAGE_CONTEXT ImageContext
;
1741 ZeroMem (&ImageContext
, sizeof (ImageContext
));
1742 ImageContext
.Handle
= (VOID
*) mImageBase
;
1743 ImageContext
.ImageRead
= (PE_COFF_LOADER_READ_FILE
) SecureBootConfigImageRead
;
1746 // Get information about the image being loaded
1748 Status
= PeCoffLoaderGetImageInfo (&ImageContext
);
1749 if (EFI_ERROR (Status
)) {
1751 // The information can't be got from the invalid PeImage
1753 DEBUG ((DEBUG_INFO
, "SecureBootConfigDxe: PeImage invalid. \n"));
1758 // Read the Dos header
1760 DosHdr
= (EFI_IMAGE_DOS_HEADER
*)(mImageBase
);
1761 if (DosHdr
->e_magic
== EFI_IMAGE_DOS_SIGNATURE
)
1764 // DOS image header is present,
1765 // So read the PE header after the DOS image header
1767 mPeCoffHeaderOffset
= DosHdr
->e_lfanew
;
1771 mPeCoffHeaderOffset
= 0;
1775 // Read PE header and check the signature validity and machine compatibility
1777 NtHeader32
= (EFI_IMAGE_NT_HEADERS32
*) (mImageBase
+ mPeCoffHeaderOffset
);
1778 if (NtHeader32
->Signature
!= EFI_IMAGE_NT_SIGNATURE
)
1780 return EFI_UNSUPPORTED
;
1783 mNtHeader
.Pe32
= NtHeader32
;
1786 // Check the architecture field of PE header and get the Certificate Data Directory data
1787 // Note the size of FileHeader field is constant for both IA32 and X64 arch
1789 if ((NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_IA32
)
1790 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_EBC
)
1791 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_ARMTHUMB_MIXED
)) {
1793 // 32-bits Architecture
1795 mImageType
= ImageType_IA32
;
1796 mSecDataDir
= (EFI_IMAGE_SECURITY_DATA_DIRECTORY
*) &(NtHeader32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]);
1798 else if ((NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_IA64
)
1799 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_X64
)
1800 || (NtHeader32
->FileHeader
.Machine
== EFI_IMAGE_MACHINE_AARCH64
)) {
1802 // 64-bits Architecture
1804 mImageType
= ImageType_X64
;
1805 NtHeader64
= (EFI_IMAGE_NT_HEADERS64
*) (mImageBase
+ mPeCoffHeaderOffset
);
1806 mSecDataDir
= (EFI_IMAGE_SECURITY_DATA_DIRECTORY
*) &(NtHeader64
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]);
1808 return EFI_UNSUPPORTED
;
1815 Calculate hash of Pe/Coff image based on the authenticode image hashing in
1816 PE/COFF Specification 8.0 Appendix A
1818 Notes: PE/COFF image has been checked by BasePeCoffLib PeCoffLoaderGetImageInfo() in
1819 the function LoadPeImage ().
1821 @param[in] HashAlg Hash algorithm type.
1823 @retval TRUE Successfully hash image.
1824 @retval FALSE Fail in hash image.
1834 EFI_IMAGE_SECTION_HEADER
*Section
;
1839 UINTN SumOfBytesHashed
;
1840 EFI_IMAGE_SECTION_HEADER
*SectionHeader
;
1845 SectionHeader
= NULL
;
1848 if (HashAlg
!= HASHALG_SHA256
) {
1853 // Initialize context of hash.
1855 ZeroMem (mImageDigest
, MAX_DIGEST_SIZE
);
1857 mImageDigestSize
= SHA256_DIGEST_SIZE
;
1858 mCertType
= gEfiCertSha256Guid
;
1860 CtxSize
= mHash
[HashAlg
].GetContextSize();
1862 HashCtx
= AllocatePool (CtxSize
);
1863 ASSERT (HashCtx
!= NULL
);
1865 // 1. Load the image header into memory.
1867 // 2. Initialize a SHA hash context.
1868 Status
= mHash
[HashAlg
].HashInit(HashCtx
);
1873 // Measuring PE/COFF Image Header;
1874 // But CheckSum field and SECURITY data directory (certificate) are excluded
1876 if (mNtHeader
.Pe32
->FileHeader
.Machine
== IMAGE_FILE_MACHINE_IA64
&& mNtHeader
.Pe32
->OptionalHeader
.Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1878 // NOTE: Some versions of Linux ELILO for Itanium have an incorrect magic value
1879 // in the PE/COFF Header. If the MachineType is Itanium(IA64) and the
1880 // Magic value in the OptionalHeader is EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
1881 // then override the magic value to EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
1883 Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
1886 // Get the magic value from the PE/COFF Optional Header
1888 Magic
= mNtHeader
.Pe32
->OptionalHeader
.Magic
;
1892 // 3. Calculate the distance from the base of the image header to the image checksum address.
1893 // 4. Hash the image header from its base to beginning of the image checksum.
1895 HashBase
= mImageBase
;
1896 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1900 HashSize
= (UINTN
) (&mNtHeader
.Pe32
->OptionalHeader
.CheckSum
) - (UINTN
) HashBase
;
1903 // Use PE32+ offset.
1905 HashSize
= (UINTN
) (&mNtHeader
.Pe32Plus
->OptionalHeader
.CheckSum
) - (UINTN
) HashBase
;
1908 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1913 // 5. Skip over the image checksum (it occupies a single ULONG).
1914 // 6. Get the address of the beginning of the Cert Directory.
1915 // 7. Hash everything from the end of the checksum to the start of the Cert Directory.
1917 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1921 HashBase
= (UINT8
*) &mNtHeader
.Pe32
->OptionalHeader
.CheckSum
+ sizeof (UINT32
);
1922 HashSize
= (UINTN
) (&mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]) - (UINTN
) HashBase
;
1925 // Use PE32+ offset.
1927 HashBase
= (UINT8
*) &mNtHeader
.Pe32Plus
->OptionalHeader
.CheckSum
+ sizeof (UINT32
);
1928 HashSize
= (UINTN
) (&mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
]) - (UINTN
) HashBase
;
1931 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1936 // 8. Skip over the Cert Directory. (It is sizeof(IMAGE_DATA_DIRECTORY) bytes.)
1937 // 9. Hash everything from the end of the Cert Directory to the end of image header.
1939 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1943 HashBase
= (UINT8
*) &mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1];
1944 HashSize
= mNtHeader
.Pe32
->OptionalHeader
.SizeOfHeaders
- ((UINTN
) (&mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1]) - (UINTN
) mImageBase
);
1947 // Use PE32+ offset.
1949 HashBase
= (UINT8
*) &mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1];
1950 HashSize
= mNtHeader
.Pe32Plus
->OptionalHeader
.SizeOfHeaders
- ((UINTN
) (&mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
+ 1]) - (UINTN
) mImageBase
);
1953 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
1958 // 10. Set the SUM_OF_BYTES_HASHED to the size of the header.
1960 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
1964 SumOfBytesHashed
= mNtHeader
.Pe32
->OptionalHeader
.SizeOfHeaders
;
1969 SumOfBytesHashed
= mNtHeader
.Pe32Plus
->OptionalHeader
.SizeOfHeaders
;
1973 // 11. Build a temporary table of pointers to all the IMAGE_SECTION_HEADER
1974 // structures in the image. The 'NumberOfSections' field of the image
1975 // header indicates how big the table should be. Do not include any
1976 // IMAGE_SECTION_HEADERs in the table whose 'SizeOfRawData' field is zero.
1978 SectionHeader
= (EFI_IMAGE_SECTION_HEADER
*) AllocateZeroPool (sizeof (EFI_IMAGE_SECTION_HEADER
) * mNtHeader
.Pe32
->FileHeader
.NumberOfSections
);
1979 ASSERT (SectionHeader
!= NULL
);
1981 // 12. Using the 'PointerToRawData' in the referenced section headers as
1982 // a key, arrange the elements in the table in ascending order. In other
1983 // words, sort the section headers according to the disk-file offset of
1986 Section
= (EFI_IMAGE_SECTION_HEADER
*) (
1988 mPeCoffHeaderOffset
+
1990 sizeof (EFI_IMAGE_FILE_HEADER
) +
1991 mNtHeader
.Pe32
->FileHeader
.SizeOfOptionalHeader
1993 for (Index
= 0; Index
< mNtHeader
.Pe32
->FileHeader
.NumberOfSections
; Index
++) {
1995 while ((Pos
> 0) && (Section
->PointerToRawData
< SectionHeader
[Pos
- 1].PointerToRawData
)) {
1996 CopyMem (&SectionHeader
[Pos
], &SectionHeader
[Pos
- 1], sizeof (EFI_IMAGE_SECTION_HEADER
));
1999 CopyMem (&SectionHeader
[Pos
], Section
, sizeof (EFI_IMAGE_SECTION_HEADER
));
2004 // 13. Walk through the sorted table, bring the corresponding section
2005 // into memory, and hash the entire section (using the 'SizeOfRawData'
2006 // field in the section header to determine the amount of data to hash).
2007 // 14. Add the section's 'SizeOfRawData' to SUM_OF_BYTES_HASHED .
2008 // 15. Repeat steps 13 and 14 for all the sections in the sorted table.
2010 for (Index
= 0; Index
< mNtHeader
.Pe32
->FileHeader
.NumberOfSections
; Index
++) {
2011 Section
= &SectionHeader
[Index
];
2012 if (Section
->SizeOfRawData
== 0) {
2015 HashBase
= mImageBase
+ Section
->PointerToRawData
;
2016 HashSize
= (UINTN
) Section
->SizeOfRawData
;
2018 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
2023 SumOfBytesHashed
+= HashSize
;
2027 // 16. If the file size is greater than SUM_OF_BYTES_HASHED, there is extra
2028 // data in the file that needs to be added to the hash. This data begins
2029 // at file offset SUM_OF_BYTES_HASHED and its length is:
2030 // FileSize - (CertDirectory->Size)
2032 if (mImageSize
> SumOfBytesHashed
) {
2033 HashBase
= mImageBase
+ SumOfBytesHashed
;
2034 if (Magic
== EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
) {
2040 mNtHeader
.Pe32
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
].Size
-
2044 // Use PE32+ offset.
2048 mNtHeader
.Pe32Plus
->OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY
].Size
-
2052 Status
= mHash
[HashAlg
].HashUpdate(HashCtx
, HashBase
, HashSize
);
2058 Status
= mHash
[HashAlg
].HashFinal(HashCtx
, mImageDigest
);
2061 if (HashCtx
!= NULL
) {
2064 if (SectionHeader
!= NULL
) {
2065 FreePool (SectionHeader
);
2071 Recognize the Hash algorithm in PE/COFF Authenticode and calculate hash of
2072 Pe/Coff image based on the authenticated image hashing in PE/COFF Specification
2075 @retval EFI_UNSUPPORTED Hash algorithm is not supported.
2076 @retval EFI_SUCCESS Hash successfully.
2085 WIN_CERTIFICATE_EFI_PKCS
*PkcsCertData
;
2087 PkcsCertData
= (WIN_CERTIFICATE_EFI_PKCS
*) (mImageBase
+ mSecDataDir
->Offset
);
2089 for (Index
= 0; Index
< HASHALG_MAX
; Index
++) {
2091 // Check the Hash algorithm in PE/COFF Authenticode.
2092 // According to PKCS#7 Definition:
2093 // SignedData ::= SEQUENCE {
2095 // digestAlgorithms DigestAlgorithmIdentifiers,
2096 // contentInfo ContentInfo,
2098 // The DigestAlgorithmIdentifiers can be used to determine the hash algorithm in PE/COFF hashing
2099 // This field has the fixed offset (+32) in final Authenticode ASN.1 data.
2100 // Fixed offset (+32) is calculated based on two bytes of length encoding.
2102 if ((*(PkcsCertData
->CertData
+ 1) & TWO_BYTE_ENCODE
) != TWO_BYTE_ENCODE
) {
2104 // Only support two bytes of Long Form of Length Encoding.
2110 if (CompareMem (PkcsCertData
->CertData
+ 32, mHash
[Index
].OidValue
, mHash
[Index
].OidLength
) == 0) {
2115 if (Index
== HASHALG_MAX
) {
2116 return EFI_UNSUPPORTED
;
2120 // HASH PE Image based on Hash algorithm in PE/COFF Authenticode.
2122 if (!HashPeImage(Index
)) {
2123 return EFI_UNSUPPORTED
;
2130 Enroll a new executable's signature into Signature Database.
2132 @param[in] PrivateData The module's private data.
2133 @param[in] VariableName Variable name of signature database, must be
2134 EFI_IMAGE_SECURITY_DATABASE, EFI_IMAGE_SECURITY_DATABASE1
2135 or EFI_IMAGE_SECURITY_DATABASE2.
2137 @retval EFI_SUCCESS New signature is enrolled successfully.
2138 @retval EFI_INVALID_PARAMETER The parameter is invalid.
2139 @retval EFI_UNSUPPORTED Unsupported command.
2140 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2144 EnrollAuthentication2Descriptor (
2145 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
2146 IN CHAR16
*VariableName
2157 // DBT only support DER-X509 Cert Enrollment
2159 if (StrCmp (VariableName
, EFI_IMAGE_SECURITY_DATABASE2
) == 0) {
2160 return EFI_UNSUPPORTED
;
2164 // Read the whole file content
2166 Status
= ReadFileContent(
2167 Private
->FileContext
->FHandle
,
2168 (VOID
**) &mImageBase
,
2172 if (EFI_ERROR (Status
)) {
2175 ASSERT (mImageBase
!= NULL
);
2177 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
2178 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
2181 // Check if SigDB variable has been already existed.
2182 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
2183 // new signature data to original variable
2186 Status
= gRT
->GetVariable(
2188 &gEfiImageSecurityDatabaseGuid
,
2193 if (Status
== EFI_BUFFER_TOO_SMALL
) {
2194 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
2195 } else if (Status
!= EFI_NOT_FOUND
) {
2200 // Diretly set AUTHENTICATION_2 data to SetVariable
2202 Status
= gRT
->SetVariable(
2204 &gEfiImageSecurityDatabaseGuid
,
2210 DEBUG((DEBUG_INFO
, "Enroll AUTH_2 data to Var:%s Status: %x\n", VariableName
, Status
));
2214 CloseEnrolledFile(Private
->FileContext
);
2220 if (mImageBase
!= NULL
) {
2221 FreePool (mImageBase
);
2231 Enroll a new executable's signature into Signature Database.
2233 @param[in] PrivateData The module's private data.
2234 @param[in] VariableName Variable name of signature database, must be
2235 EFI_IMAGE_SECURITY_DATABASE, EFI_IMAGE_SECURITY_DATABASE1
2236 or EFI_IMAGE_SECURITY_DATABASE2.
2238 @retval EFI_SUCCESS New signature is enrolled successfully.
2239 @retval EFI_INVALID_PARAMETER The parameter is invalid.
2240 @retval EFI_UNSUPPORTED Unsupported command.
2241 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2245 EnrollImageSignatureToSigDB (
2246 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
2247 IN CHAR16
*VariableName
2251 EFI_SIGNATURE_LIST
*SigDBCert
;
2252 EFI_SIGNATURE_DATA
*SigDBCertData
;
2257 WIN_CERTIFICATE_UEFI_GUID
*GuidCertData
;
2260 GuidCertData
= NULL
;
2262 if (StrCmp (VariableName
, EFI_IMAGE_SECURITY_DATABASE2
) == 0) {
2263 return EFI_UNSUPPORTED
;
2267 // Form the SigDB certificate list.
2268 // Format the data item into EFI_SIGNATURE_LIST type.
2270 // We need to parse executable's signature data from specified signed executable file.
2271 // In current implementation, we simply trust the pass-in signed executable file.
2272 // In reality, it's OS's responsibility to verify the signed executable file.
2276 // Read the whole file content
2278 Status
= ReadFileContent(
2279 Private
->FileContext
->FHandle
,
2280 (VOID
**) &mImageBase
,
2284 if (EFI_ERROR (Status
)) {
2287 ASSERT (mImageBase
!= NULL
);
2289 Status
= LoadPeImage ();
2290 if (EFI_ERROR (Status
)) {
2294 if (mSecDataDir
->SizeOfCert
== 0) {
2295 if (!HashPeImage (HASHALG_SHA256
)) {
2296 Status
= EFI_SECURITY_VIOLATION
;
2302 // Read the certificate data
2304 mCertificate
= (WIN_CERTIFICATE
*)(mImageBase
+ mSecDataDir
->Offset
);
2306 if (mCertificate
->wCertificateType
== WIN_CERT_TYPE_EFI_GUID
) {
2307 GuidCertData
= (WIN_CERTIFICATE_UEFI_GUID
*) mCertificate
;
2308 if (CompareMem (&GuidCertData
->CertType
, &gEfiCertTypeRsa2048Sha256Guid
, sizeof(EFI_GUID
)) != 0) {
2309 Status
= EFI_ABORTED
;
2313 if (!HashPeImage (HASHALG_SHA256
)) {
2314 Status
= EFI_ABORTED
;
2318 } else if (mCertificate
->wCertificateType
== WIN_CERT_TYPE_PKCS_SIGNED_DATA
) {
2320 Status
= HashPeImageByType ();
2321 if (EFI_ERROR (Status
)) {
2325 Status
= EFI_ABORTED
;
2331 // Create a new SigDB entry.
2333 SigDBSize
= sizeof(EFI_SIGNATURE_LIST
)
2334 + sizeof(EFI_SIGNATURE_DATA
) - 1
2335 + (UINT32
) mImageDigestSize
;
2337 Data
= (UINT8
*) AllocateZeroPool (SigDBSize
);
2339 Status
= EFI_OUT_OF_RESOURCES
;
2344 // Adjust the Certificate Database parameters.
2346 SigDBCert
= (EFI_SIGNATURE_LIST
*) Data
;
2347 SigDBCert
->SignatureListSize
= (UINT32
) SigDBSize
;
2348 SigDBCert
->SignatureHeaderSize
= 0;
2349 SigDBCert
->SignatureSize
= sizeof(EFI_SIGNATURE_DATA
) - 1 + (UINT32
) mImageDigestSize
;
2350 CopyGuid (&SigDBCert
->SignatureType
, &mCertType
);
2352 SigDBCertData
= (EFI_SIGNATURE_DATA
*)((UINT8
*)SigDBCert
+ sizeof(EFI_SIGNATURE_LIST
));
2353 CopyGuid (&SigDBCertData
->SignatureOwner
, Private
->SignatureGUID
);
2354 CopyMem (SigDBCertData
->SignatureData
, mImageDigest
, mImageDigestSize
);
2356 Attr
= EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_RUNTIME_ACCESS
2357 | EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
;
2358 Status
= CreateTimeBasedPayload (&SigDBSize
, (UINT8
**) &Data
);
2359 if (EFI_ERROR (Status
)) {
2360 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
2365 // Check if SigDB variable has been already existed.
2366 // If true, use EFI_VARIABLE_APPEND_WRITE attribute to append the
2367 // new signature data to original variable
2370 Status
= gRT
->GetVariable(
2372 &gEfiImageSecurityDatabaseGuid
,
2377 if (Status
== EFI_BUFFER_TOO_SMALL
) {
2378 Attr
|= EFI_VARIABLE_APPEND_WRITE
;
2379 } else if (Status
!= EFI_NOT_FOUND
) {
2384 // Enroll the variable.
2386 Status
= gRT
->SetVariable(
2388 &gEfiImageSecurityDatabaseGuid
,
2393 if (EFI_ERROR (Status
)) {
2399 CloseEnrolledFile(Private
->FileContext
);
2401 if (Private
->SignatureGUID
!= NULL
) {
2402 FreePool (Private
->SignatureGUID
);
2403 Private
->SignatureGUID
= NULL
;
2410 if (mImageBase
!= NULL
) {
2411 FreePool (mImageBase
);
2419 Enroll signature into DB/DBX/DBT without KEK's authentication.
2420 The SignatureOwner GUID will be Private->SignatureGUID.
2422 @param[in] PrivateData The module's private data.
2423 @param[in] VariableName Variable name of signature database, must be
2424 EFI_IMAGE_SECURITY_DATABASE or EFI_IMAGE_SECURITY_DATABASE1.
2426 @retval EFI_SUCCESS New signature enrolled successfully.
2427 @retval EFI_INVALID_PARAMETER The parameter is invalid.
2428 @retval others Fail to enroll signature data.
2432 EnrollSignatureDatabase (
2433 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
2434 IN CHAR16
*VariableName
2437 UINT16
* FilePostFix
;
2441 if ((Private
->FileContext
->FileName
== NULL
) || (Private
->FileContext
->FHandle
== NULL
) || (Private
->SignatureGUID
== NULL
)) {
2442 return EFI_INVALID_PARAMETER
;
2445 Status
= SetSecureBootMode (CUSTOM_SECURE_BOOT_MODE
);
2446 if (EFI_ERROR (Status
)) {
2451 // Parse the file's postfix.
2453 NameLength
= StrLen (Private
->FileContext
->FileName
);
2454 if (NameLength
<= 4) {
2455 return EFI_INVALID_PARAMETER
;
2457 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
2458 if (IsDerEncodeCertificate (FilePostFix
)) {
2460 // Supports DER-encoded X509 certificate.
2462 return EnrollX509toSigDB (Private
, VariableName
);
2463 } else if (IsAuthentication2Format(Private
->FileContext
->FHandle
)){
2464 return EnrollAuthentication2Descriptor(Private
, VariableName
);
2466 return EnrollImageSignatureToSigDB (Private
, VariableName
);
2471 List all signatures in specified signature database (e.g. KEK/DB/DBX/DBT)
2472 by GUID in the page for user to select and delete as needed.
2474 @param[in] PrivateData Module's private data.
2475 @param[in] VariableName The variable name of the vendor's signature database.
2476 @param[in] VendorGuid A unique identifier for the vendor.
2477 @param[in] LabelNumber Label number to insert opcodes.
2478 @param[in] FormId Form ID of current page.
2479 @param[in] QuestionIdBase Base question id of the signature list.
2481 @retval EFI_SUCCESS Success to update the signature list page
2482 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
2487 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2488 IN CHAR16
*VariableName
,
2489 IN EFI_GUID
*VendorGuid
,
2490 IN UINT16 LabelNumber
,
2491 IN EFI_FORM_ID FormId
,
2492 IN EFI_QUESTION_ID QuestionIdBase
2499 VOID
*StartOpCodeHandle
;
2500 VOID
*EndOpCodeHandle
;
2501 EFI_IFR_GUID_LABEL
*StartLabel
;
2502 EFI_IFR_GUID_LABEL
*EndLabel
;
2505 EFI_SIGNATURE_LIST
*CertList
;
2506 EFI_SIGNATURE_DATA
*Cert
;
2507 UINT32 ItemDataSize
;
2509 EFI_STRING_ID GuidID
;
2516 StartOpCodeHandle
= NULL
;
2517 EndOpCodeHandle
= NULL
;
2520 // Initialize the container for dynamic opcodes.
2522 StartOpCodeHandle
= HiiAllocateOpCodeHandle ();
2523 if (StartOpCodeHandle
== NULL
) {
2524 Status
= EFI_OUT_OF_RESOURCES
;
2528 EndOpCodeHandle
= HiiAllocateOpCodeHandle ();
2529 if (EndOpCodeHandle
== NULL
) {
2530 Status
= EFI_OUT_OF_RESOURCES
;
2535 // Create Hii Extend Label OpCode.
2537 StartLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
2541 sizeof (EFI_IFR_GUID_LABEL
)
2543 StartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
2544 StartLabel
->Number
= LabelNumber
;
2546 EndLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
2550 sizeof (EFI_IFR_GUID_LABEL
)
2552 EndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
2553 EndLabel
->Number
= LABEL_END
;
2559 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, Data
);
2560 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2564 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2566 Status
= EFI_OUT_OF_RESOURCES
;
2570 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, Data
);
2571 if (EFI_ERROR (Status
)) {
2575 GuidStr
= AllocateZeroPool (100);
2576 if (GuidStr
== NULL
) {
2577 Status
= EFI_OUT_OF_RESOURCES
;
2582 // Enumerate all KEK pub data.
2584 ItemDataSize
= (UINT32
) DataSize
;
2585 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
2588 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
2590 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
)) {
2591 Help
= STRING_TOKEN (STR_CERT_TYPE_RSA2048_SHA256_GUID
);
2592 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
)) {
2593 Help
= STRING_TOKEN (STR_CERT_TYPE_PCKS7_GUID
);
2594 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertSha1Guid
)) {
2595 Help
= STRING_TOKEN (STR_CERT_TYPE_SHA1_GUID
);
2596 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertSha256Guid
)) {
2597 Help
= STRING_TOKEN (STR_CERT_TYPE_SHA256_GUID
);
2598 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
2599 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA256_GUID
);
2600 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
2601 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA384_GUID
);
2602 } else if (CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
2603 Help
= STRING_TOKEN (STR_CERT_TYPE_X509_SHA512_GUID
);
2606 // The signature type is not supported in current implementation.
2608 ItemDataSize
-= CertList
->SignatureListSize
;
2609 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2613 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2614 for (Index
= 0; Index
< CertCount
; Index
++) {
2615 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
2616 + sizeof (EFI_SIGNATURE_LIST
)
2617 + CertList
->SignatureHeaderSize
2618 + Index
* CertList
->SignatureSize
);
2620 // Display GUID and help
2622 GuidToString (&Cert
->SignatureOwner
, GuidStr
, 100);
2623 GuidID
= HiiSetString (PrivateData
->HiiHandle
, 0, GuidStr
, NULL
);
2624 HiiCreateCheckBoxOpCode (
2626 (EFI_QUESTION_ID
) (QuestionIdBase
+ GuidIndex
++),
2631 EFI_IFR_FLAG_CALLBACK
,
2637 ItemDataSize
-= CertList
->SignatureListSize
;
2638 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2643 PrivateData
->HiiHandle
,
2644 &gSecureBootConfigFormSetGuid
,
2650 if (StartOpCodeHandle
!= NULL
) {
2651 HiiFreeOpCodeHandle (StartOpCodeHandle
);
2654 if (EndOpCodeHandle
!= NULL
) {
2655 HiiFreeOpCodeHandle (EndOpCodeHandle
);
2662 if (GuidStr
!= NULL
) {
2670 Delete a KEK entry from KEK database.
2672 @param[in] PrivateData Module's private data.
2673 @param[in] QuestionId Question id of the KEK item to delete.
2675 @retval EFI_SUCCESS Delete kek item successfully.
2676 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2680 DeleteKeyExchangeKey (
2681 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2682 IN EFI_QUESTION_ID QuestionId
2691 EFI_SIGNATURE_LIST
*CertList
;
2692 EFI_SIGNATURE_LIST
*NewCertList
;
2693 EFI_SIGNATURE_DATA
*Cert
;
2696 BOOLEAN IsKEKItemFound
;
2698 UINTN DeleteKekIndex
;
2706 DeleteKekIndex
= QuestionId
- OPTION_DEL_KEK_QUESTION_ID
;
2708 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
2709 if (EFI_ERROR (Status
)) {
2714 // Get original KEK variable.
2717 Status
= gRT
->GetVariable (EFI_KEY_EXCHANGE_KEY_NAME
, &gEfiGlobalVariableGuid
, NULL
, &DataSize
, NULL
);
2718 if (EFI_ERROR(Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2722 OldData
= (UINT8
*)AllocateZeroPool(DataSize
);
2723 if (OldData
== NULL
) {
2724 Status
= EFI_OUT_OF_RESOURCES
;
2728 Status
= gRT
->GetVariable (EFI_KEY_EXCHANGE_KEY_NAME
, &gEfiGlobalVariableGuid
, &Attr
, &DataSize
, OldData
);
2729 if (EFI_ERROR(Status
)) {
2734 // Allocate space for new variable.
2736 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2738 Status
= EFI_OUT_OF_RESOURCES
;
2743 // Enumerate all KEK pub data and erasing the target item.
2745 IsKEKItemFound
= FALSE
;
2746 KekDataSize
= (UINT32
) DataSize
;
2747 CertList
= (EFI_SIGNATURE_LIST
*) OldData
;
2750 while ((KekDataSize
> 0) && (KekDataSize
>= CertList
->SignatureListSize
)) {
2751 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
) ||
2752 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
)) {
2753 CopyMem (Data
+ Offset
, CertList
, (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
));
2754 NewCertList
= (EFI_SIGNATURE_LIST
*)(Data
+ Offset
);
2755 Offset
+= (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2756 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2757 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2758 for (Index
= 0; Index
< CertCount
; Index
++) {
2759 if (GuidIndex
== DeleteKekIndex
) {
2761 // Find it! Skip it!
2763 NewCertList
->SignatureListSize
-= CertList
->SignatureSize
;
2764 IsKEKItemFound
= TRUE
;
2767 // This item doesn't match. Copy it to the Data buffer.
2769 CopyMem (Data
+ Offset
, Cert
, CertList
->SignatureSize
);
2770 Offset
+= CertList
->SignatureSize
;
2773 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
2777 // This List doesn't match. Copy it to the Data buffer.
2779 CopyMem (Data
+ Offset
, CertList
, CertList
->SignatureListSize
);
2780 Offset
+= CertList
->SignatureListSize
;
2783 KekDataSize
-= CertList
->SignatureListSize
;
2784 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2787 if (!IsKEKItemFound
) {
2789 // Doesn't find the Kek Item!
2791 Status
= EFI_NOT_FOUND
;
2796 // Delete the Signature header if there is no signature in the list.
2798 KekDataSize
= Offset
;
2799 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
2801 ZeroMem (OldData
, KekDataSize
);
2802 while ((KekDataSize
> 0) && (KekDataSize
>= CertList
->SignatureListSize
)) {
2803 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2804 DEBUG ((DEBUG_INFO
, " CertCount = %x\n", CertCount
));
2805 if (CertCount
!= 0) {
2806 CopyMem (OldData
+ Offset
, CertList
, CertList
->SignatureListSize
);
2807 Offset
+= CertList
->SignatureListSize
;
2809 KekDataSize
-= CertList
->SignatureListSize
;
2810 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2814 if ((Attr
& EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
) != 0) {
2815 Status
= CreateTimeBasedPayload (&DataSize
, &OldData
);
2816 if (EFI_ERROR (Status
)) {
2817 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
2822 Status
= gRT
->SetVariable(
2823 EFI_KEY_EXCHANGE_KEY_NAME
,
2824 &gEfiGlobalVariableGuid
,
2829 if (EFI_ERROR (Status
)) {
2830 DEBUG ((DEBUG_ERROR
, "Failed to set variable, Status = %r\n", Status
));
2839 if (OldData
!= NULL
) {
2843 return UpdateDeletePage (
2845 EFI_KEY_EXCHANGE_KEY_NAME
,
2846 &gEfiGlobalVariableGuid
,
2848 FORMID_DELETE_KEK_FORM
,
2849 OPTION_DEL_KEK_QUESTION_ID
2854 Delete a signature entry from signature database.
2856 @param[in] PrivateData Module's private data.
2857 @param[in] VariableName The variable name of the vendor's signature database.
2858 @param[in] VendorGuid A unique identifier for the vendor.
2859 @param[in] LabelNumber Label number to insert opcodes.
2860 @param[in] FormId Form ID of current page.
2861 @param[in] QuestionIdBase Base question id of the signature list.
2862 @param[in] DeleteIndex Signature index to delete.
2864 @retval EFI_SUCCESS Delete signature successfully.
2865 @retval EFI_NOT_FOUND Can't find the signature item,
2866 @retval EFI_OUT_OF_RESOURCES Could not allocate needed resources.
2870 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
2871 IN CHAR16
*VariableName
,
2872 IN EFI_GUID
*VendorGuid
,
2873 IN UINT16 LabelNumber
,
2874 IN EFI_FORM_ID FormId
,
2875 IN EFI_QUESTION_ID QuestionIdBase
,
2876 IN UINTN DeleteIndex
2885 EFI_SIGNATURE_LIST
*CertList
;
2886 EFI_SIGNATURE_LIST
*NewCertList
;
2887 EFI_SIGNATURE_DATA
*Cert
;
2890 BOOLEAN IsItemFound
;
2891 UINT32 ItemDataSize
;
2900 Status
= SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE
);
2901 if (EFI_ERROR (Status
)) {
2906 // Get original signature list data.
2909 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, NULL
, &DataSize
, NULL
);
2910 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
2914 OldData
= (UINT8
*) AllocateZeroPool (DataSize
);
2915 if (OldData
== NULL
) {
2916 Status
= EFI_OUT_OF_RESOURCES
;
2920 Status
= gRT
->GetVariable (VariableName
, VendorGuid
, &Attr
, &DataSize
, OldData
);
2921 if (EFI_ERROR(Status
)) {
2926 // Allocate space for new variable.
2928 Data
= (UINT8
*) AllocateZeroPool (DataSize
);
2930 Status
= EFI_OUT_OF_RESOURCES
;
2935 // Enumerate all signature data and erasing the target item.
2937 IsItemFound
= FALSE
;
2938 ItemDataSize
= (UINT32
) DataSize
;
2939 CertList
= (EFI_SIGNATURE_LIST
*) OldData
;
2942 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
2943 if (CompareGuid (&CertList
->SignatureType
, &gEfiCertRsa2048Guid
) ||
2944 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Guid
) ||
2945 CompareGuid (&CertList
->SignatureType
, &gEfiCertSha1Guid
) ||
2946 CompareGuid (&CertList
->SignatureType
, &gEfiCertSha256Guid
) ||
2947 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha256Guid
) ||
2948 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha384Guid
) ||
2949 CompareGuid (&CertList
->SignatureType
, &gEfiCertX509Sha512Guid
)
2952 // Copy EFI_SIGNATURE_LIST header then calculate the signature count in this list.
2954 CopyMem (Data
+ Offset
, CertList
, (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
));
2955 NewCertList
= (EFI_SIGNATURE_LIST
*) (Data
+ Offset
);
2956 Offset
+= (sizeof(EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2957 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) CertList
+ sizeof (EFI_SIGNATURE_LIST
) + CertList
->SignatureHeaderSize
);
2958 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
2959 for (Index
= 0; Index
< CertCount
; Index
++) {
2960 if (GuidIndex
== DeleteIndex
) {
2962 // Find it! Skip it!
2964 NewCertList
->SignatureListSize
-= CertList
->SignatureSize
;
2968 // This item doesn't match. Copy it to the Data buffer.
2970 CopyMem (Data
+ Offset
, (UINT8
*)(Cert
), CertList
->SignatureSize
);
2971 Offset
+= CertList
->SignatureSize
;
2974 Cert
= (EFI_SIGNATURE_DATA
*) ((UINT8
*) Cert
+ CertList
->SignatureSize
);
2978 // This List doesn't match. Just copy it to the Data buffer.
2980 CopyMem (Data
+ Offset
, (UINT8
*)(CertList
), CertList
->SignatureListSize
);
2981 Offset
+= CertList
->SignatureListSize
;
2984 ItemDataSize
-= CertList
->SignatureListSize
;
2985 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
2990 // Doesn't find the signature Item!
2992 Status
= EFI_NOT_FOUND
;
2997 // Delete the EFI_SIGNATURE_LIST header if there is no signature in the list.
2999 ItemDataSize
= Offset
;
3000 CertList
= (EFI_SIGNATURE_LIST
*) Data
;
3002 ZeroMem (OldData
, ItemDataSize
);
3003 while ((ItemDataSize
> 0) && (ItemDataSize
>= CertList
->SignatureListSize
)) {
3004 CertCount
= (CertList
->SignatureListSize
- sizeof (EFI_SIGNATURE_LIST
) - CertList
->SignatureHeaderSize
) / CertList
->SignatureSize
;
3005 DEBUG ((DEBUG_INFO
, " CertCount = %x\n", CertCount
));
3006 if (CertCount
!= 0) {
3007 CopyMem (OldData
+ Offset
, (UINT8
*)(CertList
), CertList
->SignatureListSize
);
3008 Offset
+= CertList
->SignatureListSize
;
3010 ItemDataSize
-= CertList
->SignatureListSize
;
3011 CertList
= (EFI_SIGNATURE_LIST
*) ((UINT8
*) CertList
+ CertList
->SignatureListSize
);
3015 if ((Attr
& EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
) != 0) {
3016 Status
= CreateTimeBasedPayload (&DataSize
, &OldData
);
3017 if (EFI_ERROR (Status
)) {
3018 DEBUG ((EFI_D_ERROR
, "Fail to create time-based data payload: %r", Status
));
3023 Status
= gRT
->SetVariable(
3030 if (EFI_ERROR (Status
)) {
3031 DEBUG ((DEBUG_ERROR
, "Failed to set variable, Status = %r\n", Status
));
3040 if (OldData
!= NULL
) {
3044 return UpdateDeletePage (
3055 This function to delete signature list or data, according by DelType.
3057 @param[in] PrivateData Module's private data.
3058 @param[in] DelType Indicate delete signature list or data.
3059 @param[in] CheckedCount Indicate how many signature data have
3060 been checked in current signature list.
3062 @retval EFI_SUCCESS Success to update the signature list page
3063 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
3067 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
3068 IN SIGNATURE_DELETE_TYPE DelType
,
3069 IN UINT32 CheckedCount
3073 EFI_SIGNATURE_LIST
*ListWalker
;
3074 EFI_SIGNATURE_LIST
*NewCertList
;
3075 EFI_SIGNATURE_DATA
*DataWalker
;
3076 CHAR16
*VariableName
;
3077 UINT32 VariableAttr
;
3078 UINTN VariableDataSize
;
3079 UINTN RemainingSize
;
3083 UINT8
*VariableData
;
3084 UINT8
*NewVariableData
;
3086 Status
= EFI_SUCCESS
;
3087 VariableName
= NULL
;
3089 VariableDataSize
= 0;
3092 VariableData
= NULL
;
3093 NewVariableData
= NULL
;
3095 VariableName
= AllocateZeroPool (100);
3096 if (VariableName
== NULL
) {
3097 Status
= EFI_OUT_OF_RESOURCES
;
3101 if (PrivateData
->VariableName
== VARIABLE_DB
) {
3102 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE
);
3103 } else if (PrivateData
->VariableName
== VARIABLE_DBX
) {
3104 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE1
);
3105 } else if (PrivateData
->VariableName
== VARIABLE_DBT
) {
3106 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE2
);
3111 Status
= gRT
->GetVariable (
3113 &gEfiImageSecurityDatabaseGuid
,
3118 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
3122 VariableData
= AllocateZeroPool (VariableDataSize
);
3123 if (VariableData
== NULL
) {
3124 Status
= EFI_OUT_OF_RESOURCES
;
3128 Status
= gRT
->GetVariable (
3130 &gEfiImageSecurityDatabaseGuid
,
3135 if (EFI_ERROR (Status
)) {
3139 Status
= SetSecureBootMode (CUSTOM_SECURE_BOOT_MODE
);
3140 if (EFI_ERROR (Status
)) {
3144 NewVariableData
= AllocateZeroPool (VariableDataSize
);
3145 if (NewVariableData
== NULL
) {
3146 Status
= EFI_OUT_OF_RESOURCES
;
3150 RemainingSize
= VariableDataSize
;
3151 ListWalker
= (EFI_SIGNATURE_LIST
*)(VariableData
);
3152 if (DelType
== DELETE_SIGNATURE_LIST_ALL
) {
3153 VariableDataSize
= 0;
3155 while ((RemainingSize
> 0) && (RemainingSize
>= ListWalker
->SignatureListSize
) && ListIndex
< PrivateData
->ListIndex
) {
3156 CopyMem ((UINT8
*)NewVariableData
+ Offset
, ListWalker
, ListWalker
->SignatureListSize
);
3157 Offset
+= ListWalker
->SignatureListSize
;
3159 RemainingSize
-= ListWalker
->SignatureListSize
;
3160 ListWalker
= (EFI_SIGNATURE_LIST
*)((UINT8
*)ListWalker
+ ListWalker
->SignatureListSize
);
3164 if (CheckedCount
== SIGNATURE_DATA_COUNTS (ListWalker
) || DelType
== DELETE_SIGNATURE_LIST_ONE
) {
3165 RemainingSize
-= ListWalker
->SignatureListSize
;
3166 ListWalker
= (EFI_SIGNATURE_LIST
*)((UINT8
*)ListWalker
+ ListWalker
->SignatureListSize
);
3168 NewCertList
= (EFI_SIGNATURE_LIST
*)(NewVariableData
+ Offset
);
3172 CopyMem ((UINT8
*)NewVariableData
, ListWalker
, sizeof (EFI_SIGNATURE_LIST
) + ListWalker
->SignatureHeaderSize
);
3173 Offset
+= sizeof (EFI_SIGNATURE_LIST
) + ListWalker
->SignatureHeaderSize
;
3175 DataWalker
= (EFI_SIGNATURE_DATA
*)((UINT8
*)ListWalker
+ sizeof(EFI_SIGNATURE_LIST
) + ListWalker
->SignatureHeaderSize
);
3176 for (Index
= 0; Index
< SIGNATURE_DATA_COUNTS(ListWalker
); Index
= Index
+ 1) {
3177 if (PrivateData
->CheckArray
[Index
]) {
3179 // Delete checked signature data, and update the size of whole signature list.
3181 NewCertList
->SignatureListSize
-= NewCertList
->SignatureSize
;
3184 // Remain the unchecked signature data.
3186 CopyMem ((UINT8
*)NewVariableData
+ Offset
, DataWalker
, ListWalker
->SignatureSize
);
3187 Offset
+= ListWalker
->SignatureSize
;
3189 DataWalker
= (EFI_SIGNATURE_DATA
*)((UINT8
*)DataWalker
+ ListWalker
->SignatureSize
);
3192 RemainingSize
-= ListWalker
->SignatureListSize
;
3196 // Copy remaining data, maybe 0.
3198 CopyMem((UINT8
*)NewVariableData
+ Offset
, ListWalker
, RemainingSize
);
3199 Offset
+= RemainingSize
;
3201 VariableDataSize
= Offset
;
3204 if ((VariableAttr
& EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
) != 0) {
3205 Status
= CreateTimeBasedPayload (&VariableDataSize
, &NewVariableData
);
3206 if (EFI_ERROR (Status
)) {
3207 DEBUG ((DEBUG_ERROR
, "Fail to create time-based data payload: %r", Status
));
3212 Status
= gRT
->SetVariable (
3214 &gEfiImageSecurityDatabaseGuid
,
3219 if (EFI_ERROR (Status
)) {
3220 DEBUG ((DEBUG_ERROR
, "Failed to set variable, Status = %r", Status
));
3225 SECUREBOOT_FREE_NON_NULL (VariableName
);
3226 SECUREBOOT_FREE_NON_NULL (VariableData
);
3227 SECUREBOOT_FREE_NON_NULL (NewVariableData
);
3234 Update SecureBoot strings based on new Secure Boot Mode State. String includes STR_SECURE_BOOT_STATE_CONTENT
3235 and STR_CUR_SECURE_BOOT_MODE_CONTENT.
3237 @param[in] PrivateData Module's private data.
3239 @return EFI_SUCCESS Update secure boot strings successfully.
3240 @return other Fail to update secure boot strings.
3244 UpdateSecureBootString(
3245 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
3253 // Get current secure boot state.
3255 GetVariable2 (EFI_SECURE_BOOT_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SecureBoot
, NULL
);
3256 if (SecureBoot
== NULL
) {
3257 return EFI_NOT_FOUND
;
3260 if (*SecureBoot
== SECURE_BOOT_MODE_ENABLE
) {
3261 HiiSetString (Private
->HiiHandle
, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT
), L
"Enabled", NULL
);
3263 HiiSetString (Private
->HiiHandle
, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT
), L
"Disabled", NULL
);
3266 FreePool(SecureBoot
);
3272 This function extracts configuration from variable.
3274 @param[in] Private Point to SecureBoot configuration driver private data.
3275 @param[in, out] ConfigData Point to SecureBoot configuration private data.
3279 SecureBootExtractConfigFromVariable (
3280 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
,
3281 IN OUT SECUREBOOT_CONFIGURATION
*ConfigData
3284 UINT8
*SecureBootEnable
;
3286 UINT8
*SecureBootMode
;
3289 SecureBootEnable
= NULL
;
3291 SecureBootMode
= NULL
;
3294 // Initilize the Date and Time using system time.
3296 ConfigData
->CertificateFormat
= HASHALG_RAW
;
3297 ConfigData
->AlwaysRevocation
= TRUE
;
3298 gRT
->GetTime (&CurrTime
, NULL
);
3299 ConfigData
->RevocationDate
.Year
= CurrTime
.Year
;
3300 ConfigData
->RevocationDate
.Month
= CurrTime
.Month
;
3301 ConfigData
->RevocationDate
.Day
= CurrTime
.Day
;
3302 ConfigData
->RevocationTime
.Hour
= CurrTime
.Hour
;
3303 ConfigData
->RevocationTime
.Minute
= CurrTime
.Minute
;
3304 ConfigData
->RevocationTime
.Second
= 0;
3305 if (Private
->FileContext
->FHandle
!= NULL
) {
3306 ConfigData
->FileEnrollType
= Private
->FileContext
->FileType
;
3308 ConfigData
->FileEnrollType
= UNKNOWN_FILE_TYPE
;
3312 // If it is Physical Presence User, set the PhysicalPresent to true.
3314 if (UserPhysicalPresent()) {
3315 ConfigData
->PhysicalPresent
= TRUE
;
3317 ConfigData
->PhysicalPresent
= FALSE
;
3321 // If there is no PK then the Delete Pk button will be gray.
3323 GetVariable2 (EFI_SETUP_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SetupMode
, NULL
);
3324 if (SetupMode
== NULL
|| (*SetupMode
) == SETUP_MODE
) {
3325 ConfigData
->HasPk
= FALSE
;
3327 ConfigData
->HasPk
= TRUE
;
3331 // Check SecureBootEnable & Pk status, fix the inconsistence.
3332 // If the SecureBootEnable Variable doesn't exist, hide the SecureBoot Enable/Disable
3335 ConfigData
->AttemptSecureBoot
= FALSE
;
3336 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
3339 // Fix Pk, SecureBootEnable inconsistence
3341 if ((SetupMode
!= NULL
) && (*SetupMode
) == USER_MODE
) {
3342 ConfigData
->HideSecureBoot
= FALSE
;
3343 if ((SecureBootEnable
!= NULL
) && (*SecureBootEnable
== SECURE_BOOT_ENABLE
)) {
3344 ConfigData
->AttemptSecureBoot
= TRUE
;
3347 ConfigData
->HideSecureBoot
= TRUE
;
3351 // Get the SecureBootMode from CustomMode variable.
3353 GetVariable2 (EFI_CUSTOM_MODE_NAME
, &gEfiCustomModeEnableGuid
, (VOID
**)&SecureBootMode
, NULL
);
3354 if (SecureBootMode
== NULL
) {
3355 ConfigData
->SecureBootMode
= STANDARD_SECURE_BOOT_MODE
;
3357 ConfigData
->SecureBootMode
= *(SecureBootMode
);
3360 if (SecureBootEnable
!= NULL
) {
3361 FreePool (SecureBootEnable
);
3363 if (SetupMode
!= NULL
) {
3364 FreePool (SetupMode
);
3366 if (SecureBootMode
!= NULL
) {
3367 FreePool (SecureBootMode
);
3372 This function allows a caller to extract the current configuration for one
3373 or more named elements from the target driver.
3375 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
3376 @param[in] Request A null-terminated Unicode string in
3377 <ConfigRequest> format.
3378 @param[out] Progress On return, points to a character in the Request
3379 string. Points to the string's null terminator if
3380 request was successful. Points to the most recent
3381 '&' before the first failing name/value pair (or
3382 the beginning of the string if the failure is in
3383 the first name/value pair) if the request was not
3385 @param[out] Results A null-terminated Unicode string in
3386 <ConfigAltResp> format which has all values filled
3387 in for the names in the Request string. String to
3388 be allocated by the called function.
3390 @retval EFI_SUCCESS The Results is filled with the requested values.
3391 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.
3392 @retval EFI_INVALID_PARAMETER Request is illegal syntax, or unknown name.
3393 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this
3399 SecureBootExtractConfig (
3400 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
3401 IN CONST EFI_STRING Request
,
3402 OUT EFI_STRING
*Progress
,
3403 OUT EFI_STRING
*Results
3409 SECUREBOOT_CONFIGURATION Configuration
;
3410 EFI_STRING ConfigRequest
;
3411 EFI_STRING ConfigRequestHdr
;
3412 SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
;
3413 BOOLEAN AllocatedRequest
;
3415 if (Progress
== NULL
|| Results
== NULL
) {
3416 return EFI_INVALID_PARAMETER
;
3419 AllocatedRequest
= FALSE
;
3420 ConfigRequestHdr
= NULL
;
3421 ConfigRequest
= NULL
;
3424 ZeroMem (&Configuration
, sizeof (Configuration
));
3425 PrivateData
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
3426 *Progress
= Request
;
3428 if ((Request
!= NULL
) && !HiiIsConfigHdrMatch (Request
, &gSecureBootConfigFormSetGuid
, mSecureBootStorageName
)) {
3429 return EFI_NOT_FOUND
;
3432 ZeroMem(&Configuration
, sizeof(SECUREBOOT_CONFIGURATION
));
3435 // Get Configuration from Variable.
3437 SecureBootExtractConfigFromVariable (PrivateData
, &Configuration
);
3439 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
3440 ConfigRequest
= Request
;
3441 if ((Request
== NULL
) || (StrStr (Request
, L
"OFFSET") == NULL
)) {
3443 // Request is set to NULL or OFFSET is NULL, construct full request string.
3445 // Allocate and fill a buffer large enough to hold the <ConfigHdr> template
3446 // followed by "&OFFSET=0&WIDTH=WWWWWWWWWWWWWWWW" followed by a Null-terminator
3448 ConfigRequestHdr
= HiiConstructConfigHdr (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, PrivateData
->DriverHandle
);
3449 Size
= (StrLen (ConfigRequestHdr
) + 32 + 1) * sizeof (CHAR16
);
3450 ConfigRequest
= AllocateZeroPool (Size
);
3451 ASSERT (ConfigRequest
!= NULL
);
3452 AllocatedRequest
= TRUE
;
3453 UnicodeSPrint (ConfigRequest
, Size
, L
"%s&OFFSET=0&WIDTH=%016LX", ConfigRequestHdr
, (UINT64
)BufferSize
);
3454 FreePool (ConfigRequestHdr
);
3455 ConfigRequestHdr
= NULL
;
3458 Status
= gHiiConfigRouting
->BlockToConfig (
3461 (UINT8
*) &Configuration
,
3468 // Free the allocated config request string.
3470 if (AllocatedRequest
) {
3471 FreePool (ConfigRequest
);
3475 // Set Progress string to the original request string.
3477 if (Request
== NULL
) {
3479 } else if (StrStr (Request
, L
"OFFSET") == NULL
) {
3480 *Progress
= Request
+ StrLen (Request
);
3487 This function processes the results of changes in configuration.
3489 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
3490 @param[in] Configuration A null-terminated Unicode string in <ConfigResp>
3492 @param[out] Progress A pointer to a string filled in with the offset of
3493 the most recent '&' before the first failing
3494 name/value pair (or the beginning of the string if
3495 the failure is in the first name/value pair) or
3496 the terminating NULL if all was successful.
3498 @retval EFI_SUCCESS The Results is processed successfully.
3499 @retval EFI_INVALID_PARAMETER Configuration is NULL.
3500 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this
3506 SecureBootRouteConfig (
3507 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
3508 IN CONST EFI_STRING Configuration
,
3509 OUT EFI_STRING
*Progress
3512 SECUREBOOT_CONFIGURATION IfrNvData
;
3514 SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
;
3517 if (Configuration
== NULL
|| Progress
== NULL
) {
3518 return EFI_INVALID_PARAMETER
;
3521 *Progress
= Configuration
;
3522 if (!HiiIsConfigHdrMatch (Configuration
, &gSecureBootConfigFormSetGuid
, mSecureBootStorageName
)) {
3523 return EFI_NOT_FOUND
;
3526 PrivateData
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
3529 // Get Configuration from Variable.
3531 SecureBootExtractConfigFromVariable (PrivateData
, &IfrNvData
);
3534 // Map the Configuration to the configuration block.
3536 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
3537 Status
= gHiiConfigRouting
->ConfigToBlock (
3540 (UINT8
*)&IfrNvData
,
3544 if (EFI_ERROR (Status
)) {
3549 // Store Buffer Storage back to EFI variable if needed
3551 if (!IfrNvData
.HideSecureBoot
) {
3552 Status
= SaveSecureBootVariable (IfrNvData
.AttemptSecureBoot
);
3553 if (EFI_ERROR (Status
)) {
3558 *Progress
= Configuration
+ StrLen (Configuration
);
3563 This function to load signature list, the update the menu page.
3565 @param[in] PrivateData Module's private data.
3566 @param[in] LabelId Label number to insert opcodes.
3567 @param[in] FormId Form ID of current page.
3568 @param[in] QuestionIdBase Base question id of the signature list.
3570 @retval EFI_SUCCESS Success to update the signature list page
3571 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
3575 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
3577 IN EFI_FORM_ID FormId
,
3578 IN EFI_QUESTION_ID QuestionIdBase
3582 EFI_STRING_ID ListType
;
3583 EFI_SIGNATURE_LIST
*ListWalker
;
3584 EFI_IFR_GUID_LABEL
*StartLabel
;
3585 EFI_IFR_GUID_LABEL
*EndLabel
;
3586 EFI_IFR_GUID_LABEL
*StartGoto
;
3587 EFI_IFR_GUID_LABEL
*EndGoto
;
3588 EFI_FORM_ID DstFormId
;
3589 VOID
*StartOpCodeHandle
;
3590 VOID
*EndOpCodeHandle
;
3591 VOID
*StartGotoHandle
;
3592 VOID
*EndGotoHandle
;
3594 UINTN RemainingSize
;
3596 UINT8
*VariableData
;
3597 CHAR16
*VariableName
;
3601 Status
= EFI_SUCCESS
;
3602 StartOpCodeHandle
= NULL
;
3603 EndOpCodeHandle
= NULL
;
3604 StartGotoHandle
= NULL
;
3605 EndGotoHandle
= NULL
;
3607 VariableData
= NULL
;
3608 VariableName
= NULL
;
3613 // Initialize the container for dynamic opcodes.
3615 StartOpCodeHandle
= HiiAllocateOpCodeHandle ();
3616 if (StartOpCodeHandle
== NULL
) {
3617 Status
= EFI_OUT_OF_RESOURCES
;
3621 EndOpCodeHandle
= HiiAllocateOpCodeHandle ();
3622 if (EndOpCodeHandle
== NULL
) {
3623 Status
= EFI_OUT_OF_RESOURCES
;
3627 StartGotoHandle
= HiiAllocateOpCodeHandle ();
3628 if (StartGotoHandle
== NULL
) {
3629 Status
= EFI_OUT_OF_RESOURCES
;
3633 EndGotoHandle
= HiiAllocateOpCodeHandle ();
3634 if (EndGotoHandle
== NULL
) {
3635 Status
= EFI_OUT_OF_RESOURCES
;
3640 // Create Hii Extend Label OpCode.
3642 StartLabel
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode (
3646 sizeof (EFI_IFR_GUID_LABEL
)
3648 StartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3649 StartLabel
->Number
= LabelId
;
3651 EndLabel
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode (
3655 sizeof (EFI_IFR_GUID_LABEL
)
3657 EndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3658 EndLabel
->Number
= LABEL_END
;
3660 StartGoto
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode(
3664 sizeof(EFI_IFR_GUID_LABEL
)
3666 StartGoto
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3667 StartGoto
->Number
= LABEL_DELETE_ALL_LIST_BUTTON
;
3669 EndGoto
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode(
3673 sizeof(EFI_IFR_GUID_LABEL
)
3675 EndGoto
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
3676 EndGoto
->Number
= LABEL_END
;
3678 VariableName
= AllocateZeroPool (100);
3679 if (VariableName
== NULL
) {
3680 Status
= EFI_OUT_OF_RESOURCES
;
3684 if (PrivateData
->VariableName
== VARIABLE_DB
) {
3685 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE
);
3686 DstFormId
= FORMID_SECURE_BOOT_DB_OPTION_FORM
;
3687 } else if (PrivateData
->VariableName
== VARIABLE_DBX
) {
3688 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE1
);
3689 DstFormId
= FORMID_SECURE_BOOT_DBX_OPTION_FORM
;
3690 } else if (PrivateData
->VariableName
== VARIABLE_DBT
) {
3691 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE2
);
3692 DstFormId
= FORMID_SECURE_BOOT_DBT_OPTION_FORM
;
3697 HiiCreateGotoOpCode (
3700 STRING_TOKEN (STR_SECURE_BOOT_DELETE_ALL_LIST
),
3701 STRING_TOKEN (STR_SECURE_BOOT_DELETE_ALL_LIST
),
3702 EFI_IFR_FLAG_CALLBACK
,
3703 KEY_SECURE_BOOT_DELETE_ALL_LIST
3707 // Read Variable, the variable name save in the PrivateData->VariableName.
3710 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, VariableData
);
3711 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
3715 VariableData
= AllocateZeroPool (DataSize
);
3716 if (VariableData
== NULL
) {
3717 Status
= EFI_OUT_OF_RESOURCES
;
3720 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, VariableData
);
3721 if (EFI_ERROR (Status
)) {
3725 NameBuffer
= AllocateZeroPool (100);
3726 if (NameBuffer
== NULL
) {
3727 Status
= EFI_OUT_OF_RESOURCES
;
3731 HelpBuffer
= AllocateZeroPool (100);
3732 if (HelpBuffer
== NULL
) {
3733 Status
= EFI_OUT_OF_RESOURCES
;
3737 RemainingSize
= DataSize
;
3738 ListWalker
= (EFI_SIGNATURE_LIST
*)VariableData
;
3739 while ((RemainingSize
> 0) && (RemainingSize
>= ListWalker
->SignatureListSize
)) {
3740 if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertRsa2048Guid
)) {
3741 ListType
= STRING_TOKEN (STR_LIST_TYPE_RSA2048_SHA256
);
3742 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertX509Guid
)) {
3743 ListType
= STRING_TOKEN (STR_LIST_TYPE_X509
);
3744 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertSha1Guid
)) {
3745 ListType
= STRING_TOKEN (STR_LIST_TYPE_SHA1
);
3746 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertSha256Guid
)) {
3747 ListType
= STRING_TOKEN (STR_LIST_TYPE_SHA256
);
3748 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
3749 ListType
= STRING_TOKEN (STR_LIST_TYPE_X509_SHA256
);
3750 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
3751 ListType
= STRING_TOKEN (STR_LIST_TYPE_X509_SHA384
);
3752 } else if (CompareGuid (&ListWalker
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
3753 ListType
= STRING_TOKEN (STR_LIST_TYPE_X509_SHA512
);
3755 ListType
= STRING_TOKEN (STR_LIST_TYPE_UNKNOWN
);
3758 UnicodeSPrint (NameBuffer
,
3760 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_LIST_NAME_FORMAT
), NULL
),
3763 UnicodeSPrint (HelpBuffer
,
3765 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_LIST_HELP_FORMAT
), NULL
),
3766 HiiGetString (PrivateData
->HiiHandle
, ListType
, NULL
),
3767 SIGNATURE_DATA_COUNTS (ListWalker
)
3770 HiiCreateGotoOpCode (
3772 SECUREBOOT_DELETE_SIGNATURE_DATA_FORM
,
3773 HiiSetString (PrivateData
->HiiHandle
, 0, NameBuffer
, NULL
),
3774 HiiSetString (PrivateData
->HiiHandle
, 0, HelpBuffer
, NULL
),
3775 EFI_IFR_FLAG_CALLBACK
,
3776 QuestionIdBase
+ Index
++
3779 ZeroMem (NameBuffer
, 100);
3780 ZeroMem (HelpBuffer
, 100);
3782 RemainingSize
-= ListWalker
->SignatureListSize
;
3783 ListWalker
= (EFI_SIGNATURE_LIST
*)((UINT8
*)ListWalker
+ ListWalker
->SignatureListSize
);
3788 PrivateData
->HiiHandle
,
3789 &gSecureBootConfigFormSetGuid
,
3796 PrivateData
->HiiHandle
,
3797 &gSecureBootConfigFormSetGuid
,
3803 SECUREBOOT_FREE_NON_OPCODE (StartOpCodeHandle
);
3804 SECUREBOOT_FREE_NON_OPCODE (EndOpCodeHandle
);
3805 SECUREBOOT_FREE_NON_OPCODE (StartGotoHandle
);
3806 SECUREBOOT_FREE_NON_OPCODE (EndGotoHandle
);
3808 SECUREBOOT_FREE_NON_NULL (VariableName
);
3809 SECUREBOOT_FREE_NON_NULL (VariableData
);
3810 SECUREBOOT_FREE_NON_NULL (NameBuffer
);
3811 SECUREBOOT_FREE_NON_NULL (HelpBuffer
);
3813 PrivateData
->ListCount
= Index
;
3819 Parse hash value from EFI_SIGNATURE_DATA, and save in the CHAR16 type array.
3820 The buffer is callee allocated and should be freed by the caller.
3822 @param[in] ListEntry The pointer point to the signature list.
3823 @param[in] DataEntry The signature data we are processing.
3824 @param[out] BufferToReturn Buffer to save the hash value.
3826 @retval EFI_INVALID_PARAMETER Invalid List or Data or Buffer.
3827 @retval EFI_OUT_OF_RESOURCES A memory allocation failed.
3828 @retval EFI_SUCCESS Operation success.
3832 IN EFI_SIGNATURE_LIST
*ListEntry
,
3833 IN EFI_SIGNATURE_DATA
*DataEntry
,
3834 OUT CHAR16
**BufferToReturn
3845 // Assume that, display 8 bytes in one line.
3849 if (ListEntry
== NULL
|| DataEntry
== NULL
|| BufferToReturn
== NULL
) {
3850 return EFI_INVALID_PARAMETER
;
3853 DataSize
= ListEntry
->SignatureSize
- sizeof(EFI_GUID
);
3854 Line
= (DataSize
+ OneLineBytes
- 1) / OneLineBytes
;
3857 // Each byte will split two Hex-number, and each line need additional memory to save '\r\n'.
3859 TotalSize
= ((DataSize
+ Line
) * 2 * sizeof(CHAR16
));
3861 *BufferToReturn
= AllocateZeroPool(TotalSize
);
3862 if (*BufferToReturn
== NULL
) {
3863 return EFI_OUT_OF_RESOURCES
;
3866 for (Index
= 0, BufferIndex
= 0; Index
< DataSize
; Index
= Index
+ 1) {
3867 if ((Index
> 0) && (Index
% OneLineBytes
== 0)) {
3868 BufferIndex
+= UnicodeSPrint(&(*BufferToReturn
)[BufferIndex
], TotalSize
- sizeof(CHAR16
) * BufferIndex
, L
"\n");
3870 BufferIndex
+= UnicodeSPrint(&(*BufferToReturn
)[BufferIndex
], TotalSize
- sizeof(CHAR16
) * BufferIndex
, L
"%02x", DataEntry
->SignatureData
[Index
]);
3872 BufferIndex
+= UnicodeSPrint(&(*BufferToReturn
)[BufferIndex
], TotalSize
- sizeof(CHAR16
) * BufferIndex
, L
"\n");
3878 Function to get the common name from the X509 format certificate.
3879 The buffer is callee allocated and should be freed by the caller.
3881 @param[in] ListEntry The pointer point to the signature list.
3882 @param[in] DataEntry The signature data we are processing.
3883 @param[out] BufferToReturn Buffer to save the CN of X509 certificate.
3885 @retval EFI_INVALID_PARAMETER Invalid List or Data or Buffer.
3886 @retval EFI_OUT_OF_RESOURCES A memory allocation failed.
3887 @retval EFI_SUCCESS Operation success.
3888 @retval EFI_NOT_FOUND Not found CN field in the X509 certificate.
3891 GetCommonNameFromX509 (
3892 IN EFI_SIGNATURE_LIST
*ListEntry
,
3893 IN EFI_SIGNATURE_DATA
*DataEntry
,
3894 OUT CHAR16
**BufferToReturn
3901 Status
= EFI_SUCCESS
;
3904 CNBuffer
= AllocateZeroPool(256);
3905 if (CNBuffer
== NULL
) {
3906 Status
= EFI_OUT_OF_RESOURCES
;
3912 (UINT8
*)DataEntry
+ sizeof(EFI_GUID
),
3913 ListEntry
->SignatureSize
- sizeof(EFI_GUID
),
3918 *BufferToReturn
= AllocateZeroPool(256 * sizeof(CHAR16
));
3919 if (*BufferToReturn
== NULL
) {
3920 Status
= EFI_OUT_OF_RESOURCES
;
3924 AsciiStrToUnicodeStrS (CNBuffer
, *BufferToReturn
, 256);
3927 SECUREBOOT_FREE_NON_NULL (CNBuffer
);
3933 Format the help info for the signature data, each help info contain 3 parts.
3935 2. Content, depends on the type of the signature list.
3938 @param[in] PrivateData Module's private data.
3939 @param[in] ListEntry Point to the signature list.
3940 @param[in] DataEntry Point to the signature data we are processing.
3941 @param[out] StringId Save the string id of help info.
3943 @retval EFI_SUCCESS Operation success.
3944 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
3948 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
3949 IN EFI_SIGNATURE_LIST
*ListEntry
,
3950 IN EFI_SIGNATURE_DATA
*DataEntry
,
3951 OUT EFI_STRING_ID
*StringId
3956 EFI_STRING_ID ListTypeId
;
3958 UINTN HelpInfoIndex
;
3963 CHAR16
*HelpInfoString
;
3966 Status
= EFI_SUCCESS
;
3972 HelpInfoString
= NULL
;
3975 if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertRsa2048Guid
)) {
3976 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_RSA2048_SHA256
);
3977 DataSize
= ListEntry
->SignatureSize
- sizeof(EFI_GUID
);
3979 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertX509Guid
)) {
3980 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_X509
);
3981 DataSize
= ListEntry
->SignatureSize
- sizeof(EFI_GUID
);
3983 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertSha1Guid
)) {
3984 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_SHA1
);
3986 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertSha256Guid
)) {
3987 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_SHA256
);
3989 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertX509Sha256Guid
)) {
3990 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_X509_SHA256
);
3992 Time
= (EFI_TIME
*)(DataEntry
->SignatureData
+ DataSize
);
3993 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertX509Sha384Guid
)) {
3994 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_X509_SHA384
);
3996 Time
= (EFI_TIME
*)(DataEntry
->SignatureData
+ DataSize
);
3997 } else if (CompareGuid(&ListEntry
->SignatureType
, &gEfiCertX509Sha512Guid
)) {
3998 ListTypeId
= STRING_TOKEN(STR_LIST_TYPE_X509_SHA512
);
4000 Time
= (EFI_TIME
*)(DataEntry
->SignatureData
+ DataSize
);
4002 Status
= EFI_UNSUPPORTED
;
4006 GuidString
= AllocateZeroPool (100);
4007 if (GuidString
== NULL
) {
4008 Status
= EFI_OUT_OF_RESOURCES
;
4013 HelpInfoString
= AllocateZeroPool (TotalSize
);
4014 if (HelpInfoString
== NULL
) {
4015 Status
= EFI_OUT_OF_RESOURCES
;
4020 // Format GUID part.
4022 GuidToString(&DataEntry
->SignatureOwner
, GuidString
, 100);
4023 HelpInfoIndex
+= UnicodeSPrint (
4024 &HelpInfoString
[HelpInfoIndex
],
4025 TotalSize
- sizeof(CHAR16
) * HelpInfoIndex
,
4026 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_DATA_HELP_FORMAT_GUID
), NULL
),
4031 // Format content part, it depends on the type of signature list, hash value or CN.
4034 GetCommonNameFromX509 (ListEntry
, DataEntry
, &DataString
);
4035 HelpInfoIndex
+= UnicodeSPrint(
4036 &HelpInfoString
[HelpInfoIndex
],
4037 TotalSize
- sizeof(CHAR16
) * HelpInfoIndex
,
4038 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_DATA_HELP_FORMAT_CN
), NULL
),
4039 HiiGetString (PrivateData
->HiiHandle
, ListTypeId
, NULL
),
4045 // Format hash value for each signature data entry.
4047 ParseHashValue (ListEntry
, DataEntry
, &DataString
);
4048 HelpInfoIndex
+= UnicodeSPrint (
4049 &HelpInfoString
[HelpInfoIndex
],
4050 TotalSize
- sizeof(CHAR16
) * HelpInfoIndex
,
4051 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_DATA_HELP_FORMAT_HASH
), NULL
),
4052 HiiGetString (PrivateData
->HiiHandle
, ListTypeId
, NULL
),
4059 // Format revocation time part.
4062 TimeString
= AllocateZeroPool(100);
4063 if (TimeString
== NULL
) {
4064 Status
= EFI_OUT_OF_RESOURCES
;
4071 L
"%d-%d-%d %d:%d:%d",
4081 &HelpInfoString
[HelpInfoIndex
],
4082 TotalSize
- sizeof (CHAR16
) * HelpInfoIndex
,
4083 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_DATA_HELP_FORMAT_TIME
), NULL
),
4088 *StringId
= HiiSetString (PrivateData
->HiiHandle
, 0, HelpInfoString
, NULL
);
4091 SECUREBOOT_FREE_NON_NULL (GuidString
);
4092 SECUREBOOT_FREE_NON_NULL (DataString
);
4093 SECUREBOOT_FREE_NON_NULL (TimeString
);
4094 SECUREBOOT_FREE_NON_NULL (HelpInfoString
);
4100 This functino to load signature data under the signature list.
4102 @param[in] PrivateData Module's private data.
4103 @param[in] LabelId Label number to insert opcodes.
4104 @param[in] FormId Form ID of current page.
4105 @param[in] QuestionIdBase Base question id of the signature list.
4106 @param[in] ListIndex Indicate to load which signature list.
4108 @retval EFI_SUCCESS Success to update the signature list page
4109 @retval EFI_OUT_OF_RESOURCES Unable to allocate required resources.
4113 IN SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
,
4115 IN EFI_FORM_ID FormId
,
4116 IN EFI_QUESTION_ID QuestionIdBase
,
4121 EFI_SIGNATURE_LIST
*ListWalker
;
4122 EFI_SIGNATURE_DATA
*DataWalker
;
4123 EFI_IFR_GUID_LABEL
*StartLabel
;
4124 EFI_IFR_GUID_LABEL
*EndLabel
;
4125 EFI_STRING_ID HelpStringId
;
4126 VOID
*StartOpCodeHandle
;
4127 VOID
*EndOpCodeHandle
;
4129 UINTN RemainingSize
;
4131 UINT8
*VariableData
;
4132 CHAR16
*VariableName
;
4135 Status
= EFI_SUCCESS
;
4136 StartOpCodeHandle
= NULL
;
4137 EndOpCodeHandle
= NULL
;
4139 VariableData
= NULL
;
4140 VariableName
= NULL
;
4144 // Initialize the container for dynamic opcodes.
4146 StartOpCodeHandle
= HiiAllocateOpCodeHandle ();
4147 if (StartOpCodeHandle
== NULL
) {
4148 Status
= EFI_OUT_OF_RESOURCES
;
4152 EndOpCodeHandle
= HiiAllocateOpCodeHandle ();
4153 if (EndOpCodeHandle
== NULL
) {
4154 Status
= EFI_OUT_OF_RESOURCES
;
4159 // Create Hii Extend Label OpCode.
4161 StartLabel
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode (
4165 sizeof (EFI_IFR_GUID_LABEL
)
4167 StartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
4168 StartLabel
->Number
= LabelId
;
4170 EndLabel
= (EFI_IFR_GUID_LABEL
*)HiiCreateGuidOpCode (
4174 sizeof (EFI_IFR_GUID_LABEL
)
4176 EndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
4177 EndLabel
->Number
= LABEL_END
;
4179 VariableName
= AllocateZeroPool (100);
4180 if (VariableName
== NULL
) {
4181 Status
= EFI_OUT_OF_RESOURCES
;
4185 if (PrivateData
->VariableName
== VARIABLE_DB
) {
4186 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE
);
4187 } else if (PrivateData
->VariableName
== VARIABLE_DBX
) {
4188 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE1
);
4189 } else if (PrivateData
->VariableName
== VARIABLE_DBT
) {
4190 UnicodeSPrint (VariableName
, 100, EFI_IMAGE_SECURITY_DATABASE2
);
4196 // Read Variable, the variable name save in the PrivateData->VariableName.
4199 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, VariableData
);
4200 if (EFI_ERROR (Status
) && Status
!= EFI_BUFFER_TOO_SMALL
) {
4204 VariableData
= AllocateZeroPool (DataSize
);
4205 if (VariableData
== NULL
) {
4206 Status
= EFI_OUT_OF_RESOURCES
;
4209 Status
= gRT
->GetVariable (VariableName
, &gEfiImageSecurityDatabaseGuid
, NULL
, &DataSize
, VariableData
);
4210 if (EFI_ERROR (Status
)) {
4214 NameBuffer
= AllocateZeroPool (100);
4215 if (NameBuffer
== NULL
) {
4216 Status
= EFI_OUT_OF_RESOURCES
;
4220 RemainingSize
= DataSize
;
4221 ListWalker
= (EFI_SIGNATURE_LIST
*)VariableData
;
4224 // Skip signature list.
4226 while ((RemainingSize
> 0) && (RemainingSize
>= ListWalker
->SignatureListSize
) && ListIndex
-- > 0) {
4227 RemainingSize
-= ListWalker
->SignatureListSize
;
4228 ListWalker
= (EFI_SIGNATURE_LIST
*)((UINT8
*)ListWalker
+ ListWalker
->SignatureListSize
);
4231 DataWalker
= (EFI_SIGNATURE_DATA
*)((UINT8
*)ListWalker
+ sizeof(EFI_SIGNATURE_LIST
) + ListWalker
->SignatureHeaderSize
);
4232 for (Index
= 0; Index
< SIGNATURE_DATA_COUNTS(ListWalker
); Index
= Index
+ 1) {
4234 // Format name buffer.
4236 UnicodeSPrint (NameBuffer
,
4238 HiiGetString (PrivateData
->HiiHandle
, STRING_TOKEN (STR_SIGNATURE_DATA_NAME_FORMAT
), NULL
),
4243 // Format help info buffer.
4245 Status
= FormatHelpInfo (PrivateData
, ListWalker
, DataWalker
, &HelpStringId
);
4246 if (EFI_ERROR (Status
)) {
4250 HiiCreateCheckBoxOpCode (
4252 (EFI_QUESTION_ID
)(QuestionIdBase
+ Index
),
4255 HiiSetString (PrivateData
->HiiHandle
, 0, NameBuffer
, NULL
),
4257 EFI_IFR_FLAG_CALLBACK
,
4262 ZeroMem(NameBuffer
, 100);
4263 DataWalker
= (EFI_SIGNATURE_DATA
*)((UINT8
*)DataWalker
+ ListWalker
->SignatureSize
);
4267 // Allocate a buffer to record which signature data will be checked.
4268 // This memory buffer will be freed when exit from the SECUREBOOT_DELETE_SIGNATURE_DATA_FORM form.
4270 PrivateData
->CheckArray
= AllocateZeroPool (SIGNATURE_DATA_COUNTS (ListWalker
) * sizeof (BOOLEAN
));
4274 PrivateData
->HiiHandle
,
4275 &gSecureBootConfigFormSetGuid
,
4281 SECUREBOOT_FREE_NON_OPCODE (StartOpCodeHandle
);
4282 SECUREBOOT_FREE_NON_OPCODE (EndOpCodeHandle
);
4284 SECUREBOOT_FREE_NON_NULL (VariableName
);
4285 SECUREBOOT_FREE_NON_NULL (VariableData
);
4286 SECUREBOOT_FREE_NON_NULL (NameBuffer
);
4292 This function is called to provide results data to the driver.
4294 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
4295 @param[in] Action Specifies the type of action taken by the browser.
4296 @param[in] QuestionId A unique value which is sent to the original
4297 exporting driver so that it can identify the type
4299 @param[in] Type The type of value for the question.
4300 @param[in] Value A pointer to the data being sent to the original
4302 @param[out] ActionRequest On return, points to the action requested by the
4305 @retval EFI_SUCCESS The callback successfully handled the action.
4306 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the
4307 variable and its data.
4308 @retval EFI_DEVICE_ERROR The variable could not be saved.
4309 @retval EFI_UNSUPPORTED The specified Action is not supported by the
4315 SecureBootCallback (
4316 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
4317 IN EFI_BROWSER_ACTION Action
,
4318 IN EFI_QUESTION_ID QuestionId
,
4320 IN EFI_IFR_TYPE_VALUE
*Value
,
4321 OUT EFI_BROWSER_ACTION_REQUEST
*ActionRequest
4326 RETURN_STATUS RStatus
;
4327 SECUREBOOT_CONFIG_PRIVATE_DATA
*Private
;
4329 SECUREBOOT_CONFIGURATION
*IfrNvData
;
4331 UINT8
*SecureBootEnable
;
4333 UINT8
*SecureBootMode
;
4335 CHAR16 PromptString
[100];
4336 EFI_DEVICE_PATH_PROTOCOL
*File
;
4338 UINT16
*FilePostFix
;
4339 SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
;
4341 Status
= EFI_SUCCESS
;
4342 SecureBootEnable
= NULL
;
4343 SecureBootMode
= NULL
;
4347 if ((This
== NULL
) || (Value
== NULL
) || (ActionRequest
== NULL
)) {
4348 return EFI_INVALID_PARAMETER
;
4351 Private
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
4353 gSecureBootPrivateData
= Private
;
4356 // Retrieve uncommitted data from Browser
4358 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
4359 IfrNvData
= AllocateZeroPool (BufferSize
);
4360 if (IfrNvData
== NULL
) {
4361 return EFI_OUT_OF_RESOURCES
;
4364 HiiGetBrowserData (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, BufferSize
, (UINT8
*) IfrNvData
);
4366 if (Action
== EFI_BROWSER_ACTION_FORM_OPEN
) {
4367 if (QuestionId
== KEY_SECURE_BOOT_MODE
) {
4369 // Update secure boot strings when opening this form
4371 Status
= UpdateSecureBootString(Private
);
4372 SecureBootExtractConfigFromVariable (Private
, IfrNvData
);
4373 mIsEnterSecureBootForm
= TRUE
;
4376 // When entering SecureBoot OPTION Form
4377 // always close opened file & free resource
4379 if ((QuestionId
== KEY_SECURE_BOOT_PK_OPTION
) ||
4380 (QuestionId
== KEY_SECURE_BOOT_KEK_OPTION
) ||
4381 (QuestionId
== KEY_SECURE_BOOT_DB_OPTION
) ||
4382 (QuestionId
== KEY_SECURE_BOOT_DBX_OPTION
) ||
4383 (QuestionId
== KEY_SECURE_BOOT_DBT_OPTION
)) {
4384 CloseEnrolledFile(Private
->FileContext
);
4385 } else if (QuestionId
== KEY_SECURE_BOOT_DELETE_ALL_LIST
) {
4387 // Update ListCount field in varstore
4388 // Button "Delete All Signature List" is
4389 // enable when ListCount is greater than 0.
4391 IfrNvData
->ListCount
= Private
->ListCount
;
4397 if (Action
== EFI_BROWSER_ACTION_RETRIEVE
) {
4398 Status
= EFI_UNSUPPORTED
;
4399 if (QuestionId
== KEY_SECURE_BOOT_MODE
) {
4400 if (mIsEnterSecureBootForm
) {
4401 Value
->u8
= SECURE_BOOT_MODE_STANDARD
;
4402 Status
= EFI_SUCCESS
;
4408 if ((Action
!= EFI_BROWSER_ACTION_CHANGED
) &&
4409 (Action
!= EFI_BROWSER_ACTION_CHANGING
) &&
4410 (Action
!= EFI_BROWSER_ACTION_FORM_CLOSE
) &&
4411 (Action
!= EFI_BROWSER_ACTION_DEFAULT_STANDARD
)) {
4412 Status
= EFI_UNSUPPORTED
;
4416 if (Action
== EFI_BROWSER_ACTION_CHANGING
) {
4418 switch (QuestionId
) {
4419 case KEY_SECURE_BOOT_ENABLE
:
4420 GetVariable2 (EFI_SECURE_BOOT_ENABLE_NAME
, &gEfiSecureBootEnableDisableGuid
, (VOID
**)&SecureBootEnable
, NULL
);
4421 if (NULL
!= SecureBootEnable
) {
4422 FreePool (SecureBootEnable
);
4423 if (EFI_ERROR (SaveSecureBootVariable (Value
->u8
))) {
4425 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4427 L
"Only Physical Presence User could disable secure boot!",
4430 Status
= EFI_UNSUPPORTED
;
4433 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4435 L
"Configuration changed, please reset the platform to take effect!",
4442 case KEY_SECURE_BOOT_KEK_OPTION
:
4443 case KEY_SECURE_BOOT_DB_OPTION
:
4444 case KEY_SECURE_BOOT_DBX_OPTION
:
4445 case KEY_SECURE_BOOT_DBT_OPTION
:
4446 PrivateData
= SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This
);
4448 // Clear Signature GUID.
4450 ZeroMem (IfrNvData
->SignatureGuid
, sizeof (IfrNvData
->SignatureGuid
));
4451 if (Private
->SignatureGUID
== NULL
) {
4452 Private
->SignatureGUID
= (EFI_GUID
*) AllocateZeroPool (sizeof (EFI_GUID
));
4453 if (Private
->SignatureGUID
== NULL
) {
4454 return EFI_OUT_OF_RESOURCES
;
4459 // Cleanup VFRData once leaving PK/KEK/DB/DBX/DBT enroll/delete page
4461 SecureBootExtractConfigFromVariable (PrivateData
, IfrNvData
);
4463 if (QuestionId
== KEY_SECURE_BOOT_DB_OPTION
) {
4464 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DB
;
4465 } else if (QuestionId
== KEY_SECURE_BOOT_DBX_OPTION
) {
4466 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DBX
;
4467 } else if (QuestionId
== KEY_SECURE_BOOT_DBT_OPTION
) {
4468 LabelId
= SECUREBOOT_ENROLL_SIGNATURE_TO_DBT
;
4470 LabelId
= FORMID_ENROLL_KEK_FORM
;
4474 // Refresh selected file.
4476 CleanUpPage (LabelId
, Private
);
4478 case KEY_SECURE_BOOT_PK_OPTION
:
4479 LabelId
= FORMID_ENROLL_PK_FORM
;
4481 // Refresh selected file.
4483 CleanUpPage (LabelId
, Private
);
4486 case FORMID_ENROLL_PK_FORM
:
4487 ChooseFile (NULL
, NULL
, UpdatePKFromFile
, &File
);
4490 case FORMID_ENROLL_KEK_FORM
:
4491 ChooseFile (NULL
, NULL
, UpdateKEKFromFile
, &File
);
4494 case SECUREBOOT_ENROLL_SIGNATURE_TO_DB
:
4495 ChooseFile (NULL
, NULL
, UpdateDBFromFile
, &File
);
4498 case SECUREBOOT_ENROLL_SIGNATURE_TO_DBX
:
4499 ChooseFile (NULL
, NULL
, UpdateDBXFromFile
, &File
);
4501 if (Private
->FileContext
->FHandle
!= NULL
) {
4503 // Parse the file's postfix.
4505 NameLength
= StrLen (Private
->FileContext
->FileName
);
4506 if (NameLength
<= 4) {
4509 FilePostFix
= Private
->FileContext
->FileName
+ NameLength
- 4;
4511 if (IsDerEncodeCertificate (FilePostFix
)) {
4513 // Supports DER-encoded X509 certificate.
4515 IfrNvData
->FileEnrollType
= X509_CERT_FILE_TYPE
;
4516 } else if (IsAuthentication2Format(Private
->FileContext
->FHandle
)){
4517 IfrNvData
->FileEnrollType
= AUTHENTICATION_2_FILE_TYPE
;
4519 IfrNvData
->FileEnrollType
= PE_IMAGE_FILE_TYPE
;
4521 Private
->FileContext
->FileType
= IfrNvData
->FileEnrollType
;
4524 // Clean up Certificate Format if File type is not X509 DER
4526 if (IfrNvData
->FileEnrollType
!= X509_CERT_FILE_TYPE
) {
4527 IfrNvData
->CertificateFormat
= HASHALG_RAW
;
4529 DEBUG((DEBUG_ERROR
, "IfrNvData->FileEnrollType %d\n", Private
->FileContext
->FileType
));
4534 case SECUREBOOT_ENROLL_SIGNATURE_TO_DBT
:
4535 ChooseFile (NULL
, NULL
, UpdateDBTFromFile
, &File
);
4538 case KEY_SECURE_BOOT_DELETE_PK
:
4541 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4543 L
"Are you sure you want to delete PK? Secure boot will be disabled!",
4544 L
"Press 'Y' to delete PK and exit, 'N' to discard change and return",
4547 if (Key
.UnicodeChar
== 'y' || Key
.UnicodeChar
== 'Y') {
4548 Status
= DeletePlatformKey ();
4549 if (EFI_ERROR (Status
)) {
4551 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4553 L
"Only Physical Presence User could delete PK in custom mode!",
4561 case KEY_DELETE_KEK
:
4564 EFI_KEY_EXCHANGE_KEY_NAME
,
4565 &gEfiGlobalVariableGuid
,
4567 FORMID_DELETE_KEK_FORM
,
4568 OPTION_DEL_KEK_QUESTION_ID
4572 case SECUREBOOT_DELETE_SIGNATURE_FROM_DB
:
4575 EFI_IMAGE_SECURITY_DATABASE
,
4576 &gEfiImageSecurityDatabaseGuid
,
4578 SECUREBOOT_DELETE_SIGNATURE_FROM_DB
,
4579 OPTION_DEL_DB_QUESTION_ID
4584 // From DBX option to the level-1 form, display signature list.
4586 case KEY_VALUE_FROM_DBX_TO_LIST_FORM
:
4587 Private
->VariableName
= VARIABLE_DBX
;
4590 LABEL_SIGNATURE_LIST_START
,
4591 SECUREBOOT_DELETE_SIGNATURE_LIST_FORM
,
4592 OPTION_SIGNATURE_LIST_QUESTION_ID
4597 // Delete all signature list and reload.
4599 case KEY_SECURE_BOOT_DELETE_ALL_LIST
:
4601 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4603 L
"Press 'Y' to delete signature list.",
4604 L
"Press other key to cancel and exit.",
4608 if (Key
.UnicodeChar
== L
'Y' || Key
.UnicodeChar
== L
'y') {
4609 DeleteSignatureEx (Private
, DELETE_SIGNATURE_LIST_ALL
, IfrNvData
->CheckedDataCount
);
4614 LABEL_SIGNATURE_LIST_START
,
4615 SECUREBOOT_DELETE_SIGNATURE_LIST_FORM
,
4616 OPTION_SIGNATURE_LIST_QUESTION_ID
4621 // Delete one signature list and reload.
4623 case KEY_SECURE_BOOT_DELETE_ALL_DATA
:
4625 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4627 L
"Press 'Y' to delete signature data.",
4628 L
"Press other key to cancel and exit.",
4632 if (Key
.UnicodeChar
== L
'Y' || Key
.UnicodeChar
== L
'y') {
4633 DeleteSignatureEx (Private
, DELETE_SIGNATURE_LIST_ONE
, IfrNvData
->CheckedDataCount
);
4638 LABEL_SIGNATURE_LIST_START
,
4639 SECUREBOOT_DELETE_SIGNATURE_LIST_FORM
,
4640 OPTION_SIGNATURE_LIST_QUESTION_ID
4645 // Delete checked signature data and reload.
4647 case KEY_SECURE_BOOT_DELETE_CHECK_DATA
:
4649 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4651 L
"Press 'Y' to delete signature data.",
4652 L
"Press other key to cancel and exit.",
4656 if (Key
.UnicodeChar
== L
'Y' || Key
.UnicodeChar
== L
'y') {
4657 DeleteSignatureEx (Private
, DELETE_SIGNATURE_DATA
, IfrNvData
->CheckedDataCount
);
4662 LABEL_SIGNATURE_LIST_START
,
4663 SECUREBOOT_DELETE_SIGNATURE_LIST_FORM
,
4664 OPTION_SIGNATURE_LIST_QUESTION_ID
4668 case SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
:
4671 EFI_IMAGE_SECURITY_DATABASE2
,
4672 &gEfiImageSecurityDatabaseGuid
,
4674 SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
,
4675 OPTION_DEL_DBT_QUESTION_ID
4680 case KEY_VALUE_SAVE_AND_EXIT_KEK
:
4681 Status
= EnrollKeyExchangeKey (Private
);
4682 if (EFI_ERROR (Status
)) {
4684 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4686 L
"ERROR: Unsupported file type!",
4687 L
"Only supports DER-encoded X509 certificate",
4693 case KEY_VALUE_SAVE_AND_EXIT_DB
:
4694 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE
);
4695 if (EFI_ERROR (Status
)) {
4697 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4699 L
"ERROR: Unsupported file type!",
4700 L
"Only supports DER-encoded X509 certificate and executable EFI image",
4706 case KEY_VALUE_SAVE_AND_EXIT_DBX
:
4707 if (IsX509CertInDbx (Private
, EFI_IMAGE_SECURITY_DATABASE1
)) {
4709 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4711 L
"Enrollment failed! Same certificate had already been in the dbx!",
4716 // Cert already exists in DBX. Close opened file before exit.
4718 CloseEnrolledFile(Private
->FileContext
);
4722 if ((IfrNvData
!= NULL
) && (IfrNvData
->CertificateFormat
< HASHALG_MAX
)) {
4723 Status
= EnrollX509HashtoSigDB (
4725 IfrNvData
->CertificateFormat
,
4726 &IfrNvData
->RevocationDate
,
4727 &IfrNvData
->RevocationTime
,
4728 IfrNvData
->AlwaysRevocation
4730 IfrNvData
->CertificateFormat
= HASHALG_RAW
;
4732 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE1
);
4734 if (EFI_ERROR (Status
)) {
4736 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4738 L
"ERROR: Unsupported file type!",
4739 L
"Only supports DER-encoded X509 certificate, AUTH_2 format data & executable EFI image",
4745 case KEY_VALUE_SAVE_AND_EXIT_DBT
:
4746 Status
= EnrollSignatureDatabase (Private
, EFI_IMAGE_SECURITY_DATABASE2
);
4747 if (EFI_ERROR (Status
)) {
4749 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4751 L
"ERROR: Unsupported file type!",
4752 L
"Only supports DER-encoded X509 certificate.",
4757 case KEY_VALUE_SAVE_AND_EXIT_PK
:
4758 Status
= EnrollPlatformKey (Private
);
4759 if (EFI_ERROR (Status
)) {
4762 sizeof (PromptString
),
4763 L
"Only DER encoded certificate file (%s) is supported.",
4767 EFI_LIGHTGRAY
| EFI_BACKGROUND_BLUE
,
4769 L
"ERROR: Unsupported file type!",
4776 if ((QuestionId
>= OPTION_DEL_KEK_QUESTION_ID
) &&
4777 (QuestionId
< (OPTION_DEL_KEK_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
4778 DeleteKeyExchangeKey (Private
, QuestionId
);
4779 } else if ((QuestionId
>= OPTION_DEL_DB_QUESTION_ID
) &&
4780 (QuestionId
< (OPTION_DEL_DB_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
4783 EFI_IMAGE_SECURITY_DATABASE
,
4784 &gEfiImageSecurityDatabaseGuid
,
4786 SECUREBOOT_DELETE_SIGNATURE_FROM_DB
,
4787 OPTION_DEL_DB_QUESTION_ID
,
4788 QuestionId
- OPTION_DEL_DB_QUESTION_ID
4790 } else if ((QuestionId
>= OPTION_SIGNATURE_LIST_QUESTION_ID
) &&
4791 (QuestionId
< (OPTION_SIGNATURE_LIST_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
4794 LABEL_SIGNATURE_DATA_START
,
4795 SECUREBOOT_DELETE_SIGNATURE_DATA_FORM
,
4796 OPTION_SIGNATURE_DATA_QUESTION_ID
,
4797 QuestionId
- OPTION_SIGNATURE_LIST_QUESTION_ID
4799 Private
->ListIndex
= QuestionId
- OPTION_SIGNATURE_LIST_QUESTION_ID
;
4800 } else if ((QuestionId
>= OPTION_SIGNATURE_DATA_QUESTION_ID
) &&
4801 (QuestionId
< (OPTION_SIGNATURE_DATA_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
4802 if (Private
->CheckArray
[QuestionId
- OPTION_SIGNATURE_DATA_QUESTION_ID
]) {
4803 IfrNvData
->CheckedDataCount
--;
4804 Private
->CheckArray
[QuestionId
- OPTION_SIGNATURE_DATA_QUESTION_ID
] = FALSE
;
4806 IfrNvData
->CheckedDataCount
++;
4807 Private
->CheckArray
[QuestionId
- OPTION_SIGNATURE_DATA_QUESTION_ID
] = TRUE
;
4809 } else if ((QuestionId
>= OPTION_DEL_DBT_QUESTION_ID
) &&
4810 (QuestionId
< (OPTION_DEL_DBT_QUESTION_ID
+ OPTION_CONFIG_RANGE
))) {
4813 EFI_IMAGE_SECURITY_DATABASE2
,
4814 &gEfiImageSecurityDatabaseGuid
,
4816 SECUREBOOT_DELETE_SIGNATURE_FROM_DBT
,
4817 OPTION_DEL_DBT_QUESTION_ID
,
4818 QuestionId
- OPTION_DEL_DBT_QUESTION_ID
4823 case KEY_VALUE_NO_SAVE_AND_EXIT_PK
:
4824 case KEY_VALUE_NO_SAVE_AND_EXIT_KEK
:
4825 case KEY_VALUE_NO_SAVE_AND_EXIT_DB
:
4826 case KEY_VALUE_NO_SAVE_AND_EXIT_DBX
:
4827 case KEY_VALUE_NO_SAVE_AND_EXIT_DBT
:
4828 CloseEnrolledFile(Private
->FileContext
);
4830 if (Private
->SignatureGUID
!= NULL
) {
4831 FreePool (Private
->SignatureGUID
);
4832 Private
->SignatureGUID
= NULL
;
4836 } else if (Action
== EFI_BROWSER_ACTION_CHANGED
) {
4837 switch (QuestionId
) {
4838 case KEY_SECURE_BOOT_ENABLE
:
4839 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
4841 case KEY_SECURE_BOOT_MODE
:
4842 mIsEnterSecureBootForm
= FALSE
;
4844 case KEY_SECURE_BOOT_KEK_GUID
:
4845 case KEY_SECURE_BOOT_SIGNATURE_GUID_DB
:
4846 case KEY_SECURE_BOOT_SIGNATURE_GUID_DBX
:
4847 case KEY_SECURE_BOOT_SIGNATURE_GUID_DBT
:
4848 ASSERT (Private
->SignatureGUID
!= NULL
);
4849 RStatus
= StrToGuid (IfrNvData
->SignatureGuid
, Private
->SignatureGUID
);
4850 if (RETURN_ERROR (RStatus
) || (IfrNvData
->SignatureGuid
[GUID_STRING_LENGTH
] != L
'\0')) {
4851 Status
= EFI_INVALID_PARAMETER
;
4855 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
4857 case KEY_SECURE_BOOT_DELETE_PK
:
4858 GetVariable2 (EFI_SETUP_MODE_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&SetupMode
, NULL
);
4859 if (SetupMode
== NULL
|| (*SetupMode
) == SETUP_MODE
) {
4860 IfrNvData
->DeletePk
= TRUE
;
4861 IfrNvData
->HasPk
= FALSE
;
4862 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_SUBMIT
;
4864 IfrNvData
->DeletePk
= FALSE
;
4865 IfrNvData
->HasPk
= TRUE
;
4866 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
;
4868 if (SetupMode
!= NULL
) {
4869 FreePool (SetupMode
);
4875 } else if (Action
== EFI_BROWSER_ACTION_DEFAULT_STANDARD
) {
4876 if (QuestionId
== KEY_HIDE_SECURE_BOOT
) {
4877 GetVariable2 (EFI_PLATFORM_KEY_NAME
, &gEfiGlobalVariableGuid
, (VOID
**)&Pk
, NULL
);
4879 IfrNvData
->HideSecureBoot
= TRUE
;
4882 IfrNvData
->HideSecureBoot
= FALSE
;
4884 Value
->b
= IfrNvData
->HideSecureBoot
;
4886 } else if (Action
== EFI_BROWSER_ACTION_FORM_CLOSE
) {
4888 // Force the platform back to Standard Mode once user leave the setup screen.
4890 GetVariable2 (EFI_CUSTOM_MODE_NAME
, &gEfiCustomModeEnableGuid
, (VOID
**)&SecureBootMode
, NULL
);
4891 if (NULL
!= SecureBootMode
&& *SecureBootMode
== CUSTOM_SECURE_BOOT_MODE
) {
4892 IfrNvData
->SecureBootMode
= STANDARD_SECURE_BOOT_MODE
;
4893 SetSecureBootMode(STANDARD_SECURE_BOOT_MODE
);
4895 if (SecureBootMode
!= NULL
) {
4896 FreePool (SecureBootMode
);
4899 if (QuestionId
== KEY_SECURE_BOOT_DELETE_ALL_DATA
) {
4901 // Free memory when exit from the SECUREBOOT_DELETE_SIGNATURE_DATA_FORM form.
4903 SECUREBOOT_FREE_NON_NULL (Private
->CheckArray
);
4904 IfrNvData
->CheckedDataCount
= 0;
4910 if (!EFI_ERROR (Status
)) {
4911 BufferSize
= sizeof (SECUREBOOT_CONFIGURATION
);
4912 HiiSetBrowserData (&gSecureBootConfigFormSetGuid
, mSecureBootStorageName
, BufferSize
, (UINT8
*) IfrNvData
, NULL
);
4915 FreePool (IfrNvData
);
4926 This function publish the SecureBoot configuration Form.
4928 @param[in, out] PrivateData Points to SecureBoot configuration private data.
4930 @retval EFI_SUCCESS HII Form is installed successfully.
4931 @retval EFI_OUT_OF_RESOURCES Not enough resource for HII Form installation.
4932 @retval Others Other errors as indicated.
4936 InstallSecureBootConfigForm (
4937 IN OUT SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
4941 EFI_HII_HANDLE HiiHandle
;
4942 EFI_HANDLE DriverHandle
;
4943 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
4945 DriverHandle
= NULL
;
4946 ConfigAccess
= &PrivateData
->ConfigAccess
;
4947 Status
= gBS
->InstallMultipleProtocolInterfaces (
4949 &gEfiDevicePathProtocolGuid
,
4950 &mSecureBootHiiVendorDevicePath
,
4951 &gEfiHiiConfigAccessProtocolGuid
,
4955 if (EFI_ERROR (Status
)) {
4959 PrivateData
->DriverHandle
= DriverHandle
;
4962 // Publish the HII package list
4964 HiiHandle
= HiiAddPackages (
4965 &gSecureBootConfigFormSetGuid
,
4967 SecureBootConfigDxeStrings
,
4968 SecureBootConfigBin
,
4971 if (HiiHandle
== NULL
) {
4972 gBS
->UninstallMultipleProtocolInterfaces (
4974 &gEfiDevicePathProtocolGuid
,
4975 &mSecureBootHiiVendorDevicePath
,
4976 &gEfiHiiConfigAccessProtocolGuid
,
4980 return EFI_OUT_OF_RESOURCES
;
4983 PrivateData
->HiiHandle
= HiiHandle
;
4985 PrivateData
->FileContext
= AllocateZeroPool (sizeof (SECUREBOOT_FILE_CONTEXT
));
4987 if (PrivateData
->FileContext
== NULL
) {
4988 UninstallSecureBootConfigForm (PrivateData
);
4989 return EFI_OUT_OF_RESOURCES
;
4993 // Init OpCode Handle and Allocate space for creation of Buffer
4995 mStartOpCodeHandle
= HiiAllocateOpCodeHandle ();
4996 if (mStartOpCodeHandle
== NULL
) {
4997 UninstallSecureBootConfigForm (PrivateData
);
4998 return EFI_OUT_OF_RESOURCES
;
5001 mEndOpCodeHandle
= HiiAllocateOpCodeHandle ();
5002 if (mEndOpCodeHandle
== NULL
) {
5003 UninstallSecureBootConfigForm (PrivateData
);
5004 return EFI_OUT_OF_RESOURCES
;
5008 // Create Hii Extend Label OpCode as the start opcode
5010 mStartLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
5014 sizeof (EFI_IFR_GUID_LABEL
)
5016 mStartLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
5019 // Create Hii Extend Label OpCode as the end opcode
5021 mEndLabel
= (EFI_IFR_GUID_LABEL
*) HiiCreateGuidOpCode (
5025 sizeof (EFI_IFR_GUID_LABEL
)
5027 mEndLabel
->ExtendOpCode
= EFI_IFR_EXTEND_OP_LABEL
;
5028 mEndLabel
->Number
= LABEL_END
;
5034 This function removes SecureBoot configuration Form.
5036 @param[in, out] PrivateData Points to SecureBoot configuration private data.
5040 UninstallSecureBootConfigForm (
5041 IN OUT SECUREBOOT_CONFIG_PRIVATE_DATA
*PrivateData
5045 // Uninstall HII package list
5047 if (PrivateData
->HiiHandle
!= NULL
) {
5048 HiiRemovePackages (PrivateData
->HiiHandle
);
5049 PrivateData
->HiiHandle
= NULL
;
5053 // Uninstall HII Config Access Protocol
5055 if (PrivateData
->DriverHandle
!= NULL
) {
5056 gBS
->UninstallMultipleProtocolInterfaces (
5057 PrivateData
->DriverHandle
,
5058 &gEfiDevicePathProtocolGuid
,
5059 &mSecureBootHiiVendorDevicePath
,
5060 &gEfiHiiConfigAccessProtocolGuid
,
5061 &PrivateData
->ConfigAccess
,
5064 PrivateData
->DriverHandle
= NULL
;
5067 if (PrivateData
->SignatureGUID
!= NULL
) {
5068 FreePool (PrivateData
->SignatureGUID
);
5071 if (PrivateData
->FileContext
!= NULL
) {
5072 FreePool (PrivateData
->FileContext
);
5075 FreePool (PrivateData
);
5077 if (mStartOpCodeHandle
!= NULL
) {
5078 HiiFreeOpCodeHandle (mStartOpCodeHandle
);
5081 if (mEndOpCodeHandle
!= NULL
) {
5082 HiiFreeOpCodeHandle (mEndOpCodeHandle
);