Annotation of embedaddon/curl/lib/hmac.c, revision 1.1.1.1
1.1 misho 1: /***************************************************************************
2: * _ _ ____ _
3: * Project ___| | | | _ \| |
4: * / __| | | | |_) | |
5: * | (__| |_| | _ <| |___
6: * \___|\___/|_| \_\_____|
7: *
8: * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
9: *
10: * This software is licensed as described in the file COPYING, which
11: * you should have received as part of this distribution. The terms
12: * are also available at https://curl.haxx.se/docs/copyright.html.
13: *
14: * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15: * copies of the Software, and permit persons to whom the Software is
16: * furnished to do so, under the terms of the COPYING file.
17: *
18: * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19: * KIND, either express or implied.
20: *
21: * RFC2104 Keyed-Hashing for Message Authentication
22: *
23: ***************************************************************************/
24:
25: #include "curl_setup.h"
26:
27: #ifndef CURL_DISABLE_CRYPTO_AUTH
28:
29: #include <curl/curl.h>
30:
31: #include "curl_hmac.h"
32: #include "curl_memory.h"
33: #include "warnless.h"
34:
35: /* The last #include file should be: */
36: #include "memdebug.h"
37:
38: /*
39: * Generic HMAC algorithm.
40: *
41: * This module computes HMAC digests based on any hash function. Parameters
42: * and computing procedures are set-up dynamically at HMAC computation
43: * context initialisation.
44: */
45:
46: static const unsigned char hmac_ipad = 0x36;
47: static const unsigned char hmac_opad = 0x5C;
48:
49:
50:
51: HMAC_context *
52: Curl_HMAC_init(const HMAC_params * hashparams,
53: const unsigned char *key,
54: unsigned int keylen)
55: {
56: size_t i;
57: HMAC_context *ctxt;
58: unsigned char *hkey;
59: unsigned char b;
60:
61: /* Create HMAC context. */
62: i = sizeof(*ctxt) + 2 * hashparams->hmac_ctxtsize +
63: hashparams->hmac_resultlen;
64: ctxt = malloc(i);
65:
66: if(!ctxt)
67: return ctxt;
68:
69: ctxt->hmac_hash = hashparams;
70: ctxt->hmac_hashctxt1 = (void *) (ctxt + 1);
71: ctxt->hmac_hashctxt2 = (void *) ((char *) ctxt->hmac_hashctxt1 +
72: hashparams->hmac_ctxtsize);
73:
74: /* If the key is too long, replace it by its hash digest. */
75: if(keylen > hashparams->hmac_maxkeylen) {
76: (*hashparams->hmac_hinit)(ctxt->hmac_hashctxt1);
77: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt1, key, keylen);
78: hkey = (unsigned char *) ctxt->hmac_hashctxt2 + hashparams->hmac_ctxtsize;
79: (*hashparams->hmac_hfinal)(hkey, ctxt->hmac_hashctxt1);
80: key = hkey;
81: keylen = hashparams->hmac_resultlen;
82: }
83:
84: /* Prime the two hash contexts with the modified key. */
85: (*hashparams->hmac_hinit)(ctxt->hmac_hashctxt1);
86: (*hashparams->hmac_hinit)(ctxt->hmac_hashctxt2);
87:
88: for(i = 0; i < keylen; i++) {
89: b = (unsigned char)(*key ^ hmac_ipad);
90: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt1, &b, 1);
91: b = (unsigned char)(*key++ ^ hmac_opad);
92: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt2, &b, 1);
93: }
94:
95: for(; i < hashparams->hmac_maxkeylen; i++) {
96: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt1, &hmac_ipad, 1);
97: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt2, &hmac_opad, 1);
98: }
99:
100: /* Done, return pointer to HMAC context. */
101: return ctxt;
102: }
103:
104: int Curl_HMAC_update(HMAC_context * ctxt,
105: const unsigned char *data,
106: unsigned int len)
107: {
108: /* Update first hash calculation. */
109: (*ctxt->hmac_hash->hmac_hupdate)(ctxt->hmac_hashctxt1, data, len);
110: return 0;
111: }
112:
113:
114: int Curl_HMAC_final(HMAC_context *ctxt, unsigned char *result)
115: {
116: const HMAC_params * hashparams = ctxt->hmac_hash;
117:
118: /* Do not get result if called with a null parameter: only release
119: storage. */
120:
121: if(!result)
122: result = (unsigned char *) ctxt->hmac_hashctxt2 +
123: ctxt->hmac_hash->hmac_ctxtsize;
124:
125: (*hashparams->hmac_hfinal)(result, ctxt->hmac_hashctxt1);
126: (*hashparams->hmac_hupdate)(ctxt->hmac_hashctxt2,
127: result, hashparams->hmac_resultlen);
128: (*hashparams->hmac_hfinal)(result, ctxt->hmac_hashctxt2);
129: free((char *) ctxt);
130: return 0;
131: }
132:
133: /*
134: * Curl_hmacit()
135: *
136: * This is used to generate a HMAC hash, for the specified input data, given
137: * the specified hash function and key.
138: *
139: * Parameters:
140: *
141: * hashparams [in] - The hash function (Curl_HMAC_MD5).
142: * key [in] - The key to use.
143: * keylen [in] - The length of the key.
144: * data [in] - The data to encrypt.
145: * datalen [in] - The length of the data.
146: * output [in/out] - The output buffer.
147: *
148: * Returns CURLE_OK on success.
149: */
150: CURLcode Curl_hmacit(const HMAC_params *hashparams,
151: const unsigned char *key, const size_t keylen,
152: const unsigned char *data, const size_t datalen,
153: unsigned char *output)
154: {
155: HMAC_context *ctxt = Curl_HMAC_init(hashparams, key, curlx_uztoui(keylen));
156:
157: if(!ctxt)
158: return CURLE_OUT_OF_MEMORY;
159:
160: /* Update the digest with the given challenge */
161: Curl_HMAC_update(ctxt, data, curlx_uztoui(datalen));
162:
163: /* Finalise the digest */
164: Curl_HMAC_final(ctxt, output);
165:
166: return CURLE_OK;
167: }
168:
169: #endif /* CURL_DISABLE_CRYPTO_AUTH */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>