blob: 241b1868c1d01c5730d919ee598c804e2038de75 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * Cryptographic API.
3 *
4 * HMAC: Keyed-Hashing for Message Authentication (RFC2104).
5 *
6 * Copyright (c) 2002 James Morris <jmorris@intercode.com.au>
Herbert Xu0796ae02006-08-21 20:50:52 +10007 * Copyright (c) 2006 Herbert Xu <herbert@gondor.apana.org.au>
Linus Torvalds1da177e2005-04-16 15:20:36 -07008 *
9 * The HMAC implementation is derived from USAGI.
10 * Copyright (c) 2002 Kazunori Miyazawa <miyazawa@linux-ipv6.org> / USAGI
11 *
12 * This program is free software; you can redistribute it and/or modify it
13 * under the terms of the GNU General Public License as published by the Free
Herbert Xu0796ae02006-08-21 20:50:52 +100014 * Software Foundation; either version 2 of the License, or (at your option)
Linus Torvalds1da177e2005-04-16 15:20:36 -070015 * any later version.
16 *
17 */
Herbert Xu0796ae02006-08-21 20:50:52 +100018
Corentin LABBE03d7db52017-05-19 08:53:23 +020019#include <crypto/hmac.h>
Herbert Xu5f7082e2008-08-31 22:21:09 +100020#include <crypto/internal/hash.h>
Herbert Xub2ab4a52007-12-05 20:59:25 +110021#include <crypto/scatterwalk.h>
Herbert Xu0796ae02006-08-21 20:50:52 +100022#include <linux/err.h>
23#include <linux/init.h>
24#include <linux/kernel.h>
25#include <linux/module.h>
David Hardeman378f0582005-09-17 17:55:31 +100026#include <linux/scatterlist.h>
Herbert Xu0796ae02006-08-21 20:50:52 +100027#include <linux/string.h>
28
29struct hmac_ctx {
Herbert Xu0b767b42009-07-24 15:18:41 +080030 struct crypto_shash *hash;
Herbert Xu0796ae02006-08-21 20:50:52 +100031};
Linus Torvalds1da177e2005-04-16 15:20:36 -070032
Herbert Xu0796ae02006-08-21 20:50:52 +100033static inline void *align_ptr(void *p, unsigned int align)
34{
35 return (void *)ALIGN((unsigned long)p, align);
36}
37
Herbert Xu8bd12092009-07-09 12:43:37 +080038static inline struct hmac_ctx *hmac_ctx(struct crypto_shash *tfm)
Herbert Xu0796ae02006-08-21 20:50:52 +100039{
Herbert Xu8bd12092009-07-09 12:43:37 +080040 return align_ptr(crypto_shash_ctx_aligned(tfm) +
Herbert Xu0b767b42009-07-24 15:18:41 +080041 crypto_shash_statesize(tfm) * 2,
Herbert Xu8bd12092009-07-09 12:43:37 +080042 crypto_tfm_ctx_alignment());
Herbert Xu0796ae02006-08-21 20:50:52 +100043}
44
Herbert Xu8bd12092009-07-09 12:43:37 +080045static int hmac_setkey(struct crypto_shash *parent,
Herbert Xu0796ae02006-08-21 20:50:52 +100046 const u8 *inkey, unsigned int keylen)
47{
Herbert Xu8bd12092009-07-09 12:43:37 +080048 int bs = crypto_shash_blocksize(parent);
49 int ds = crypto_shash_digestsize(parent);
Herbert Xu0b767b42009-07-24 15:18:41 +080050 int ss = crypto_shash_statesize(parent);
Herbert Xu8bd12092009-07-09 12:43:37 +080051 char *ipad = crypto_shash_ctx_aligned(parent);
Herbert Xu0b767b42009-07-24 15:18:41 +080052 char *opad = ipad + ss;
53 struct hmac_ctx *ctx = align_ptr(opad + ss,
Herbert Xu8bd12092009-07-09 12:43:37 +080054 crypto_tfm_ctx_alignment());
Herbert Xu0b767b42009-07-24 15:18:41 +080055 struct crypto_shash *hash = ctx->hash;
Jan-Simon Möllerffb32e92012-07-02 13:47:40 +020056 SHASH_DESC_ON_STACK(shash, hash);
Herbert Xu0796ae02006-08-21 20:50:52 +100057 unsigned int i;
58
Jan-Simon Möllerffb32e92012-07-02 13:47:40 +020059 shash->tfm = hash;
Herbert Xu0b767b42009-07-24 15:18:41 +080060
Herbert Xu0796ae02006-08-21 20:50:52 +100061 if (keylen > bs) {
Herbert Xu0796ae02006-08-21 20:50:52 +100062 int err;
63
Jan-Simon Möllerffb32e92012-07-02 13:47:40 +020064 err = crypto_shash_digest(shash, inkey, keylen, ipad);
Herbert Xu0796ae02006-08-21 20:50:52 +100065 if (err)
66 return err;
67
Herbert Xu0796ae02006-08-21 20:50:52 +100068 keylen = ds;
Herbert Xu0b767b42009-07-24 15:18:41 +080069 } else
70 memcpy(ipad, inkey, keylen);
Herbert Xu0796ae02006-08-21 20:50:52 +100071
Herbert Xu0796ae02006-08-21 20:50:52 +100072 memset(ipad + keylen, 0, bs - keylen);
73 memcpy(opad, ipad, bs);
74
75 for (i = 0; i < bs; i++) {
Corentin LABBE03d7db52017-05-19 08:53:23 +020076 ipad[i] ^= HMAC_IPAD_VALUE;
77 opad[i] ^= HMAC_OPAD_VALUE;
Herbert Xu0796ae02006-08-21 20:50:52 +100078 }
79
Jan-Simon Möllerffb32e92012-07-02 13:47:40 +020080 return crypto_shash_init(shash) ?:
81 crypto_shash_update(shash, ipad, bs) ?:
82 crypto_shash_export(shash, ipad) ?:
83 crypto_shash_init(shash) ?:
84 crypto_shash_update(shash, opad, bs) ?:
85 crypto_shash_export(shash, opad);
Herbert Xu0b767b42009-07-24 15:18:41 +080086}
87
88static int hmac_export(struct shash_desc *pdesc, void *out)
89{
90 struct shash_desc *desc = shash_desc_ctx(pdesc);
91
Herbert Xu0b767b42009-07-24 15:18:41 +080092 return crypto_shash_export(desc, out);
93}
94
95static int hmac_import(struct shash_desc *pdesc, const void *in)
96{
97 struct shash_desc *desc = shash_desc_ctx(pdesc);
98 struct hmac_ctx *ctx = hmac_ctx(pdesc->tfm);
99
100 desc->tfm = ctx->hash;
Herbert Xu0b767b42009-07-24 15:18:41 +0800101
102 return crypto_shash_import(desc, in);
Herbert Xu0796ae02006-08-21 20:50:52 +1000103}
104
Herbert Xu8bd12092009-07-09 12:43:37 +0800105static int hmac_init(struct shash_desc *pdesc)
Herbert Xu0796ae02006-08-21 20:50:52 +1000106{
Herbert Xu0b767b42009-07-24 15:18:41 +0800107 return hmac_import(pdesc, crypto_shash_ctx_aligned(pdesc->tfm));
Herbert Xu0796ae02006-08-21 20:50:52 +1000108}
109
Herbert Xu8bd12092009-07-09 12:43:37 +0800110static int hmac_update(struct shash_desc *pdesc,
111 const u8 *data, unsigned int nbytes)
Herbert Xu0796ae02006-08-21 20:50:52 +1000112{
Herbert Xu8bd12092009-07-09 12:43:37 +0800113 struct shash_desc *desc = shash_desc_ctx(pdesc);
Herbert Xu0796ae02006-08-21 20:50:52 +1000114
Herbert Xu8bd12092009-07-09 12:43:37 +0800115 return crypto_shash_update(desc, data, nbytes);
Herbert Xu0796ae02006-08-21 20:50:52 +1000116}
117
Herbert Xu8bd12092009-07-09 12:43:37 +0800118static int hmac_final(struct shash_desc *pdesc, u8 *out)
Herbert Xu0796ae02006-08-21 20:50:52 +1000119{
Herbert Xu8bd12092009-07-09 12:43:37 +0800120 struct crypto_shash *parent = pdesc->tfm;
Herbert Xu8bd12092009-07-09 12:43:37 +0800121 int ds = crypto_shash_digestsize(parent);
Herbert Xu0b767b42009-07-24 15:18:41 +0800122 int ss = crypto_shash_statesize(parent);
123 char *opad = crypto_shash_ctx_aligned(parent) + ss;
Herbert Xu8bd12092009-07-09 12:43:37 +0800124 struct shash_desc *desc = shash_desc_ctx(pdesc);
Herbert Xu0796ae02006-08-21 20:50:52 +1000125
Herbert Xu0b767b42009-07-24 15:18:41 +0800126 return crypto_shash_final(desc, out) ?:
127 crypto_shash_import(desc, opad) ?:
128 crypto_shash_finup(desc, out, ds, out);
Herbert Xu0796ae02006-08-21 20:50:52 +1000129}
130
Herbert Xu8bd12092009-07-09 12:43:37 +0800131static int hmac_finup(struct shash_desc *pdesc, const u8 *data,
132 unsigned int nbytes, u8 *out)
Herbert Xu0796ae02006-08-21 20:50:52 +1000133{
Herbert Xu8bd12092009-07-09 12:43:37 +0800134
135 struct crypto_shash *parent = pdesc->tfm;
Herbert Xu8bd12092009-07-09 12:43:37 +0800136 int ds = crypto_shash_digestsize(parent);
Herbert Xu0b767b42009-07-24 15:18:41 +0800137 int ss = crypto_shash_statesize(parent);
138 char *opad = crypto_shash_ctx_aligned(parent) + ss;
Herbert Xu8bd12092009-07-09 12:43:37 +0800139 struct shash_desc *desc = shash_desc_ctx(pdesc);
Herbert Xu0796ae02006-08-21 20:50:52 +1000140
Herbert Xu0b767b42009-07-24 15:18:41 +0800141 return crypto_shash_finup(desc, data, nbytes, out) ?:
142 crypto_shash_import(desc, opad) ?:
143 crypto_shash_finup(desc, out, ds, out);
Herbert Xu0796ae02006-08-21 20:50:52 +1000144}
145
146static int hmac_init_tfm(struct crypto_tfm *tfm)
147{
Herbert Xu8bd12092009-07-09 12:43:37 +0800148 struct crypto_shash *parent = __crypto_shash_cast(tfm);
149 struct crypto_shash *hash;
Herbert Xu0796ae02006-08-21 20:50:52 +1000150 struct crypto_instance *inst = (void *)tfm->__crt_alg;
Herbert Xu8bd12092009-07-09 12:43:37 +0800151 struct crypto_shash_spawn *spawn = crypto_instance_ctx(inst);
152 struct hmac_ctx *ctx = hmac_ctx(parent);
Herbert Xu0796ae02006-08-21 20:50:52 +1000153
Herbert Xu8bd12092009-07-09 12:43:37 +0800154 hash = crypto_spawn_shash(spawn);
Herbert Xu2e306ee2006-12-17 10:05:58 +1100155 if (IS_ERR(hash))
156 return PTR_ERR(hash);
Herbert Xu0796ae02006-08-21 20:50:52 +1000157
Herbert Xu8bd12092009-07-09 12:43:37 +0800158 parent->descsize = sizeof(struct shash_desc) +
159 crypto_shash_descsize(hash);
Eric Biggerse1354402019-05-14 16:13:15 -0700160 if (WARN_ON(parent->descsize > HASH_MAX_DESCSIZE))
161 return -EINVAL;
Herbert Xu8bd12092009-07-09 12:43:37 +0800162
Herbert Xu0b767b42009-07-24 15:18:41 +0800163 ctx->hash = hash;
Herbert Xu0796ae02006-08-21 20:50:52 +1000164 return 0;
165}
166
167static void hmac_exit_tfm(struct crypto_tfm *tfm)
168{
Herbert Xu8bd12092009-07-09 12:43:37 +0800169 struct hmac_ctx *ctx = hmac_ctx(__crypto_shash_cast(tfm));
Herbert Xu0b767b42009-07-24 15:18:41 +0800170 crypto_free_shash(ctx->hash);
Herbert Xu0796ae02006-08-21 20:50:52 +1000171}
172
Herbert Xu8bd12092009-07-09 12:43:37 +0800173static int hmac_create(struct crypto_template *tmpl, struct rtattr **tb)
Herbert Xu0796ae02006-08-21 20:50:52 +1000174{
Herbert Xu8bd12092009-07-09 12:43:37 +0800175 struct shash_instance *inst;
Herbert Xu0796ae02006-08-21 20:50:52 +1000176 struct crypto_alg *alg;
Herbert Xu8bd12092009-07-09 12:43:37 +0800177 struct shash_alg *salg;
Herbert Xuebc610e2007-01-01 18:37:02 +1100178 int err;
Herbert Xuca786dc2008-07-07 20:23:56 +0800179 int ds;
Herbert Xu0b767b42009-07-24 15:18:41 +0800180 int ss;
Herbert Xu0796ae02006-08-21 20:50:52 +1000181
Herbert Xu8bd12092009-07-09 12:43:37 +0800182 err = crypto_check_attr_type(tb, CRYPTO_ALG_TYPE_SHASH);
Herbert Xuebc610e2007-01-01 18:37:02 +1100183 if (err)
Herbert Xu8bd12092009-07-09 12:43:37 +0800184 return err;
Herbert Xuebc610e2007-01-01 18:37:02 +1100185
Herbert Xu8bd12092009-07-09 12:43:37 +0800186 salg = shash_attr_alg(tb[1], 0, 0);
187 if (IS_ERR(salg))
188 return PTR_ERR(salg);
Eric Biggersaf3ff802017-11-28 18:01:38 -0800189 alg = &salg->base;
Herbert Xu0796ae02006-08-21 20:50:52 +1000190
Eric Biggersaf3ff802017-11-28 18:01:38 -0800191 /* The underlying hash algorithm must be unkeyed */
Herbert Xu8bd12092009-07-09 12:43:37 +0800192 err = -EINVAL;
Eric Biggersaf3ff802017-11-28 18:01:38 -0800193 if (crypto_shash_alg_has_setkey(salg))
194 goto out_put_alg;
195
Herbert Xu8bd12092009-07-09 12:43:37 +0800196 ds = salg->digestsize;
Herbert Xu0b767b42009-07-24 15:18:41 +0800197 ss = salg->statesize;
Herbert Xu0b767b42009-07-24 15:18:41 +0800198 if (ds > alg->cra_blocksize ||
199 ss < alg->cra_blocksize)
Herbert Xuca786dc2008-07-07 20:23:56 +0800200 goto out_put_alg;
201
Herbert Xu8bd12092009-07-09 12:43:37 +0800202 inst = shash_alloc_instance("hmac", alg);
Herbert Xu3b3fc322009-07-15 16:52:55 +0800203 err = PTR_ERR(inst);
Herbert Xu0796ae02006-08-21 20:50:52 +1000204 if (IS_ERR(inst))
205 goto out_put_alg;
206
Herbert Xu8bd12092009-07-09 12:43:37 +0800207 err = crypto_init_shash_spawn(shash_instance_ctx(inst), salg,
208 shash_crypto_instance(inst));
209 if (err)
210 goto out_free_inst;
Herbert Xu0796ae02006-08-21 20:50:52 +1000211
Herbert Xu8bd12092009-07-09 12:43:37 +0800212 inst->alg.base.cra_priority = alg->cra_priority;
213 inst->alg.base.cra_blocksize = alg->cra_blocksize;
214 inst->alg.base.cra_alignmask = alg->cra_alignmask;
Herbert Xu0796ae02006-08-21 20:50:52 +1000215
Herbert Xu0b767b42009-07-24 15:18:41 +0800216 ss = ALIGN(ss, alg->cra_alignmask + 1);
Herbert Xu8bd12092009-07-09 12:43:37 +0800217 inst->alg.digestsize = ds;
Herbert Xu0b767b42009-07-24 15:18:41 +0800218 inst->alg.statesize = ss;
Herbert Xu0796ae02006-08-21 20:50:52 +1000219
Herbert Xu8bd12092009-07-09 12:43:37 +0800220 inst->alg.base.cra_ctxsize = sizeof(struct hmac_ctx) +
Herbert Xu0b767b42009-07-24 15:18:41 +0800221 ALIGN(ss * 2, crypto_tfm_ctx_alignment());
Herbert Xu0796ae02006-08-21 20:50:52 +1000222
Herbert Xu8bd12092009-07-09 12:43:37 +0800223 inst->alg.base.cra_init = hmac_init_tfm;
224 inst->alg.base.cra_exit = hmac_exit_tfm;
225
226 inst->alg.init = hmac_init;
227 inst->alg.update = hmac_update;
228 inst->alg.final = hmac_final;
229 inst->alg.finup = hmac_finup;
Herbert Xu0b767b42009-07-24 15:18:41 +0800230 inst->alg.export = hmac_export;
231 inst->alg.import = hmac_import;
Herbert Xu8bd12092009-07-09 12:43:37 +0800232 inst->alg.setkey = hmac_setkey;
233
234 err = shash_register_instance(tmpl, inst);
235 if (err) {
236out_free_inst:
237 shash_free_instance(shash_crypto_instance(inst));
238 }
Herbert Xu0796ae02006-08-21 20:50:52 +1000239
240out_put_alg:
241 crypto_mod_put(alg);
Herbert Xu8bd12092009-07-09 12:43:37 +0800242 return err;
Herbert Xu0796ae02006-08-21 20:50:52 +1000243}
244
245static struct crypto_template hmac_tmpl = {
246 .name = "hmac",
Herbert Xu8bd12092009-07-09 12:43:37 +0800247 .create = hmac_create,
248 .free = shash_free_instance,
Herbert Xu0796ae02006-08-21 20:50:52 +1000249 .module = THIS_MODULE,
250};
251
252static int __init hmac_module_init(void)
253{
254 return crypto_register_template(&hmac_tmpl);
255}
256
257static void __exit hmac_module_exit(void)
258{
259 crypto_unregister_template(&hmac_tmpl);
260}
261
Eric Biggersc4741b22019-04-11 21:57:42 -0700262subsys_initcall(hmac_module_init);
Herbert Xu0796ae02006-08-21 20:50:52 +1000263module_exit(hmac_module_exit);
264
265MODULE_LICENSE("GPL");
266MODULE_DESCRIPTION("HMAC hash algorithm");
Kees Cook4943ba12014-11-24 16:32:38 -0800267MODULE_ALIAS_CRYPTO("hmac");