You've already forked edk2-platforms
mirror of
https://github.com/Dasharo/edk2-platforms.git
synced 2026-03-06 14:51:43 -08:00
0110a8cf76
Adds a new feature package for the User Authentication feature. Cc: Dandan Bi <dandan.bi@intel.com> Cc: Liming Gao <liming.gao@intel.com> Signed-off-by: Michael Kubacki <michael.a.kubacki@intel.com> Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>
89 lines
2.7 KiB
C
89 lines
2.7 KiB
C
/** @file
|
|
Header file for key service.
|
|
|
|
Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __KEY_LIB_H__
|
|
#define __KEY_LIB_H__
|
|
|
|
/**
|
|
Compares the contents of two buffers with slow algorithm
|
|
|
|
This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.
|
|
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
|
|
value returned is the first mismatched byte in SourceBuffer subtracted from the first
|
|
mismatched byte in DestinationBuffer.
|
|
|
|
If Length > 0 and DestinationBuffer is NULL, then ASSERT().
|
|
If Length > 0 and SourceBuffer is NULL, then ASSERT().
|
|
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
|
|
If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().
|
|
|
|
@param DestinationBuffer The pointer to the destination buffer to compare.
|
|
@param SourceBuffer The pointer to the source buffer to compare.
|
|
@param Length The number of bytes to compare.
|
|
|
|
@return 0 All Length bytes of the two buffers are identical.
|
|
@retval -1 The SourceBuffer is not identical to DestinationBuffer.
|
|
|
|
**/
|
|
INTN
|
|
EFIAPI
|
|
KeyLibSlowCompareMem (
|
|
IN CONST VOID *DestinationBuffer,
|
|
IN CONST VOID *SourceBuffer,
|
|
IN UINTN Length
|
|
);
|
|
|
|
/**
|
|
Generate Salt value.
|
|
|
|
@param[in, out] SaltValue Points to the salt buffer
|
|
@param[in] SaltSize Size of the salt buffer
|
|
|
|
@retval TRUE Salt is generated.
|
|
@retval FALSE Salt is not generated.
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
KeyLibGenerateSalt(
|
|
IN OUT UINT8 *SaltValue,
|
|
IN UINTN SaltSize
|
|
);
|
|
|
|
#define HASH_TYPE_SHA256 0x000B
|
|
#define DEFAULT_PBKDF2_ITERATION_COUNT 1000
|
|
|
|
/**
|
|
Hash the password with PBKDF2.
|
|
|
|
@param[in] HashType Hash type
|
|
@param[in] Key Points to the key buffer
|
|
@param[in] KeySize Key buffer size
|
|
@param[in] SaltValue Points to the salt buffer
|
|
@param[in] SaltSize Size of the salt buffer
|
|
@param[out] KeyHash Points to the hashed result
|
|
@param[in] KeyHashSize Size of the hash buffer
|
|
|
|
@retval TRUE Hash the data successfully.
|
|
@retval FALSE Failed to hash the data.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
KeyLibGeneratePBKDF2Hash (
|
|
IN UINT32 HashType,
|
|
IN VOID *Key,
|
|
IN UINTN KeySize,
|
|
IN UINT8 *SaltValue,
|
|
IN UINTN SaltSize,
|
|
OUT UINT8 *KeyHash,
|
|
IN UINTN KeyHashSize
|
|
);
|
|
|
|
#endif
|
|
|