CryptPkcs7VerifyEkuNull.c File Reference

#include "InternalCryptLib.h"

Go to the source code of this file.

Functions
EFI_STATUS	GetSignerCertificate (IN CONST VOID *CertChain, OUT VOID **SignerCert)
EFI_STATUS	IsEkuInCertificate (IN CONST VOID *Cert, IN VOID *Asn1ToFind)
EFI_STATUS	CheckEKUs (IN CONST VOID *SignerCert, IN CONST CHAR8 *RequiredEKUs[], IN CONST UINT32 RequiredEKUsSize, IN BOOLEAN RequireAllPresent)
EFI_STATUS EFIAPI	VerifyEKUsInPkcs7Signature (IN CONST UINT8 *Pkcs7Signature, IN CONST UINT32 SignatureSize, IN CONST CHAR8 *RequiredEKUs[], IN CONST UINT32 RequiredEKUsSize, IN BOOLEAN RequireAllPresent)

Detailed Description

PKCS7 Verify Null implementation.

Copyright (C) Microsoft Corporation. All Rights Reserved. Copyright (c) 2023, Intel Corporation. All rights reserved.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file CryptPkcs7VerifyEkuNull.c.

Function Documentation

CheckEKUs()

EFI_STATUS CheckEKUs	(	IN CONST VOID *	SignerCert,
		IN CONST CHAR8 *	RequiredEKUs[],
		IN CONST UINT32	RequiredEKUsSize,
		IN BOOLEAN	RequireAllPresent
	)

Determines if the specified EKUs are present in a signing certificate.

Parameters

[in]	SignerCert	The certificate to check.
[in]	RequiredEKUs	The EKUs to look for.
[in]	RequiredEKUsSize	The number of EKUs
[in]	RequireAllPresent	If TRUE, then all the specified EKUs must be present in the certificate.

Return values

EFI_SUCCESS	We successfully identified the signing type.
EFI_INVALID_PARAMETER	A parameter was invalid.
EFI_NOT_FOUND	One or more EKU's were not found in the signature.

Definition at line 99 of file CryptPkcs7VerifyEkuNull.c.

GetSignerCertificate()

EFI_STATUS GetSignerCertificate	(	IN CONST VOID *	CertChain,
		OUT VOID **	SignerCert
	)

This function will return the leaf signer certificate in a chain. This is required because certificate chains are not guaranteed to have the certificates in the order that they were issued.

A typical certificate chain looks like this:

---

| Root |

^

|

| Policy CA | <– Typical Trust Anchor.

^

|

| Issuing CA |

^

|

/ End-Entity (leaf) signer / <– Bottom certificate. --------------------------— EKU: "1.3.6.1.4.1.311.76.9.21.1" (Firmware Signing)

Parameters

[in]	CertChain	Certificate chain.
[out]	SignerCert	Last certificate in the chain. For PKCS7 signatures, this will be the end-entity (leaf) signer cert.

Return values

EFI_SUCCESS	The required EKUs were found in the signature.
EFI_INVALID_PARAMETER	A parameter was invalid.
EFI_NOT_FOUND	The number of signers found was not 1.

Definition at line 53 of file CryptPkcs7VerifyEkuNull.c.

IsEkuInCertificate()

EFI_STATUS IsEkuInCertificate	(	IN CONST VOID *	Cert,
		IN VOID *	Asn1ToFind
	)

Determines if the specified EKU represented in ASN1 form is present in a given certificate.

Parameters

[in]	Cert	The certificate to check.
[in]	Asn1ToFind	The EKU to look for.

Return values

EFI_SUCCESS	We successfully identified the signing type.
EFI_INVALID_PARAMETER	A parameter was invalid.
EFI_NOT_FOUND	One or more EKU's were not found in the signature.

Definition at line 76 of file CryptPkcs7VerifyEkuNull.c.

VerifyEKUsInPkcs7Signature()

EFI_STATUS EFIAPI VerifyEKUsInPkcs7Signature	(	IN CONST UINT8 *	Pkcs7Signature,
		IN CONST UINT32	SignatureSize,
		IN CONST CHAR8 *	RequiredEKUs[],
		IN CONST UINT32	RequiredEKUsSize,
		IN BOOLEAN	RequireAllPresent
	)

This function receives a PKCS#7 formatted signature blob, looks for the EKU SEQUENCE blob, and if found then looks for all the required EKUs. This function was created so that the Surface team can cut down on the number of Certificate Authorities (CA's) by checking EKU's on leaf signers for a specific product. This prevents one product's certificate from signing another product's firmware or unlock blobs.

Note that this function does not validate the certificate chain. That needs to be done before using this function.

Parameters

[in]	Pkcs7Signature	The PKCS#7 signed information content block. An array containing the content block with both the signature, the signer's certificate, and any necessary intermediate certificates.
[in]	Pkcs7SignatureSize	Number of bytes in Pkcs7Signature.
[in]	RequiredEKUs	Array of null-terminated strings listing OIDs of required EKUs that must be present in the signature.
[in]	RequiredEKUsSize	Number of elements in the RequiredEKUs string array.
[in]	RequireAllPresent	If this is TRUE, then all of the specified EKU's must be present in the leaf signer. If it is FALSE, then we will succeed if we find any of the specified EKU's.

Return values

EFI_SUCCESS	The required EKUs were found in the signature.
EFI_INVALID_PARAMETER	A parameter was invalid.
EFI_NOT_FOUND	One or more EKU's were not found in the signature.

Definition at line 142 of file CryptPkcs7VerifyEkuNull.c.