CryptHkdfNull.c File Reference

#include <Library/BaseCryptLib.h>
#include <Library/DebugLib.h>

Go to the source code of this file.

Functions
BOOLEAN EFIAPI	HkdfSha256ExtractAndExpand (IN CONST UINT8 *Key, IN UINTN KeySize, IN CONST UINT8 *Salt, IN UINTN SaltSize, IN CONST UINT8 *Info, IN UINTN InfoSize, OUT UINT8 *Out, IN UINTN OutSize)
BOOLEAN EFIAPI	HkdfSha256Extract (IN CONST UINT8 *Key, IN UINTN KeySize, IN CONST UINT8 *Salt, IN UINTN SaltSize, OUT UINT8 *PrkOut, UINTN PrkOutSize)
BOOLEAN EFIAPI	HkdfSha256Expand (IN CONST UINT8 *Prk, IN UINTN PrkSize, IN CONST UINT8 *Info, IN UINTN InfoSize, OUT UINT8 *Out, IN UINTN OutSize)
BOOLEAN EFIAPI	HkdfSha384ExtractAndExpand (IN CONST UINT8 *Key, IN UINTN KeySize, IN CONST UINT8 *Salt, IN UINTN SaltSize, IN CONST UINT8 *Info, IN UINTN InfoSize, OUT UINT8 *Out, IN UINTN OutSize)
BOOLEAN EFIAPI	HkdfSha384Extract (IN CONST UINT8 *Key, IN UINTN KeySize, IN CONST UINT8 *Salt, IN UINTN SaltSize, OUT UINT8 *PrkOut, UINTN PrkOutSize)
BOOLEAN EFIAPI	HkdfSha384Expand (IN CONST UINT8 *Prk, IN UINTN PrkSize, IN CONST UINT8 *Info, IN UINTN InfoSize, OUT UINT8 *Out, IN UINTN OutSize)

Detailed Description

HMAC-SHA256 KDF Wrapper Implementation which does not provide real capabilities.

Copyright (c) 2023, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file CryptHkdfNull.c.

Function Documentation

HkdfSha256Expand()

BOOLEAN EFIAPI HkdfSha256Expand	(	IN CONST UINT8 *	Prk,
		IN UINTN	PrkSize,
		IN CONST UINT8 *	Info,
		IN UINTN	InfoSize,
		OUT UINT8 *	Out,
		IN UINTN	OutSize
	)

Derive SHA256 HMAC-based Expand Key Derivation Function (HKDF).

Parameters

[in]	Prk	Pointer to the user-supplied key.
[in]	PrkSize	Key size in bytes.
[in]	Info	Pointer to the application specific info.
[in]	InfoSize	Info size in bytes.
[out]	Out	Pointer to buffer to receive hkdf value.
[in]	OutSize	Size of hkdf bytes to generate.

Return values

TRUE	Hkdf generated successfully.
FALSE	Hkdf generation failed.

Definition at line 90 of file CryptHkdfNull.c.

HkdfSha256Extract()

BOOLEAN EFIAPI HkdfSha256Extract	(	IN CONST UINT8 *	Key,
		IN UINTN	KeySize,
		IN CONST UINT8 *	Salt,
		IN UINTN	SaltSize,
		OUT UINT8 *	PrkOut,
		UINTN	PrkOutSize
	)

Derive SHA256 HMAC-based Extract key Derivation Function (HKDF).

Parameters

[in]	Key	Pointer to the user-supplied key.
[in]	KeySize	key size in bytes.
[in]	Salt	Pointer to the salt(non-secret) value.
[in]	SaltSize	salt size in bytes.
[out]	PrkOut	Pointer to buffer to receive hkdf value.
[in]	PrkOutSize	size of hkdf bytes to generate.

Return values

true	Hkdf generated successfully.
false	Hkdf generation failed.

Definition at line 61 of file CryptHkdfNull.c.

HkdfSha256ExtractAndExpand()

BOOLEAN EFIAPI HkdfSha256ExtractAndExpand	(	IN CONST UINT8 *	Key,
		IN UINTN	KeySize,
		IN CONST UINT8 *	Salt,
		IN UINTN	SaltSize,
		IN CONST UINT8 *	Info,
		IN UINTN	InfoSize,
		OUT UINT8 *	Out,
		IN UINTN	OutSize
	)

Derive key data using HMAC-SHA256 based KDF.

Parameters

[in]	Key	Pointer to the user-supplied key.
[in]	KeySize	Key size in bytes.
[in]	Salt	Pointer to the salt(non-secret) value.
[in]	SaltSize	Salt size in bytes.
[in]	Info	Pointer to the application specific info.
[in]	InfoSize	Info size in bytes.
[out]	Out	Pointer to buffer to receive hkdf value.
[in]	OutSize	Size of hkdf bytes to generate.

Return values

TRUE	Hkdf generated successfully.
FALSE	Hkdf generation failed.

Definition at line 30 of file CryptHkdfNull.c.

HkdfSha384Expand()

BOOLEAN EFIAPI HkdfSha384Expand	(	IN CONST UINT8 *	Prk,
		IN UINTN	PrkSize,
		IN CONST UINT8 *	Info,
		IN UINTN	InfoSize,
		OUT UINT8 *	Out,
		IN UINTN	OutSize
	)

Derive SHA384 HMAC-based Expand Key Derivation Function (HKDF).

Parameters

[in]	Prk	Pointer to the user-supplied key.
[in]	PrkSize	Key size in bytes.
[in]	Info	Pointer to the application specific info.
[in]	InfoSize	Info size in bytes.
[out]	Out	Pointer to buffer to receive hkdf value.
[in]	OutSize	Size of hkdf bytes to generate.

Return values

TRUE	Hkdf generated successfully.
FALSE	Hkdf generation failed.

Definition at line 181 of file CryptHkdfNull.c.

HkdfSha384Extract()

BOOLEAN EFIAPI HkdfSha384Extract	(	IN CONST UINT8 *	Key,
		IN UINTN	KeySize,
		IN CONST UINT8 *	Salt,
		IN UINTN	SaltSize,
		OUT UINT8 *	PrkOut,
		UINTN	PrkOutSize
	)

Derive SHA384 HMAC-based Extract key Derivation Function (HKDF).

Parameters

[in]	Key	Pointer to the user-supplied key.
[in]	KeySize	key size in bytes.
[in]	Salt	Pointer to the salt(non-secret) value.
[in]	SaltSize	salt size in bytes.
[out]	PrkOut	Pointer to buffer to receive hkdf value.
[in]	PrkOutSize	size of hkdf bytes to generate.

Return values

true	Hkdf generated successfully.
false	Hkdf generation failed.

Definition at line 152 of file CryptHkdfNull.c.

HkdfSha384ExtractAndExpand()

BOOLEAN EFIAPI HkdfSha384ExtractAndExpand	(	IN CONST UINT8 *	Key,
		IN UINTN	KeySize,
		IN CONST UINT8 *	Salt,
		IN UINTN	SaltSize,
		IN CONST UINT8 *	Info,
		IN UINTN	InfoSize,
		OUT UINT8 *	Out,
		IN UINTN	OutSize
	)

Derive SHA384 HMAC-based Extract-and-Expand Key Derivation Function (HKDF).

Parameters

[in]	Key	Pointer to the user-supplied key.
[in]	KeySize	Key size in bytes.
[in]	Salt	Pointer to the salt(non-secret) value.
[in]	SaltSize	Salt size in bytes.
[in]	Info	Pointer to the application specific info.
[in]	InfoSize	Info size in bytes.
[out]	Out	Pointer to buffer to receive hkdf value.
[in]	OutSize	Size of hkdf bytes to generate.

Return values

TRUE	Hkdf generated successfully.
FALSE	Hkdf generation failed.

Definition at line 121 of file CryptHkdfNull.c.