Coverage Report

Created: 2026-09-12 06:55

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl41/crypto/cmp/cmp_protect.c
Line
Count
Source
1
/*
2
 * Copyright 2007-2026 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright Nokia 2007-2019
4
 * Copyright Siemens AG 2015-2019
5
 *
6
 * Licensed under the Apache License 2.0 (the "License").  You may not use
7
 * this file except in compliance with the License.  You can obtain a copy
8
 * in the file LICENSE in the source distribution or at
9
 * https://www.openssl.org/source/license.html
10
 */
11
12
#include "cmp_local.h"
13
#include "crypto/asn1.h" /* for ossl_X509_ALGOR_from_nid() */
14
15
/*
16
 * This function is also used by the internal verify_PBMAC() in cmp_vfy.c.
17
 *
18
 * Calculate protection for |msg| according to |msg->header->protectionAlg|
19
 * using the credentials, library context, and property criteria in the ctx.
20
 * Unless |msg->header->protectionAlg| is PasswordBasedMAC,
21
 * its value is completed according to |ctx->pkey| and |ctx->digest|,
22
 * where the latter irrelevant in the case of Edwards curves.
23
 *
24
 * returns ASN1_BIT_STRING representing the protection on success, else NULL
25
 */
26
ASN1_BIT_STRING *ossl_cmp_calc_protection(const OSSL_CMP_CTX *ctx,
27
    const OSSL_CMP_MSG *msg)
28
27
{
29
27
    ASN1_BIT_STRING *prot = NULL;
30
27
    OSSL_CMP_PROTECTEDPART prot_part;
31
27
    const ASN1_OBJECT *algorOID = NULL;
32
27
    const void *ppval = NULL;
33
27
    int pptype = 0;
34
35
27
    if (!ossl_assert(ctx != NULL && msg != NULL))
36
0
        return NULL;
37
38
    /* construct data to be signed */
39
27
    prot_part.header = msg->header;
40
27
    prot_part.body = msg->body;
41
42
27
    if (msg->header->protectionAlg == NULL) {
43
0
        ERR_raise(ERR_LIB_CMP, CMP_R_UNKNOWN_ALGORITHM_ID);
44
0
        return NULL;
45
0
    }
46
27
    X509_ALGOR_get0(&algorOID, &pptype, &ppval, msg->header->protectionAlg);
47
48
27
    if (OBJ_obj2nid(algorOID) == NID_id_PasswordBasedMAC) {
49
27
        int len;
50
27
        size_t prot_part_der_len;
51
27
        unsigned char *prot_part_der = NULL;
52
27
        size_t sig_len;
53
27
        unsigned char *protection = NULL;
54
27
        OSSL_CRMF_PBMPARAMETER *pbm = NULL;
55
27
        ASN1_STRING *pbm_str = NULL;
56
27
        const unsigned char *pbm_str_uc = NULL;
57
58
27
        if (ctx->secretValue == NULL) {
59
0
            ERR_raise(ERR_LIB_CMP, CMP_R_MISSING_PBM_SECRET);
60
0
            return NULL;
61
0
        }
62
27
        if (pptype != V_ASN1_SEQUENCE || ppval == NULL) {
63
1
            ERR_raise(ERR_LIB_CMP, CMP_R_ERROR_CALCULATING_PROTECTION);
64
1
            return NULL;
65
1
        }
66
67
26
        len = i2d_OSSL_CMP_PROTECTEDPART(&prot_part, &prot_part_der);
68
26
        if (len < 0 || prot_part_der == NULL) {
69
0
            ERR_raise(ERR_LIB_CMP, CMP_R_ERROR_CALCULATING_PROTECTION);
70
0
            goto end;
71
0
        }
72
26
        prot_part_der_len = (size_t)len;
73
74
26
        pbm_str = (ASN1_STRING *)ppval;
75
26
        pbm_str_uc = ASN1_STRING_get0_data(pbm_str);
76
26
        if (ASN1_STRING_get_length(pbm_str) > INT_MAX) {
77
0
            ERR_raise(ERR_LIB_CMP, CMP_R_WRONG_ALGORITHM_OID);
78
0
            goto end;
79
0
        }
80
26
        pbm = d2i_OSSL_CRMF_PBMPARAMETER(NULL, &pbm_str_uc, (long)ASN1_STRING_get_length(pbm_str));
81
26
        if (pbm == NULL) {
82
9
            ERR_raise(ERR_LIB_CMP, CMP_R_WRONG_ALGORITHM_OID);
83
9
            goto end;
84
9
        }
85
86
17
        if (!OSSL_CRMF_pbm_new(ctx->libctx, ctx->propq,
87
17
                pbm, prot_part_der, prot_part_der_len,
88
17
                ASN1_STRING_get0_data(ctx->secretValue), ASN1_STRING_get_length(ctx->secretValue),
89
17
                &protection, &sig_len))
90
17
            goto end;
91
92
0
        if (sig_len > INT_MAX || (prot = ASN1_BIT_STRING_new()) == NULL)
93
0
            goto end;
94
        /* OpenSSL by default encodes all bit strings as ASN.1 NamedBitList */
95
0
        if (!ASN1_BIT_STRING_set1(prot, protection, (int)sig_len, 0)) {
96
0
            ASN1_BIT_STRING_free(prot);
97
0
            prot = NULL;
98
0
        }
99
26
    end:
100
26
        OSSL_CRMF_PBMPARAMETER_free(pbm);
101
26
        OPENSSL_free(protection);
102
26
        OPENSSL_free(prot_part_der);
103
26
        return prot;
104
0
    } else {
105
0
        const EVP_MD *md = ctx->digest;
106
0
        char name[80] = "";
107
108
0
        if (ctx->pkey == NULL) {
109
0
            ERR_raise(ERR_LIB_CMP,
110
0
                CMP_R_MISSING_KEY_INPUT_FOR_CREATING_PROTECTION);
111
0
            return NULL;
112
0
        }
113
0
        if (EVP_PKEY_get_default_digest_name(ctx->pkey, name, sizeof(name)) > 0
114
0
            && strcmp(name, "UNDEF") == 0) /* at least for Ed25519, Ed448 */
115
0
            md = NULL;
116
117
0
        if ((prot = ASN1_BIT_STRING_new()) == NULL)
118
0
            return NULL;
119
0
        if (ASN1_item_sign_ex(ASN1_ITEM_rptr(OSSL_CMP_PROTECTEDPART),
120
0
                msg->header->protectionAlg, /* sets X509_ALGOR */
121
0
                NULL, prot, &prot_part, NULL, ctx->pkey, md,
122
0
                ctx->libctx, ctx->propq)
123
0
            != 0)
124
0
            return prot;
125
0
        ASN1_BIT_STRING_free(prot);
126
0
        return NULL;
127
0
    }
128
27
}
129
130
void ossl_cmp_set_own_chain(OSSL_CMP_CTX *ctx)
131
0
{
132
0
    if (!ossl_assert(ctx != NULL))
133
0
        return;
134
    /* if not yet done try to build chain using available untrusted certs */
135
0
    if (ctx->chain == NULL) {
136
0
        ossl_cmp_debug(ctx, "trying to build chain for own CMP signer cert");
137
0
        ctx->chain = X509_build_chain(ctx->cert, ctx->untrusted, NULL, 0,
138
0
            ctx->libctx, ctx->propq);
139
0
        if (ctx->chain != NULL) {
140
0
            ossl_cmp_debug(ctx, "success building chain for own CMP signer cert");
141
0
        } else {
142
            /* dump errors to avoid confusion when printing further ones */
143
0
            OSSL_CMP_CTX_print_errors(ctx);
144
0
            ossl_cmp_warn(ctx, "could not build chain for own CMP signer cert");
145
0
        }
146
0
    }
147
0
}
148
149
/* ctx is not const just because ctx->chain may get adapted */
150
int ossl_cmp_msg_add_extraCerts(OSSL_CMP_CTX *ctx, OSSL_CMP_MSG *msg)
151
1.83k
{
152
1.83k
    if (!ossl_assert(ctx != NULL && msg != NULL))
153
0
        return 0;
154
155
    /* Add first ctx->cert and its chain if using signature-based protection */
156
1.83k
    if (!ctx->unprotectedSend && ctx->secretValue == NULL
157
0
        && ctx->cert != NULL && ctx->pkey != NULL) {
158
0
        int prepend = X509_ADD_FLAG_UP_REF | X509_ADD_FLAG_NO_DUP
159
0
            | X509_ADD_FLAG_PREPEND | X509_ADD_FLAG_NO_SS;
160
161
0
        ossl_cmp_set_own_chain(ctx);
162
0
        if (ctx->chain != NULL) {
163
0
            if (!ossl_x509_add_certs_new(&msg->extraCerts, ctx->chain, prepend))
164
0
                return 0;
165
0
        } else {
166
            /* make sure that at least our own signer cert is included first */
167
0
            if (!ossl_x509_add_cert_new(&msg->extraCerts, ctx->cert, prepend))
168
0
                return 0;
169
0
            ossl_cmp_debug(ctx, "fallback: adding just own CMP signer cert");
170
0
        }
171
0
    }
172
173
    /* add any additional certificates from ctx->extraCertsOut */
174
1.83k
    if (!ossl_x509_add_certs_new(&msg->extraCerts, ctx->extraCertsOut,
175
1.83k
            X509_ADD_FLAG_UP_REF | X509_ADD_FLAG_NO_DUP))
176
0
        return 0;
177
178
    /* in case extraCerts are empty list avoid empty ASN.1 sequence */
179
1.83k
    if (sk_X509_num(msg->extraCerts) == 0) {
180
0
        sk_X509_free(msg->extraCerts);
181
0
        msg->extraCerts = NULL;
182
0
    }
183
1.83k
    return 1;
184
1.83k
}
185
186
/*
187
 * Create an X509_ALGOR structure for PasswordBasedMAC protection based on
188
 * the pbm settings in the context
189
 */
190
static X509_ALGOR *pbmac_algor(const OSSL_CMP_CTX *ctx)
191
0
{
192
0
    OSSL_CRMF_PBMPARAMETER *pbm = NULL;
193
0
    unsigned char *pbm_der = NULL;
194
0
    int pbm_der_len;
195
0
    ASN1_STRING *pbm_str = NULL;
196
0
    X509_ALGOR *alg = NULL;
197
198
0
    if (!ossl_assert(ctx != NULL))
199
0
        return NULL;
200
201
0
    pbm = OSSL_CRMF_pbmp_new(ctx->libctx, ctx->pbm_slen,
202
0
        EVP_MD_get_type(ctx->pbm_owf), ctx->pbm_itercnt,
203
0
        ctx->pbm_mac);
204
0
    pbm_str = ASN1_STRING_new();
205
0
    if (pbm == NULL || pbm_str == NULL)
206
0
        goto err;
207
0
    if ((pbm_der_len = i2d_OSSL_CRMF_PBMPARAMETER(pbm, &pbm_der)) < 0)
208
0
        goto err;
209
0
    if (!ASN1_STRING_set1_data(pbm_str, pbm_der, pbm_der_len))
210
0
        goto err;
211
0
    alg = ossl_X509_ALGOR_from_nid(NID_id_PasswordBasedMAC,
212
0
        V_ASN1_SEQUENCE, pbm_str);
213
0
err:
214
0
    if (alg == NULL)
215
0
        ASN1_STRING_free(pbm_str);
216
0
    OPENSSL_free(pbm_der);
217
0
    OSSL_CRMF_PBMPARAMETER_free(pbm);
218
0
    return alg;
219
0
}
220
221
static int set_senderKID(const OSSL_CMP_CTX *ctx, OSSL_CMP_MSG *msg,
222
    const ASN1_OCTET_STRING *id)
223
2.37k
{
224
2.37k
    if (id == NULL)
225
2.37k
        id = ctx->referenceValue; /* standard for PBM, fallback for sig-based */
226
2.37k
    return id == NULL || ossl_cmp_hdr_set1_senderKID(msg->header, id);
227
2.37k
}
228
229
/* ctx is not const just because ctx->chain may get adapted */
230
int ossl_cmp_msg_protect(OSSL_CMP_CTX *ctx, OSSL_CMP_MSG *msg)
231
33.5k
{
232
33.5k
    if (!ossl_assert(ctx != NULL && msg != NULL))
233
0
        return 0;
234
235
    /*
236
     * For the case of re-protection remove pre-existing protection.
237
     * Does not remove any pre-existing extraCerts.
238
     */
239
33.5k
    X509_ALGOR_free(msg->header->protectionAlg);
240
33.5k
    msg->header->protectionAlg = NULL;
241
33.5k
    ASN1_BIT_STRING_free(msg->protection);
242
33.5k
    msg->protection = NULL;
243
244
33.5k
    if (ctx->unprotectedSend) {
245
2.37k
        if (!set_senderKID(ctx, msg, NULL))
246
0
            goto err;
247
31.1k
    } else if (ctx->secretValue != NULL) {
248
        /* use PasswordBasedMac according to 5.1.3.1 if secretValue is given */
249
0
        if ((msg->header->protectionAlg = pbmac_algor(ctx)) == NULL)
250
0
            goto err;
251
0
        if (!set_senderKID(ctx, msg, NULL))
252
0
            goto err;
253
254
        /*
255
         * will add any additional certificates from ctx->extraCertsOut
256
         * while not needed to validate the protection certificate,
257
         * the option to do this might be handy for certain use cases
258
         */
259
31.1k
    } else if (ctx->cert != NULL && ctx->pkey != NULL) {
260
        /* use MSG_SIG_ALG according to 5.1.3.3 if client cert and key given */
261
262
        /* make sure that key and certificate match */
263
0
        if (!X509_check_private_key(ctx->cert, ctx->pkey)) {
264
0
            ERR_raise(ERR_LIB_CMP, CMP_R_CERT_AND_KEY_DO_NOT_MATCH);
265
0
            goto err;
266
0
        }
267
268
0
        if ((msg->header->protectionAlg = X509_ALGOR_new()) == NULL)
269
0
            goto err;
270
        /* set senderKID to keyIdentifier of the cert according to 5.1.1 */
271
0
        if (!set_senderKID(ctx, msg, X509_get0_subject_key_id(ctx->cert)))
272
0
            goto err;
273
274
        /*
275
         * will add ctx->cert followed, if possible, by its chain built
276
         * from ctx->untrusted, and then ctx->extraCertsOut
277
         */
278
31.1k
    } else {
279
31.1k
        ERR_raise(ERR_LIB_CMP,
280
31.1k
            CMP_R_MISSING_KEY_INPUT_FOR_CREATING_PROTECTION);
281
31.1k
        goto err;
282
31.1k
    }
283
2.37k
    if (!ctx->unprotectedSend
284
        /* protect according to msg->header->protectionAlg partly set above */
285
0
        && ((msg->protection = ossl_cmp_calc_protection(ctx, msg)) == NULL))
286
0
        goto err;
287
288
    /*
289
     * For signature-based protection add ctx->cert followed by its chain.
290
     * Finally add any additional certificates from ctx->extraCertsOut;
291
     * even if not needed to validate the protection
292
     * the option to do this might be handy for certain use cases.
293
     */
294
2.37k
    if (!ossl_cmp_msg_add_extraCerts(ctx, msg))
295
0
        goto err;
296
297
    /*
298
     * As required by RFC 9810 section 5.1.1., if the sender name is not known
299
     * to the client it set to NULL-DN. In this case for identification at least
300
     * the senderKID must be set, where we took the referenceValue as fallback.
301
     */
302
2.37k
    if (!(ossl_cmp_general_name_is_NULL_DN(msg->header->sender)
303
2.37k
            && msg->header->senderKID == NULL))
304
0
        return 1;
305
2.37k
    ERR_raise(ERR_LIB_CMP, CMP_R_MISSING_SENDER_IDENTIFICATION);
306
307
33.5k
err:
308
    ERR_raise(ERR_LIB_CMP, CMP_R_ERROR_PROTECTING_MESSAGE);
309
33.5k
    return 0;
310
2.37k
}