2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
13 #include "internal/cryptlib.h"
14 #include <openssl/hmac.h>
15 #include <openssl/opensslconf.h>
16 #include "hmac_local.h"
18 int HMAC_Init_ex(HMAC_CTX *ctx, const void *key, int len,
19 const EVP_MD *md, ENGINE *impl)
21 int rv = 0, reset = 0;
23 unsigned char pad[HMAC_MAX_MD_CBLOCK_SIZE];
24 unsigned int keytmp_length;
25 unsigned char keytmp[HMAC_MAX_MD_CBLOCK_SIZE];
27 /* If we are changing MD then we must have a key */
28 if (md != NULL && md != ctx->md && (key == NULL || len < 0))
40 * The HMAC construction is not allowed to be used with the
41 * extendable-output functions (XOF) shake128 and shake256.
43 if ((EVP_MD_flags(md) & EVP_MD_FLAG_XOF) != 0)
49 j = EVP_MD_block_size(md);
50 if (!ossl_assert(j <= (int)sizeof(keytmp)))
53 if (!EVP_DigestInit_ex(ctx->md_ctx, md, impl)
54 || !EVP_DigestUpdate(ctx->md_ctx, key, len)
55 || !EVP_DigestFinal_ex(ctx->md_ctx, keytmp,
59 if (len < 0 || len > (int)sizeof(keytmp))
61 memcpy(keytmp, key, len);
64 if (keytmp_length != HMAC_MAX_MD_CBLOCK_SIZE)
65 memset(&keytmp[keytmp_length], 0,
66 HMAC_MAX_MD_CBLOCK_SIZE - keytmp_length);
68 for (i = 0; i < HMAC_MAX_MD_CBLOCK_SIZE; i++)
69 pad[i] = 0x36 ^ keytmp[i];
70 if (!EVP_DigestInit_ex(ctx->i_ctx, md, impl)
71 || !EVP_DigestUpdate(ctx->i_ctx, pad, EVP_MD_block_size(md)))
74 for (i = 0; i < HMAC_MAX_MD_CBLOCK_SIZE; i++)
75 pad[i] = 0x5c ^ keytmp[i];
76 if (!EVP_DigestInit_ex(ctx->o_ctx, md, impl)
77 || !EVP_DigestUpdate(ctx->o_ctx, pad, EVP_MD_block_size(md)))
80 if (!EVP_MD_CTX_copy_ex(ctx->md_ctx, ctx->i_ctx))
85 OPENSSL_cleanse(keytmp, sizeof(keytmp));
86 OPENSSL_cleanse(pad, sizeof(pad));
91 #ifndef OPENSSL_NO_DEPRECATED_1_1_0
92 int HMAC_Init(HMAC_CTX *ctx, const void *key, int len, const EVP_MD *md)
96 return HMAC_Init_ex(ctx, key, len, md, NULL);
100 int HMAC_Update(HMAC_CTX *ctx, const unsigned char *data, size_t len)
104 return EVP_DigestUpdate(ctx->md_ctx, data, len);
107 int HMAC_Final(HMAC_CTX *ctx, unsigned char *md, unsigned int *len)
110 unsigned char buf[EVP_MAX_MD_SIZE];
115 if (!EVP_DigestFinal_ex(ctx->md_ctx, buf, &i))
117 if (!EVP_MD_CTX_copy_ex(ctx->md_ctx, ctx->o_ctx))
119 if (!EVP_DigestUpdate(ctx->md_ctx, buf, i))
121 if (!EVP_DigestFinal_ex(ctx->md_ctx, md, len))
128 size_t HMAC_size(const HMAC_CTX *ctx)
130 int size = EVP_MD_size((ctx)->md);
132 return (size < 0) ? 0 : size;
135 HMAC_CTX *HMAC_CTX_new(void)
137 HMAC_CTX *ctx = OPENSSL_zalloc(sizeof(HMAC_CTX));
140 if (!HMAC_CTX_reset(ctx)) {
148 static void hmac_ctx_cleanup(HMAC_CTX *ctx)
150 EVP_MD_CTX_reset(ctx->i_ctx);
151 EVP_MD_CTX_reset(ctx->o_ctx);
152 EVP_MD_CTX_reset(ctx->md_ctx);
156 void HMAC_CTX_free(HMAC_CTX *ctx)
159 hmac_ctx_cleanup(ctx);
160 EVP_MD_CTX_free(ctx->i_ctx);
161 EVP_MD_CTX_free(ctx->o_ctx);
162 EVP_MD_CTX_free(ctx->md_ctx);
167 static int hmac_ctx_alloc_mds(HMAC_CTX *ctx)
169 if (ctx->i_ctx == NULL)
170 ctx->i_ctx = EVP_MD_CTX_new();
171 if (ctx->i_ctx == NULL)
173 if (ctx->o_ctx == NULL)
174 ctx->o_ctx = EVP_MD_CTX_new();
175 if (ctx->o_ctx == NULL)
177 if (ctx->md_ctx == NULL)
178 ctx->md_ctx = EVP_MD_CTX_new();
179 if (ctx->md_ctx == NULL)
184 int HMAC_CTX_reset(HMAC_CTX *ctx)
186 hmac_ctx_cleanup(ctx);
187 if (!hmac_ctx_alloc_mds(ctx)) {
188 hmac_ctx_cleanup(ctx);
194 int HMAC_CTX_copy(HMAC_CTX *dctx, HMAC_CTX *sctx)
196 if (!hmac_ctx_alloc_mds(dctx))
198 if (!EVP_MD_CTX_copy_ex(dctx->i_ctx, sctx->i_ctx))
200 if (!EVP_MD_CTX_copy_ex(dctx->o_ctx, sctx->o_ctx))
202 if (!EVP_MD_CTX_copy_ex(dctx->md_ctx, sctx->md_ctx))
207 hmac_ctx_cleanup(dctx);
211 unsigned char *HMAC(const EVP_MD *evp_md, const void *key, int key_len,
212 const unsigned char *d, size_t n, unsigned char *md,
213 unsigned int *md_len)
216 static unsigned char m[EVP_MAX_MD_SIZE];
217 static const unsigned char dummy_key[1] = {'\0'};
221 if ((c = HMAC_CTX_new()) == NULL)
224 /* For HMAC_Init_ex, NULL key signals reuse. */
225 if (key == NULL && key_len == 0) {
229 if (!HMAC_Init_ex(c, key, key_len, evp_md, NULL))
231 if (!HMAC_Update(c, d, n))
233 if (!HMAC_Final(c, md, md_len))
242 void HMAC_CTX_set_flags(HMAC_CTX *ctx, unsigned long flags)
244 EVP_MD_CTX_set_flags(ctx->i_ctx, flags);
245 EVP_MD_CTX_set_flags(ctx->o_ctx, flags);
246 EVP_MD_CTX_set_flags(ctx->md_ctx, flags);
249 const EVP_MD *HMAC_CTX_get_md(const HMAC_CTX *ctx)