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>