Coverage Report

Created: 2023-09-25 06:45

/src/openssl/providers/implementations/macs/cmac_prov.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2018-2023 The OpenSSL Project Authors. All Rights Reserved.
3
 *
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
8
 */
9
10
/*
11
 * CMAC low level APIs are deprecated for public use, but still ok for internal
12
 * use.
13
 */
14
#include "internal/deprecated.h"
15
16
#include <openssl/core_dispatch.h>
17
#include <openssl/core_names.h>
18
#include <openssl/params.h>
19
#include <openssl/evp.h>
20
#include <openssl/cmac.h>
21
#include <openssl/err.h>
22
#include <openssl/proverr.h>
23
24
#include "prov/implementations.h"
25
#include "prov/provider_ctx.h"
26
#include "prov/provider_util.h"
27
#include "prov/providercommon.h"
28
29
/*
30
 * Forward declaration of everything implemented here.  This is not strictly
31
 * necessary for the compiler, but provides an assurance that the signatures
32
 * of the functions in the dispatch table are correct.
33
 */
34
static OSSL_FUNC_mac_newctx_fn cmac_new;
35
static OSSL_FUNC_mac_dupctx_fn cmac_dup;
36
static OSSL_FUNC_mac_freectx_fn cmac_free;
37
static OSSL_FUNC_mac_gettable_ctx_params_fn cmac_gettable_ctx_params;
38
static OSSL_FUNC_mac_get_ctx_params_fn cmac_get_ctx_params;
39
static OSSL_FUNC_mac_settable_ctx_params_fn cmac_settable_ctx_params;
40
static OSSL_FUNC_mac_set_ctx_params_fn cmac_set_ctx_params;
41
static OSSL_FUNC_mac_init_fn cmac_init;
42
static OSSL_FUNC_mac_update_fn cmac_update;
43
static OSSL_FUNC_mac_final_fn cmac_final;
44
45
/* local CMAC data */
46
47
struct cmac_data_st {
48
    void *provctx;
49
    CMAC_CTX *ctx;
50
    PROV_CIPHER cipher;
51
};
52
53
static void *cmac_new(void *provctx)
54
0
{
55
0
    struct cmac_data_st *macctx;
56
57
0
    if (!ossl_prov_is_running())
58
0
        return NULL;
59
60
0
    if ((macctx = OPENSSL_zalloc(sizeof(*macctx))) == NULL
61
0
        || (macctx->ctx = CMAC_CTX_new()) == NULL) {
62
0
        OPENSSL_free(macctx);
63
0
        macctx = NULL;
64
0
    } else {
65
0
        macctx->provctx = provctx;
66
0
    }
67
68
0
    return macctx;
69
0
}
70
71
static void cmac_free(void *vmacctx)
72
0
{
73
0
    struct cmac_data_st *macctx = vmacctx;
74
75
0
    if (macctx != NULL) {
76
0
        CMAC_CTX_free(macctx->ctx);
77
0
        ossl_prov_cipher_reset(&macctx->cipher);
78
0
        OPENSSL_free(macctx);
79
0
    }
80
0
}
81
82
static void *cmac_dup(void *vsrc)
83
0
{
84
0
    struct cmac_data_st *src = vsrc;
85
0
    struct cmac_data_st *dst;
86
87
0
    if (!ossl_prov_is_running())
88
0
        return NULL;
89
90
0
    dst = cmac_new(src->provctx);
91
0
    if (dst == NULL)
92
0
        return NULL;
93
0
    if (!CMAC_CTX_copy(dst->ctx, src->ctx)
94
0
        || !ossl_prov_cipher_copy(&dst->cipher, &src->cipher)) {
95
0
        cmac_free(dst);
96
0
        return NULL;
97
0
    }
98
0
    return dst;
99
0
}
100
101
static size_t cmac_size(void *vmacctx)
102
0
{
103
0
    struct cmac_data_st *macctx = vmacctx;
104
105
0
    return EVP_CIPHER_CTX_get_block_size(CMAC_CTX_get0_cipher_ctx(macctx->ctx));
106
0
}
107
108
static int cmac_setkey(struct cmac_data_st *macctx,
109
                       const unsigned char *key, size_t keylen)
110
0
{
111
0
    int rv = CMAC_Init(macctx->ctx, key, keylen,
112
0
                       ossl_prov_cipher_cipher(&macctx->cipher),
113
0
                       ossl_prov_cipher_engine(&macctx->cipher));
114
0
    ossl_prov_cipher_reset(&macctx->cipher);
115
0
    return rv;
116
0
}
117
118
static int cmac_init(void *vmacctx, const unsigned char *key,
119
                     size_t keylen, const OSSL_PARAM params[])
120
0
{
121
0
    struct cmac_data_st *macctx = vmacctx;
122
123
0
    if (!ossl_prov_is_running() || !cmac_set_ctx_params(macctx, params))
124
0
        return 0;
125
0
    if (key != NULL)
126
0
        return cmac_setkey(macctx, key, keylen);
127
    /* Reinitialize the CMAC context */
128
0
    return CMAC_Init(macctx->ctx, NULL, 0, NULL, NULL);
129
0
}
130
131
static int cmac_update(void *vmacctx, const unsigned char *data,
132
                       size_t datalen)
133
0
{
134
0
    struct cmac_data_st *macctx = vmacctx;
135
136
0
    return CMAC_Update(macctx->ctx, data, datalen);
137
0
}
138
139
static int cmac_final(void *vmacctx, unsigned char *out, size_t *outl,
140
                      size_t outsize)
141
0
{
142
0
    struct cmac_data_st *macctx = vmacctx;
143
144
0
    if (!ossl_prov_is_running())
145
0
        return 0;
146
147
0
    return CMAC_Final(macctx->ctx, out, outl);
148
0
}
149
150
static const OSSL_PARAM known_gettable_ctx_params[] = {
151
    OSSL_PARAM_size_t(OSSL_MAC_PARAM_SIZE, NULL),
152
    OSSL_PARAM_size_t(OSSL_MAC_PARAM_BLOCK_SIZE, NULL),
153
    OSSL_PARAM_END
154
};
155
static const OSSL_PARAM *cmac_gettable_ctx_params(ossl_unused void *ctx,
156
                                                  ossl_unused void *provctx)
157
0
{
158
0
    return known_gettable_ctx_params;
159
0
}
160
161
static int cmac_get_ctx_params(void *vmacctx, OSSL_PARAM params[])
162
0
{
163
0
    OSSL_PARAM *p;
164
165
0
    if ((p = OSSL_PARAM_locate(params, OSSL_MAC_PARAM_SIZE)) != NULL
166
0
            && !OSSL_PARAM_set_size_t(p, cmac_size(vmacctx)))
167
0
        return 0;
168
169
0
    if ((p = OSSL_PARAM_locate(params, OSSL_MAC_PARAM_BLOCK_SIZE)) != NULL
170
0
            && !OSSL_PARAM_set_size_t(p, cmac_size(vmacctx)))
171
0
        return 0;
172
173
0
    return 1;
174
0
}
175
176
static const OSSL_PARAM known_settable_ctx_params[] = {
177
    OSSL_PARAM_utf8_string(OSSL_MAC_PARAM_CIPHER, NULL, 0),
178
    OSSL_PARAM_utf8_string(OSSL_MAC_PARAM_PROPERTIES, NULL, 0),
179
    OSSL_PARAM_octet_string(OSSL_MAC_PARAM_KEY, NULL, 0),
180
    OSSL_PARAM_END
181
};
182
static const OSSL_PARAM *cmac_settable_ctx_params(ossl_unused void *ctx,
183
                                                  ossl_unused void *provctx)
184
0
{
185
0
    return known_settable_ctx_params;
186
0
}
187
188
/*
189
 * ALL parameters should be set before init().
190
 */
191
static int cmac_set_ctx_params(void *vmacctx, const OSSL_PARAM params[])
192
0
{
193
0
    struct cmac_data_st *macctx = vmacctx;
194
0
    OSSL_LIB_CTX *ctx = PROV_LIBCTX_OF(macctx->provctx);
195
0
    const OSSL_PARAM *p;
196
197
0
    if (params == NULL)
198
0
        return 1;
199
200
0
    if ((p = OSSL_PARAM_locate_const(params, OSSL_MAC_PARAM_CIPHER)) != NULL) {
201
0
        if (!ossl_prov_cipher_load_from_params(&macctx->cipher, params, ctx))
202
0
            return 0;
203
204
0
        if (EVP_CIPHER_get_mode(ossl_prov_cipher_cipher(&macctx->cipher))
205
0
            != EVP_CIPH_CBC_MODE) {
206
0
            ERR_raise(ERR_LIB_PROV, PROV_R_INVALID_MODE);
207
0
            return 0;
208
0
        }
209
0
    }
210
211
0
    if ((p = OSSL_PARAM_locate_const(params, OSSL_MAC_PARAM_KEY)) != NULL) {
212
0
        if (p->data_type != OSSL_PARAM_OCTET_STRING)
213
0
            return 0;
214
0
        return cmac_setkey(macctx, p->data, p->data_size);
215
0
    }
216
0
    return 1;
217
0
}
218
219
const OSSL_DISPATCH ossl_cmac_functions[] = {
220
    { OSSL_FUNC_MAC_NEWCTX, (void (*)(void))cmac_new },
221
    { OSSL_FUNC_MAC_DUPCTX, (void (*)(void))cmac_dup },
222
    { OSSL_FUNC_MAC_FREECTX, (void (*)(void))cmac_free },
223
    { OSSL_FUNC_MAC_INIT, (void (*)(void))cmac_init },
224
    { OSSL_FUNC_MAC_UPDATE, (void (*)(void))cmac_update },
225
    { OSSL_FUNC_MAC_FINAL, (void (*)(void))cmac_final },
226
    { OSSL_FUNC_MAC_GETTABLE_CTX_PARAMS,
227
      (void (*)(void))cmac_gettable_ctx_params },
228
    { OSSL_FUNC_MAC_GET_CTX_PARAMS, (void (*)(void))cmac_get_ctx_params },
229
    { OSSL_FUNC_MAC_SETTABLE_CTX_PARAMS,
230
      (void (*)(void))cmac_settable_ctx_params },
231
    { OSSL_FUNC_MAC_SET_CTX_PARAMS, (void (*)(void))cmac_set_ctx_params },
232
    OSSL_DISPATCH_END
233
};