1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
/** @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
|
