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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/*
Copyright (C) 2005, 2004, 2010 Erik Eliasson, Johan Bilien, Werner Dittmann
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
* In addition, as a special exception, the copyright holders give
* permission to link the code of portions of this program with the
* OpenSSL library under certain conditions as described in each
* individual source file, and distribute linked combinations
* including the two.
* You must obey the GNU General Public License in all respects
* for all of the code used other than OpenSSL. If you modify
* file(s) with this exception, you may extend this exception to your
* version of the file(s), but you are not obligated to do so. If you
* do not wish to do so, delete this exception statement from your
* version. If you delete this exception statement from all source
* files in the program, then also delete it here.
*/
/**
* Functions to compute SHA1 HAMAC.
*
* @author Erik Eliasson <eliasson@it.kth.se>
* @author Johan Bilien <jobi@via.ecp.fr>
* @author Werner Dittmann
*/
#ifndef HMAC_H
#define HMAC_H
/**
* @file hmac.h
* @brief Functions that provide SHA1 HMAC support
*
* @ingroup GNU_ZRTP
* @{
*/
#include <stdint.h>
#ifndef SHA1_DIGEST_LENGTH
#define SHA1_DIGEST_LENGTH 20
#endif
/**
* Compute SHA1 HMAC.
*
* This functions takes one data chunk and computes its SHA1 HMAC.
*
* @param key
* The MAC key.
* @param key_length
* Lneght of the MAC key in bytes
* @param data
* Points to the data chunk.
* @param data_length
* Length of the data in bytes
* @param mac
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 20 bytes (SHA1_DIGEST_LENGTH).
* @param mac_length
* Point to an integer that receives the length of the computed HMAC.
*/
void hmac_sha1( uint8_t* key, int32_t key_length,
const uint8_t* data, uint32_t data_length,
uint8_t* mac, int32_t* mac_length );
/**
* Compute SHA1 HMAC over several data cunks.
*
* This functions takes several data chunk and computes the SHA1 HAMAC.
*
* @param key
* The MAC key.
* @param key_length
* Lneght of the MAC key in bytes
* @param data
* Points to an array of pointers that point to the data chunks. A NULL
* pointer in an array element terminates the data chunks.
* @param data_length
* Points to an array of integers that hold the length of each data chunk.
* @param mac
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 20 bytes (SHA1_DIGEST_LENGTH).
* @param mac_length
* Point to an integer that receives the length of the computed HMAC.
*/
void hmac_sha1( uint8_t* key, int32_t key_length,
const uint8_t* data[], uint32_t data_length[],
uint8_t* mac, int32_t* mac_length );
/**
* Create and initialize a SHA1 HMAC context.
*
* An application uses this context to create several HMAC with the same key.
*
* @param key
* The MAC key.
* @param key_length
* Lenght of the MAC key in bytes
* @return Returns a pointer to the initialized context
*/
void* createSha1HmacContext(uint8_t* key, int32_t key_length);
/**
* Compute SHA1 HMAC.
*
* This functions takes one data chunk and computes its SHA1 HMAC. On return
* the SHA1 MAC context is ready to compute a HMAC for another data chunk.
*
* @param ctx
* Pointer to initialized SHA1 HMAC context
* @param data
* Points to the data chunk.
* @param data_length
* Length of the data in bytes
* @param mac
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 20 bytes (SHA1_DIGEST_LENGTH).
* @param mac_length
* Point to an integer that receives the length of the computed HMAC.
*/
void hmacSha1Ctx(void* ctx, const uint8_t* data, uint32_t data_length,
uint8_t* mac, int32_t* mac_length );
/**
* Compute SHA1 HMAC over several data cunks.
*
* This functions takes several data chunks and computes the SHA1 HAMAC. On return
* the SHA1 MAC context is ready to compute a HMAC for another data chunk.
*
* @param ctx
* Pointer to initialized SHA1 HMAC context
* @param data
* Points to an array of pointers that point to the data chunks. A NULL
* pointer in an array element terminates the data chunks.
* @param data_length
* Points to an array of integers that hold the length of each data chunk.
* @param mac
* Points to a buffer that receives the computed digest. This
* buffer must have a size of at least 20 bytes (SHA1_DIGEST_LENGTH).
* @param mac_length
* Point to an integer that receives the length of the computed HMAC.
*/
void hmacSha1Ctx(void* ctx, const uint8_t* data[], uint32_t data_length[],
uint8_t* mac, int32_t* mac_length );
/**
* Free SHA1 HMAC context.
*
* @param ctx a pointer to SHA1 HMAC context
*/
void freeSha1HmacContext(void* ctx);
/**
* @}
*/
#endif
|
