Coverage Report

Created: 2025-12-31 06:58

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl33/crypto/cmp/cmp_hdr.c
Line
Count
Source
1
/*
2
 * Copyright 2007-2022 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
/* CMP functions for PKIHeader handling */
13
14
#include "cmp_local.h"
15
16
#include <openssl/rand.h>
17
18
/* explicit #includes not strictly needed since implied by the above: */
19
#include <openssl/asn1t.h>
20
#include <openssl/cmp.h>
21
#include <openssl/err.h>
22
23
int ossl_cmp_hdr_set_pvno(OSSL_CMP_PKIHEADER *hdr, int pvno)
24
43.0k
{
25
43.0k
    if (!ossl_assert(hdr != NULL))
26
0
        return 0;
27
43.0k
    return ASN1_INTEGER_set(hdr->pvno, pvno);
28
43.0k
}
29
30
int ossl_cmp_hdr_get_pvno(const OSSL_CMP_PKIHEADER *hdr)
31
73.3k
{
32
73.3k
    int64_t pvno;
33
34
73.3k
    if (!ossl_assert(hdr != NULL))
35
0
        return -1;
36
73.3k
    if (!ASN1_INTEGER_get_int64(&pvno, hdr->pvno) || pvno < 0 || pvno > INT_MAX)
37
24.5k
        return -1;
38
48.7k
    return (int)pvno;
39
73.3k
}
40
41
int ossl_cmp_hdr_get_protection_nid(const OSSL_CMP_PKIHEADER *hdr)
42
58.3k
{
43
58.3k
    if (!ossl_assert(hdr != NULL)
44
58.3k
        || hdr->protectionAlg == NULL)
45
29.6k
        return NID_undef;
46
28.7k
    return OBJ_obj2nid(hdr->protectionAlg->algorithm);
47
58.3k
}
48
49
ASN1_OCTET_STRING *OSSL_CMP_HDR_get0_transactionID(const OSSL_CMP_PKIHEADER *hdr)
50
0
{
51
0
    if (hdr == NULL) {
52
0
        ERR_raise(ERR_LIB_CMP, CMP_R_NULL_ARGUMENT);
53
0
        return NULL;
54
0
    }
55
0
    return hdr->transactionID;
56
0
}
57
58
ASN1_OCTET_STRING *ossl_cmp_hdr_get0_senderNonce(const OSSL_CMP_PKIHEADER *hdr)
59
0
{
60
0
    if (!ossl_assert(hdr != NULL))
61
0
        return NULL;
62
0
    return hdr->senderNonce;
63
0
}
64
65
ASN1_OCTET_STRING *OSSL_CMP_HDR_get0_recipNonce(const OSSL_CMP_PKIHEADER *hdr)
66
0
{
67
0
    if (hdr == NULL) {
68
0
        ERR_raise(ERR_LIB_CMP, CMP_R_NULL_ARGUMENT);
69
0
        return NULL;
70
0
    }
71
0
    return hdr->recipNonce;
72
0
}
73
74
STACK_OF(OSSL_CMP_ITAV)
75
*OSSL_CMP_HDR_get0_geninfo_ITAVs(const OSSL_CMP_PKIHEADER *hdr)
76
0
{
77
0
    if (hdr == NULL) {
78
0
        ERR_raise(ERR_LIB_CMP, CMP_R_NULL_ARGUMENT);
79
0
        return NULL;
80
0
    }
81
0
    return hdr->generalInfo;
82
0
}
83
84
/* a NULL-DN as an empty sequence of RDNs */
85
int ossl_cmp_general_name_is_NULL_DN(GENERAL_NAME *name)
86
2.78k
{
87
2.78k
    return name == NULL
88
2.78k
        || (name->type == GEN_DIRNAME && IS_NULL_DN(name->d.directoryName));
89
2.78k
}
90
91
/* assign to *tgt a copy of src (which may be NULL to indicate an empty DN) */
92
static int set1_general_name(GENERAL_NAME **tgt, const X509_NAME *src)
93
30.2k
{
94
30.2k
    GENERAL_NAME *name;
95
96
30.2k
    if (!ossl_assert(tgt != NULL))
97
0
        return 0;
98
30.2k
    if ((name = GENERAL_NAME_new()) == NULL)
99
0
        goto err;
100
30.2k
    name->type = GEN_DIRNAME;
101
102
30.2k
    if (src == NULL) { /* NULL-DN */
103
22.9k
        if ((name->d.directoryName = X509_NAME_new()) == NULL)
104
0
            goto err;
105
22.9k
    } else if (!X509_NAME_set(&name->d.directoryName, src)) {
106
0
        goto err;
107
0
    }
108
109
30.2k
    GENERAL_NAME_free(*tgt);
110
30.2k
    *tgt = name;
111
112
30.2k
    return 1;
113
114
0
err:
115
0
    GENERAL_NAME_free(name);
116
0
    return 0;
117
30.2k
}
118
119
/*
120
 * Set the sender name in PKIHeader.
121
 * when nm is NULL, sender is set to an empty string
122
 * returns 1 on success, 0 on error
123
 */
124
int ossl_cmp_hdr_set1_sender(OSSL_CMP_PKIHEADER *hdr, const X509_NAME *nm)
125
43.0k
{
126
43.0k
    if (!ossl_assert(hdr != NULL))
127
0
        return 0;
128
43.0k
    return set1_general_name(&hdr->sender, nm);
129
43.0k
}
130
131
int ossl_cmp_hdr_set1_recipient(OSSL_CMP_PKIHEADER *hdr, const X509_NAME *nm)
132
43.0k
{
133
43.0k
    if (!ossl_assert(hdr != NULL))
134
0
        return 0;
135
43.0k
    return set1_general_name(&hdr->recipient, nm);
136
43.0k
}
137
138
int ossl_cmp_hdr_update_messageTime(OSSL_CMP_PKIHEADER *hdr)
139
43.0k
{
140
43.0k
    if (!ossl_assert(hdr != NULL))
141
0
        return 0;
142
43.0k
    if (hdr->messageTime == NULL
143
43.0k
        && (hdr->messageTime = ASN1_GENERALIZEDTIME_new()) == NULL)
144
0
        return 0;
145
43.0k
    return ASN1_GENERALIZEDTIME_set(hdr->messageTime, time(NULL)) != NULL;
146
43.0k
}
147
148
/* assign to *tgt a random byte array of given length */
149
static int set_random(ASN1_OCTET_STRING **tgt, OSSL_CMP_CTX *ctx, size_t len)
150
75.9k
{
151
75.9k
    unsigned char *bytes = OPENSSL_malloc(len);
152
75.9k
    int res = 0;
153
154
75.9k
    if (bytes == NULL || RAND_bytes_ex(ctx->libctx, bytes, len, 0) <= 0)
155
75.9k
        ERR_raise(ERR_LIB_CMP, CMP_R_FAILURE_OBTAINING_RANDOM);
156
75.9k
    else
157
75.9k
        res = ossl_cmp_asn1_octet_string_set1_bytes(tgt, bytes, len);
158
75.9k
    OPENSSL_free(bytes);
159
75.9k
    return res;
160
75.9k
}
161
162
int ossl_cmp_hdr_set1_senderKID(OSSL_CMP_PKIHEADER *hdr,
163
    const ASN1_OCTET_STRING *senderKID)
164
0
{
165
0
    if (!ossl_assert(hdr != NULL))
166
0
        return 0;
167
0
    return ossl_cmp_asn1_octet_string_set1(&hdr->senderKID, senderKID);
168
0
}
169
170
/* push the given text string to the given PKIFREETEXT ft */
171
int ossl_cmp_hdr_push0_freeText(OSSL_CMP_PKIHEADER *hdr, ASN1_UTF8STRING *text)
172
0
{
173
0
    if (!ossl_assert(hdr != NULL && text != NULL))
174
0
        return 0;
175
176
0
    if (hdr->freeText == NULL
177
0
        && (hdr->freeText = sk_ASN1_UTF8STRING_new_null()) == NULL)
178
0
        return 0;
179
180
0
    return sk_ASN1_UTF8STRING_push(hdr->freeText, text);
181
0
}
182
183
int ossl_cmp_hdr_push1_freeText(OSSL_CMP_PKIHEADER *hdr, ASN1_UTF8STRING *text)
184
0
{
185
0
    if (!ossl_assert(hdr != NULL && text != NULL))
186
0
        return 0;
187
188
0
    if (hdr->freeText == NULL
189
0
        && (hdr->freeText = sk_ASN1_UTF8STRING_new_null()) == NULL)
190
0
        return 0;
191
192
0
    return ossl_cmp_sk_ASN1_UTF8STRING_push_str(hdr->freeText, (char *)text->data,
193
0
        text->length);
194
0
}
195
196
int ossl_cmp_hdr_generalInfo_push0_item(OSSL_CMP_PKIHEADER *hdr,
197
    OSSL_CMP_ITAV *itav)
198
0
{
199
0
    if (!ossl_assert(hdr != NULL && itav != NULL))
200
0
        return 0;
201
0
    return OSSL_CMP_ITAV_push0_stack_item(&hdr->generalInfo, itav);
202
0
}
203
204
int ossl_cmp_hdr_generalInfo_push1_items(OSSL_CMP_PKIHEADER *hdr,
205
    const STACK_OF(OSSL_CMP_ITAV) *itavs)
206
0
{
207
0
    int i;
208
0
    OSSL_CMP_ITAV *itav;
209
210
0
    if (!ossl_assert(hdr != NULL))
211
0
        return 0;
212
213
0
    for (i = 0; i < sk_OSSL_CMP_ITAV_num(itavs); i++) {
214
0
        itav = OSSL_CMP_ITAV_dup(sk_OSSL_CMP_ITAV_value(itavs, i));
215
0
        if (itav == NULL)
216
0
            return 0;
217
218
0
        if (!ossl_cmp_hdr_generalInfo_push0_item(hdr, itav)) {
219
0
            OSSL_CMP_ITAV_free(itav);
220
0
            return 0;
221
0
        }
222
0
    }
223
0
    return 1;
224
0
}
225
226
int ossl_cmp_hdr_set_implicitConfirm(OSSL_CMP_PKIHEADER *hdr)
227
0
{
228
0
    OSSL_CMP_ITAV *itav;
229
0
    ASN1_TYPE *asn1null;
230
231
0
    if (!ossl_assert(hdr != NULL))
232
0
        return 0;
233
0
    asn1null = (ASN1_TYPE *)ASN1_NULL_new();
234
0
    if (asn1null == NULL)
235
0
        return 0;
236
0
    if ((itav = OSSL_CMP_ITAV_create(OBJ_nid2obj(NID_id_it_implicitConfirm),
237
0
             asn1null))
238
0
        == NULL)
239
0
        goto err;
240
0
    if (!ossl_cmp_hdr_generalInfo_push0_item(hdr, itav))
241
0
        goto err;
242
0
    return 1;
243
244
0
err:
245
0
    ASN1_TYPE_free(asn1null);
246
0
    OSSL_CMP_ITAV_free(itav);
247
0
    return 0;
248
0
}
249
250
/* return 1 if implicitConfirm in the generalInfo field of the header is set */
251
int ossl_cmp_hdr_has_implicitConfirm(const OSSL_CMP_PKIHEADER *hdr)
252
0
{
253
0
    int itavCount;
254
0
    int i;
255
0
    OSSL_CMP_ITAV *itav;
256
257
0
    if (!ossl_assert(hdr != NULL))
258
0
        return 0;
259
260
0
    itavCount = sk_OSSL_CMP_ITAV_num(hdr->generalInfo);
261
0
    for (i = 0; i < itavCount; i++) {
262
0
        itav = sk_OSSL_CMP_ITAV_value(hdr->generalInfo, i);
263
0
        if (itav != NULL
264
0
            && OBJ_obj2nid(itav->infoType) == NID_id_it_implicitConfirm)
265
0
            return 1;
266
0
    }
267
268
0
    return 0;
269
0
}
270
271
/*
272
 * set ctx->transactionID in CMP header
273
 * if ctx->transactionID is NULL, a random one is created with 128 bit
274
 * according to section 5.1.1:
275
 *
276
 * It is RECOMMENDED that the clients fill the transactionID field with
277
 * 128 bits of (pseudo-) random data for the start of a transaction to
278
 * reduce the probability of having the transactionID in use at the server.
279
 */
280
int ossl_cmp_hdr_set_transactionID(OSSL_CMP_CTX *ctx, OSSL_CMP_PKIHEADER *hdr)
281
43.0k
{
282
43.0k
    if (ctx->transactionID == NULL) {
283
32.9k
        char *tid;
284
285
32.9k
        if (!set_random(&ctx->transactionID, ctx,
286
32.9k
                OSSL_CMP_TRANSACTIONID_LENGTH))
287
0
            return 0;
288
32.9k
        tid = i2s_ASN1_OCTET_STRING(NULL, ctx->transactionID);
289
32.9k
        if (tid != NULL)
290
32.9k
            ossl_cmp_log1(DEBUG, ctx,
291
32.9k
                "Starting new transaction with ID=%s", tid);
292
32.9k
        OPENSSL_free(tid);
293
32.9k
    }
294
295
43.0k
    return ossl_cmp_asn1_octet_string_set1(&hdr->transactionID,
296
43.0k
        ctx->transactionID);
297
43.0k
}
298
299
/* fill in all fields of the hdr according to the info given in ctx */
300
int ossl_cmp_hdr_init(OSSL_CMP_CTX *ctx, OSSL_CMP_PKIHEADER *hdr)
301
35.2k
{
302
35.2k
    const X509_NAME *sender;
303
35.2k
    const X509_NAME *rcp = NULL;
304
305
35.2k
    if (!ossl_assert(ctx != NULL && hdr != NULL))
306
0
        return 0;
307
308
    /* set the CMP version */
309
35.2k
    if (!ossl_cmp_hdr_set_pvno(hdr, OSSL_CMP_PVNO))
310
0
        return 0;
311
312
    /*
313
     * If no protection cert nor oldCert nor CSR nor subject is given,
314
     * sender name is not known to the client and thus set to NULL-DN
315
     */
316
35.2k
    sender = ctx->cert != NULL ? X509_get_subject_name(ctx->cert) : ctx->oldCert != NULL ? X509_get_subject_name(ctx->oldCert)
317
35.2k
        : ctx->p10CSR != NULL                                                            ? X509_REQ_get_subject_name(ctx->p10CSR)
318
33.0k
                                                                                         : ctx->subjectName;
319
35.2k
    if (!ossl_cmp_hdr_set1_sender(hdr, sender))
320
0
        return 0;
321
322
    /* determine recipient entry in PKIHeader */
323
35.2k
    if (ctx->recipient != NULL)
324
11.5k
        rcp = ctx->recipient;
325
23.6k
    else if (ctx->srvCert != NULL)
326
0
        rcp = X509_get_subject_name(ctx->srvCert);
327
23.6k
    else if (ctx->issuer != NULL)
328
0
        rcp = ctx->issuer;
329
23.6k
    else if (ctx->oldCert != NULL)
330
2.25k
        rcp = X509_get_issuer_name(ctx->oldCert);
331
21.4k
    else if (ctx->cert != NULL)
332
0
        rcp = X509_get_issuer_name(ctx->cert);
333
35.2k
    if (!ossl_cmp_hdr_set1_recipient(hdr, rcp))
334
0
        return 0;
335
336
    /* set current time as message time */
337
35.2k
    if (!ossl_cmp_hdr_update_messageTime(hdr))
338
0
        return 0;
339
340
35.2k
    if (ctx->recipNonce != NULL
341
9.11k
        && !ossl_cmp_asn1_octet_string_set1(&hdr->recipNonce,
342
9.11k
            ctx->recipNonce))
343
0
        return 0;
344
345
35.2k
    if (!ossl_cmp_hdr_set_transactionID(ctx, hdr))
346
0
        return 0;
347
348
    /*-
349
     * set random senderNonce
350
     * according to section 5.1.1:
351
     *
352
     * senderNonce                  present
353
     *         -- 128 (pseudo-)random bits
354
     * The senderNonce and recipNonce fields protect the PKIMessage against
355
     * replay attacks. The senderNonce will typically be 128 bits of
356
     * (pseudo-) random data generated by the sender, whereas the recipNonce
357
     * is copied from the senderNonce of the previous message in the
358
     * transaction.
359
     */
360
35.2k
    if (!set_random(&hdr->senderNonce, ctx, OSSL_CMP_SENDERNONCE_LENGTH))
361
0
        return 0;
362
363
    /* store senderNonce - for cmp with recipNonce in next outgoing msg */
364
35.2k
    if (!OSSL_CMP_CTX_set1_senderNonce(ctx, hdr->senderNonce))
365
0
        return 0;
366
367
    /*-
368
     * freeText                [7] PKIFreeText OPTIONAL,
369
     * -- this may be used to indicate context-specific instructions
370
     * -- (this field is intended for human consumption)
371
     */
372
35.2k
    if (ctx->freeText != NULL
373
0
        && !ossl_cmp_hdr_push1_freeText(hdr, ctx->freeText))
374
0
        return 0;
375
376
35.2k
    return 1;
377
35.2k
}