Annotation of embedaddon/curl/lib/hmac.c, revision 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>