init

hc

2024-03-22 a0752693d998599af469473b8dc239ef973a012f

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