Coverage Report

Created: 2025-06-13 06:57

/src/openssl/crypto/encode_decode/encoder_pkey.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2019-2025 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
#include <openssl/err.h>
11
#include <openssl/ui.h>
12
#include <openssl/params.h>
13
#include <openssl/encoder.h>
14
#include <openssl/core_names.h>
15
#include <openssl/provider.h>
16
#include <openssl/safestack.h>
17
#include <openssl/trace.h>
18
#include "internal/provider.h"
19
#include "internal/property.h"
20
#include "internal/namemap.h"
21
#include "crypto/evp.h"
22
#include "encoder_local.h"
23
24
DEFINE_STACK_OF(OSSL_ENCODER)
25
26
int OSSL_ENCODER_CTX_set_cipher(OSSL_ENCODER_CTX *ctx,
27
                                const char *cipher_name,
28
                                const char *propquery)
29
0
{
30
0
    OSSL_PARAM params[] = { OSSL_PARAM_END, OSSL_PARAM_END, OSSL_PARAM_END };
31
32
0
    params[0] =
33
0
        OSSL_PARAM_construct_utf8_string(OSSL_ENCODER_PARAM_CIPHER,
34
0
                                         (void *)cipher_name, 0);
35
0
    params[1] =
36
0
        OSSL_PARAM_construct_utf8_string(OSSL_ENCODER_PARAM_PROPERTIES,
37
0
                                         (void *)propquery, 0);
38
39
0
    return OSSL_ENCODER_CTX_set_params(ctx, params);
40
0
}
41
42
int OSSL_ENCODER_CTX_set_passphrase(OSSL_ENCODER_CTX *ctx,
43
                                    const unsigned char *kstr,
44
                                    size_t klen)
45
0
{
46
0
    return ossl_pw_set_passphrase(&ctx->pwdata, kstr, klen);
47
0
}
48
49
int OSSL_ENCODER_CTX_set_passphrase_ui(OSSL_ENCODER_CTX *ctx,
50
                                       const UI_METHOD *ui_method,
51
                                       void *ui_data)
52
0
{
53
0
    return ossl_pw_set_ui_method(&ctx->pwdata, ui_method, ui_data);
54
0
}
55
56
int OSSL_ENCODER_CTX_set_pem_password_cb(OSSL_ENCODER_CTX *ctx,
57
                                         pem_password_cb *cb, void *cbarg)
58
0
{
59
0
    return ossl_pw_set_pem_password_cb(&ctx->pwdata, cb, cbarg);
60
0
}
61
62
int OSSL_ENCODER_CTX_set_passphrase_cb(OSSL_ENCODER_CTX *ctx,
63
                                       OSSL_PASSPHRASE_CALLBACK *cb,
64
                                       void *cbarg)
65
0
{
66
0
    return ossl_pw_set_ossl_passphrase_cb(&ctx->pwdata, cb, cbarg);
67
0
}
68
69
/*
70
 * Support for OSSL_ENCODER_CTX_new_for_type:
71
 * finding a suitable encoder
72
 */
73
74
struct collected_encoder_st {
75
    STACK_OF(OPENSSL_CSTRING) *names;
76
    int *id_names;
77
    const char *output_structure;
78
    const char *output_type;
79
80
    const OSSL_PROVIDER *keymgmt_prov;
81
    OSSL_ENCODER_CTX *ctx;
82
    unsigned int flag_find_same_provider:1;
83
84
    int error_occurred;
85
};
86
87
static void collect_encoder(OSSL_ENCODER *encoder, void *arg)
88
5.74M
{
89
5.74M
    struct collected_encoder_st *data = arg;
90
5.74M
    const OSSL_PROVIDER *prov;
91
92
5.74M
    if (data->error_occurred)
93
0
        return;
94
95
5.74M
    data->error_occurred = 1;     /* Assume the worst */
96
97
5.74M
    prov = OSSL_ENCODER_get0_provider(encoder);
98
    /*
99
     * collect_encoder() is called in two passes, one where the encoders
100
     * from the same provider as the keymgmt are looked up, and one where
101
     * the other encoders are looked up.  |data->flag_find_same_provider|
102
     * tells us which pass we're in.
103
     */
104
5.74M
    if ((data->keymgmt_prov == prov) == data->flag_find_same_provider) {
105
2.87M
        void *provctx = OSSL_PROVIDER_get0_provider_ctx(prov);
106
2.87M
        int i, end_i = sk_OPENSSL_CSTRING_num(data->names);
107
2.87M
        int match;
108
109
13.5M
        for (i = 0; i < end_i; i++) {
110
10.7M
            if (data->flag_find_same_provider)
111
10.7M
                match = (data->id_names[i] == encoder->base.id);
112
0
            else
113
0
                match = OSSL_ENCODER_is_a(encoder,
114
0
                                          sk_OPENSSL_CSTRING_value(data->names, i));
115
10.7M
            if (!match
116
10.7M
                || (encoder->does_selection != NULL
117
389k
                    && !encoder->does_selection(provctx, data->ctx->selection))
118
10.7M
                || (data->keymgmt_prov != prov
119
76.9k
                    && encoder->import_object == NULL))
120
10.6M
                continue;
121
122
            /* Only add each encoder implementation once */
123
76.9k
            if (OSSL_ENCODER_CTX_add_encoder(data->ctx, encoder))
124
76.9k
                break;
125
76.9k
        }
126
2.87M
    }
127
128
5.74M
    data->error_occurred = 0;         /* All is good now */
129
5.74M
}
130
131
struct collected_names_st {
132
    STACK_OF(OPENSSL_CSTRING) *names;
133
    unsigned int error_occurred:1;
134
};
135
136
static void collect_name(const char *name, void *arg)
137
45.4k
{
138
45.4k
    struct collected_names_st *data = arg;
139
140
45.4k
    if (data->error_occurred)
141
0
        return;
142
143
45.4k
    data->error_occurred = 1;         /* Assume the worst */
144
145
45.4k
    if (sk_OPENSSL_CSTRING_push(data->names, name) <= 0)
146
0
        return;
147
148
45.4k
    data->error_occurred = 0;         /* All is good now */
149
45.4k
}
150
151
/*
152
 * Support for OSSL_ENCODER_to_bio:
153
 * writing callback for the OSSL_PARAM (the implementation doesn't have
154
 * intimate knowledge of the provider side object)
155
 */
156
157
struct construct_data_st {
158
    const EVP_PKEY *pk;
159
    int selection;
160
161
    OSSL_ENCODER_INSTANCE *encoder_inst;
162
    const void *obj;
163
    void *constructed_obj;
164
};
165
166
static int encoder_import_cb(const OSSL_PARAM params[], void *arg)
167
0
{
168
0
    struct construct_data_st *construct_data = arg;
169
0
    OSSL_ENCODER_INSTANCE *encoder_inst = construct_data->encoder_inst;
170
0
    OSSL_ENCODER *encoder = OSSL_ENCODER_INSTANCE_get_encoder(encoder_inst);
171
0
    void *encoderctx = OSSL_ENCODER_INSTANCE_get_encoder_ctx(encoder_inst);
172
173
0
    construct_data->constructed_obj =
174
0
        encoder->import_object(encoderctx, construct_data->selection, params);
175
176
0
    return (construct_data->constructed_obj != NULL);
177
0
}
178
179
static const void *
180
encoder_construct_pkey(OSSL_ENCODER_INSTANCE *encoder_inst, void *arg)
181
11.9k
{
182
11.9k
    struct construct_data_st *data = arg;
183
184
11.9k
    if (data->obj == NULL) {
185
11.9k
        OSSL_ENCODER *encoder =
186
11.9k
            OSSL_ENCODER_INSTANCE_get_encoder(encoder_inst);
187
11.9k
        const EVP_PKEY *pk = data->pk;
188
11.9k
        const OSSL_PROVIDER *k_prov = EVP_KEYMGMT_get0_provider(pk->keymgmt);
189
11.9k
        const OSSL_PROVIDER *e_prov = OSSL_ENCODER_get0_provider(encoder);
190
191
11.9k
        if (k_prov != e_prov) {
192
0
            int selection = data->selection;
193
194
0
            if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
195
0
                selection |= OSSL_KEYMGMT_SELECT_PUBLIC_KEY;
196
0
            data->encoder_inst = encoder_inst;
197
198
0
            if (!evp_keymgmt_export(pk->keymgmt, pk->keydata, selection,
199
0
                                    &encoder_import_cb, data))
200
0
                return NULL;
201
0
            data->obj = data->constructed_obj;
202
11.9k
        } else {
203
11.9k
            data->obj = pk->keydata;
204
11.9k
        }
205
11.9k
    }
206
207
11.9k
    return data->obj;
208
11.9k
}
209
210
static void encoder_destruct_pkey(void *arg)
211
11.9k
{
212
11.9k
    struct construct_data_st *data = arg;
213
11.9k
    int match = (data->obj == data->constructed_obj);
214
215
11.9k
    if (data->encoder_inst != NULL) {
216
0
        OSSL_ENCODER *encoder =
217
0
            OSSL_ENCODER_INSTANCE_get_encoder(data->encoder_inst);
218
219
0
        encoder->free_object(data->constructed_obj);
220
0
    }
221
11.9k
    data->constructed_obj = NULL;
222
11.9k
    if (match)
223
0
        data->obj = NULL;
224
11.9k
}
225
226
/*
227
 * OSSL_ENCODER_CTX_new_for_pkey() returns a ctx with no encoder if
228
 * it couldn't find a suitable encoder.  This allows a caller to detect if
229
 * a suitable encoder was found, with OSSL_ENCODER_CTX_get_num_encoder(),
230
 * and to use fallback methods if the result is NULL.
231
 */
232
static int ossl_encoder_ctx_setup_for_pkey(OSSL_ENCODER_CTX *ctx,
233
                                           const EVP_PKEY *pkey,
234
                                           int selection,
235
                                           const char *propquery)
236
11.9k
{
237
11.9k
    struct construct_data_st *data = NULL;
238
11.9k
    const OSSL_PROVIDER *prov = NULL;
239
11.9k
    OSSL_LIB_CTX *libctx = NULL;
240
11.9k
    int ok = 0, i, end;
241
11.9k
    OSSL_NAMEMAP *namemap;
242
243
11.9k
    if (!ossl_assert(ctx != NULL) || !ossl_assert(pkey != NULL)) {
244
0
        ERR_raise(ERR_LIB_OSSL_ENCODER, ERR_R_PASSED_NULL_PARAMETER);
245
0
        return 0;
246
0
    }
247
248
11.9k
    if (evp_pkey_is_provided(pkey)) {
249
11.9k
        prov = EVP_KEYMGMT_get0_provider(pkey->keymgmt);
250
11.9k
        libctx = ossl_provider_libctx(prov);
251
11.9k
    }
252
253
11.9k
    if (pkey->keymgmt != NULL) {
254
11.9k
        struct collected_encoder_st encoder_data;
255
11.9k
        struct collected_names_st keymgmt_data;
256
257
11.9k
        if ((data = OPENSSL_zalloc(sizeof(*data))) == NULL)
258
0
            goto err;
259
260
        /*
261
         * Select the first encoder implementations in two steps.
262
         * First, collect the keymgmt names, then the encoders that match.
263
         */
264
11.9k
        keymgmt_data.names = sk_OPENSSL_CSTRING_new_null();
265
11.9k
        if (keymgmt_data.names == NULL) {
266
0
            ERR_raise(ERR_LIB_OSSL_ENCODER, ERR_R_CRYPTO_LIB);
267
0
            goto err;
268
0
        }
269
270
11.9k
        keymgmt_data.error_occurred = 0;
271
11.9k
        EVP_KEYMGMT_names_do_all(pkey->keymgmt, collect_name, &keymgmt_data);
272
11.9k
        if (keymgmt_data.error_occurred) {
273
0
            sk_OPENSSL_CSTRING_free(keymgmt_data.names);
274
0
            goto err;
275
0
        }
276
277
11.9k
        encoder_data.names = keymgmt_data.names;
278
11.9k
        encoder_data.output_type = ctx->output_type;
279
11.9k
        encoder_data.output_structure = ctx->output_structure;
280
11.9k
        encoder_data.error_occurred = 0;
281
11.9k
        encoder_data.keymgmt_prov = prov;
282
11.9k
        encoder_data.ctx = ctx;
283
11.9k
        encoder_data.id_names = NULL;
284
285
        /*
286
         * collect_encoder() is called many times, and for every call it converts all encoder_data.names
287
         * into namemap ids if it calls OSSL_ENCODER_is_a(). We cache the ids here instead,
288
         * and can use them for encoders with the same provider as the keymgmt.
289
         */
290
11.9k
        namemap = ossl_namemap_stored(libctx);
291
11.9k
        end = sk_OPENSSL_CSTRING_num(encoder_data.names);
292
11.9k
        if (end > 0) {
293
11.9k
            encoder_data.id_names = OPENSSL_malloc(end * sizeof(int));
294
11.9k
            if (encoder_data.id_names == NULL) {
295
0
                sk_OPENSSL_CSTRING_free(keymgmt_data.names);
296
0
                goto err;
297
0
            }
298
57.3k
            for (i = 0; i < end; ++i) {
299
45.4k
                const char *name = sk_OPENSSL_CSTRING_value(keymgmt_data.names, i);
300
301
45.4k
                encoder_data.id_names[i] = ossl_namemap_name2num(namemap, name);
302
45.4k
            }
303
11.9k
        }
304
        /*
305
         * Place the encoders with the a different provider as the keymgmt
306
         * last (the chain is processed in reverse order)
307
         */
308
11.9k
        encoder_data.flag_find_same_provider = 0;
309
11.9k
        OSSL_ENCODER_do_all_provided(libctx, collect_encoder, &encoder_data);
310
311
        /*
312
         * Place the encoders with the same provider as the keymgmt first
313
         * (the chain is processed in reverse order)
314
         */
315
11.9k
        encoder_data.flag_find_same_provider = 1;
316
11.9k
        OSSL_ENCODER_do_all_provided(libctx, collect_encoder, &encoder_data);
317
318
11.9k
        OPENSSL_free(encoder_data.id_names);
319
11.9k
        sk_OPENSSL_CSTRING_free(keymgmt_data.names);
320
11.9k
        if (encoder_data.error_occurred) {
321
0
            ERR_raise(ERR_LIB_OSSL_ENCODER, ERR_R_CRYPTO_LIB);
322
0
            goto err;
323
0
        }
324
11.9k
    }
325
326
11.9k
    if (data != NULL && OSSL_ENCODER_CTX_get_num_encoders(ctx) != 0) {
327
11.9k
        if (!OSSL_ENCODER_CTX_set_construct(ctx, encoder_construct_pkey)
328
11.9k
            || !OSSL_ENCODER_CTX_set_construct_data(ctx, data)
329
11.9k
            || !OSSL_ENCODER_CTX_set_cleanup(ctx, encoder_destruct_pkey))
330
0
            goto err;
331
332
11.9k
        data->pk = pkey;
333
11.9k
        data->selection = selection;
334
335
11.9k
        data = NULL;             /* Avoid it being freed */
336
11.9k
    }
337
338
11.9k
    ok = 1;
339
11.9k
 err:
340
11.9k
    if (data != NULL) {
341
0
        OSSL_ENCODER_CTX_set_construct_data(ctx, NULL);
342
0
        OPENSSL_free(data);
343
0
    }
344
11.9k
    return ok;
345
11.9k
}
346
347
OSSL_ENCODER_CTX *OSSL_ENCODER_CTX_new_for_pkey(const EVP_PKEY *pkey,
348
                                                int selection,
349
                                                const char *output_type,
350
                                                const char *output_struct,
351
                                                const char *propquery)
352
11.9k
{
353
11.9k
    OSSL_ENCODER_CTX *ctx = NULL;
354
11.9k
    OSSL_LIB_CTX *libctx = NULL;
355
356
11.9k
    if (pkey == NULL) {
357
0
        ERR_raise(ERR_LIB_OSSL_ENCODER, ERR_R_PASSED_NULL_PARAMETER);
358
0
        return NULL;
359
0
    }
360
361
11.9k
    if (!evp_pkey_is_assigned(pkey)) {
362
0
        ERR_raise_data(ERR_LIB_OSSL_ENCODER, ERR_R_PASSED_INVALID_ARGUMENT,
363
0
                       "The passed EVP_PKEY must be assigned a key");
364
0
        return NULL;
365
0
    }
366
367
11.9k
    if ((ctx = OSSL_ENCODER_CTX_new()) == NULL) {
368
0
        ERR_raise(ERR_LIB_OSSL_ENCODER, ERR_R_OSSL_ENCODER_LIB);
369
0
        return NULL;
370
0
    }
371
372
11.9k
    if (evp_pkey_is_provided(pkey)) {
373
11.9k
        const OSSL_PROVIDER *prov = EVP_KEYMGMT_get0_provider(pkey->keymgmt);
374
375
11.9k
        libctx = ossl_provider_libctx(prov);
376
11.9k
    }
377
378
11.9k
    OSSL_TRACE_BEGIN(ENCODER) {
379
0
        BIO_printf(trc_out,
380
0
                   "(ctx %p) Looking for %s encoders with selection %d\n",
381
0
                   (void *)ctx, EVP_PKEY_get0_type_name(pkey), selection);
382
0
        BIO_printf(trc_out, "    output type: %s, output structure: %s\n",
383
0
                   output_type, output_struct);
384
11.9k
    } OSSL_TRACE_END(ENCODER);
385
386
11.9k
    if (OSSL_ENCODER_CTX_set_output_type(ctx, output_type)
387
11.9k
        && (output_struct == NULL
388
11.9k
            || OSSL_ENCODER_CTX_set_output_structure(ctx, output_struct))
389
11.9k
        && OSSL_ENCODER_CTX_set_selection(ctx, selection)
390
11.9k
        && ossl_encoder_ctx_setup_for_pkey(ctx, pkey, selection, propquery)
391
11.9k
        && OSSL_ENCODER_CTX_add_extra(ctx, libctx, propquery)) {
392
11.9k
        OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
393
11.9k
        int save_parameters = pkey->save_parameters;
394
395
11.9k
        params[0] = OSSL_PARAM_construct_int(OSSL_ENCODER_PARAM_SAVE_PARAMETERS,
396
11.9k
                                             &save_parameters);
397
        /* ignoring error as this is only auxiliary parameter */
398
11.9k
        (void)OSSL_ENCODER_CTX_set_params(ctx, params);
399
400
11.9k
        OSSL_TRACE_BEGIN(ENCODER) {
401
0
            BIO_printf(trc_out, "(ctx %p) Got %d encoders\n",
402
0
                       (void *)ctx, OSSL_ENCODER_CTX_get_num_encoders(ctx));
403
11.9k
        } OSSL_TRACE_END(ENCODER);
404
11.9k
        return ctx;
405
11.9k
    }
406
407
0
    OSSL_ENCODER_CTX_free(ctx);
408
0
    return NULL;
409
11.9k
}