hmac.h
Go to the documentation of this file.
1 /**
2  * @file hmac.h
3  * @brief HMAC (Keyed-Hashing for Message Authentication)
4  *
5  * @section License
6  *
7  * SPDX-License-Identifier: GPL-2.0-or-later
8  *
9  * Copyright (C) 2010-2023 Oryx Embedded SARL. All rights reserved.
10  *
11  * This file is part of CycloneCRYPTO Open.
12  *
13  * This program is free software; you can redistribute it and/or
14  * modify it under the terms of the GNU General Public License
15  * as published by the Free Software Foundation; either version 2
16  * of the License, or (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software Foundation,
25  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
26  *
27  * @author Oryx Embedded SARL (www.oryx-embedded.com)
28  * @version 2.2.4
29  **/
30 
31 #ifndef _HMAC_H
32 #define _HMAC_H
33 
34 //Dependencies
35 #include "core/crypto.h"
36 #include "hash/hash_algorithms.h"
37 
38 //Application specific context
39 #ifndef HMAC_PRIVATE_CONTEXT
40  #define HMAC_PRIVATE_CONTEXT
41 #endif
42 
43 //Inner padding (ipad)
44 #define HMAC_IPAD 0x36
45 //Outer padding (opad)
46 #define HMAC_OPAD 0x5C
47 
48 //C++ guard
49 #ifdef __cplusplus
50 extern "C" {
51 #endif
52 
53 
54 /**
55  * @brief HMAC algorithm context
56  **/
57 
58 typedef struct
59 {
60  const HashAlgo *hash;
61  HashContext hashContext;
62  uint8_t key[MAX_HASH_BLOCK_SIZE];
63  uint8_t digest[MAX_HASH_DIGEST_SIZE];
64  HMAC_PRIVATE_CONTEXT
65 } HmacContext;
66 
67 
68 //HMAC related constants
69 extern const uint8_t HMAC_WITH_MD5_OID[8];
70 extern const uint8_t HMAC_WITH_TIGER_OID[8];
71 extern const uint8_t HMAC_WITH_RIPEMD160_OID[8];
72 extern const uint8_t HMAC_WITH_SHA1_OID[8];
73 extern const uint8_t HMAC_WITH_SHA224_OID[8];
74 extern const uint8_t HMAC_WITH_SHA256_OID[8];
75 extern const uint8_t HMAC_WITH_SHA384_OID[8];
76 extern const uint8_t HMAC_WITH_SHA512_OID[8];
77 extern const uint8_t HMAC_WITH_SHA512_224_OID[8];
78 extern const uint8_t HMAC_WITH_SHA512_256_OID[8];
79 extern const uint8_t HMAC_WITH_SHA3_224_OID[9];
80 extern const uint8_t HMAC_WITH_SHA3_256_OID[9];
81 extern const uint8_t HMAC_WITH_SHA3_384_OID[9];
82 extern const uint8_t HMAC_WITH_SHA3_512_OID[9];
83 
84 //HMAC related functions
85 error_t hmacCompute(const HashAlgo *hash, const void *key, size_t keyLen,
86  const void *data, size_t dataLen, uint8_t *digest);
87 
88 error_t hmacInit(HmacContext *context, const HashAlgo *hash,
89  const void *key, size_t keyLen);
90 
91 void hmacUpdate(HmacContext *context, const void *data, size_t length);
92 void hmacFinal(HmacContext *context, uint8_t *digest);
93 void hmacFinalRaw(HmacContext *context, uint8_t *digest);
94 
95 //C++ guard
96 #ifdef __cplusplus
97 }
98 #endif
99 
100 #endif
hmacFinalRaw
void hmacFinalRaw(HmacContext *context, uint8_t *digest)
Finish the HMAC calculation (no padding added)
Definition: hmac.c:253
HMAC_WITH_SHA512_224_OID
const uint8_t HMAC_WITH_SHA512_224_OID[8]
Definition: hmac.c:65
length
uint8_t length
Definition: coap_common.h:193
HmacContext::hash
const HashAlgo * hash
Definition: hmac.h:60
HMAC_WITH_RIPEMD160_OID
const uint8_t HMAC_WITH_RIPEMD160_OID[8]
Definition: hmac.c:53
HashContext
Generic hash algorithm context.
Definition: hash_algorithms.h:288
HmacContext
HMAC algorithm context.
Definition: hmac.h:59
data
uint8_t data[]
Definition: ethernet.h:220
HMAC_WITH_SHA384_OID
const uint8_t HMAC_WITH_SHA384_OID[8]
Definition: hmac.c:61
hmacInit
error_t hmacInit(HmacContext *context, const HashAlgo *hash, const void *key, size_t keyLen)
Initialize HMAC calculation.
Definition: hmac.c:136
HMAC_WITH_SHA512_256_OID
const uint8_t HMAC_WITH_SHA512_256_OID[8]
Definition: hmac.c:67
HMAC_WITH_SHA224_OID
const uint8_t HMAC_WITH_SHA224_OID[8]
Definition: hmac.c:57
HMAC_PRIVATE_CONTEXT
#define HMAC_PRIVATE_CONTEXT
Definition: hmac.h:40
MAX_HASH_DIGEST_SIZE
#define MAX_HASH_DIGEST_SIZE
Definition: hash_algorithms.h:224
HMAC_WITH_SHA3_224_OID
const uint8_t HMAC_WITH_SHA3_224_OID[9]
Definition: hmac.c:69
error_t
error_t
Error codes.
Definition: error.h:43
MAX_HASH_BLOCK_SIZE
#define MAX_HASH_BLOCK_SIZE
Definition: hash_algorithms.h:169
crypto.h
General definitions for cryptographic algorithms.
hmacCompute
error_t hmacCompute(const HashAlgo *hash, const void *key, size_t keyLen, const void *data, size_t dataLen, uint8_t *digest)
Compute HMAC using the specified hash function.
Definition: hmac.c:89
hmacUpdate
void hmacUpdate(HmacContext *context, const void *data, size_t length)
Update the HMAC context with a portion of the message being hashed.
Definition: hmac.c:197
dataLen
uint32_t dataLen
Definition: sftp_common.h:227
HMAC_WITH_SHA1_OID
const uint8_t HMAC_WITH_SHA1_OID[8]
Definition: hmac.c:55
hash_algorithms.h
Collection of hash algorithms.
hash
uint8_t hash
Definition: tls.h:1455
HMAC_WITH_TIGER_OID
const uint8_t HMAC_WITH_TIGER_OID[8]
Definition: hmac.c:51
HMAC_WITH_SHA3_384_OID
const uint8_t HMAC_WITH_SHA3_384_OID[9]
Definition: hmac.c:73
HMAC_WITH_SHA3_512_OID
const uint8_t HMAC_WITH_SHA3_512_OID[9]
Definition: hmac.c:75
HMAC_WITH_SHA512_OID
const uint8_t HMAC_WITH_SHA512_OID[8]
Definition: hmac.c:63
hmacFinal
void hmacFinal(HmacContext *context, uint8_t *digest)
Finish the HMAC calculation.
Definition: hmac.c:214
HMAC_WITH_MD5_OID
const uint8_t HMAC_WITH_MD5_OID[8]
Definition: hmac.c:49
HmacContext::hashContext
HashContext hashContext
Definition: hmac.h:61
HMAC_WITH_SHA256_OID
const uint8_t HMAC_WITH_SHA256_OID[8]
Definition: hmac.c:59
HashAlgo
Common interface for hash algorithms.
Definition: crypto.h:958
HMAC_WITH_SHA3_256_OID
const uint8_t HMAC_WITH_SHA3_256_OID[9]
Definition: hmac.c:71