/src/openssl/providers/implementations/encode_decode/encode_key2ms.c

Source (jump to first uncovered line)
/*
 * Copyright 2020-2023 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

/*
 * Low level APIs are deprecated for public use, but still ok for internal use.
 */
#include "internal/deprecated.h"

#include <string.h>
#include <openssl/core.h>
#include <openssl/core_dispatch.h>
#include <openssl/core_names.h>
#include <openssl/params.h>
#include <openssl/err.h>
#include <openssl/pem.h>         /* Functions for writing MSBLOB and PVK */
#include <openssl/dsa.h>
#include "internal/passphrase.h"
#include "crypto/rsa.h"
#include "prov/implementations.h"
#include "prov/bio.h"
#include "prov/provider_ctx.h"
#include "endecoder_local.h"

struct key2ms_ctx_st {
    PROV_CTX *provctx;

    int pvk_encr_level;

    struct ossl_passphrase_data_st pwdata;
};

static int write_msblob(struct key2ms_ctx_st *ctx, OSSL_CORE_BIO *cout,
                        EVP_PKEY *pkey, int ispub)
{
    BIO *out = ossl_bio_new_from_core_bio(ctx->provctx, cout);
    int ret;

    if (out == NULL)
        return 0;
    ret = ispub ? i2b_PublicKey_bio(out, pkey) : i2b_PrivateKey_bio(out, pkey);

    BIO_free(out);
    return ret;
}

static int write_pvk(struct key2ms_ctx_st *ctx, OSSL_CORE_BIO *cout,
                     EVP_PKEY *pkey)
{
    BIO *out = NULL;
    int ret;
    OSSL_LIB_CTX *libctx = PROV_LIBCTX_OF(ctx->provctx);

    out = ossl_bio_new_from_core_bio(ctx->provctx, cout);
    if (out == NULL)
        return 0;
    ret = i2b_PVK_bio_ex(out, pkey, ctx->pvk_encr_level,
                         ossl_pw_pvk_password, &ctx->pwdata, libctx, NULL);
    BIO_free(out);
    return ret;
}

static OSSL_FUNC_encoder_freectx_fn key2ms_freectx;
static OSSL_FUNC_encoder_does_selection_fn key2ms_does_selection;

static struct key2ms_ctx_st *key2ms_newctx(void *provctx)
{
    struct key2ms_ctx_st *ctx = OPENSSL_zalloc(sizeof(*ctx));

    if (ctx != NULL) {
        ctx->provctx = provctx;
        /* This is the strongest encryption level */
        ctx->pvk_encr_level = 2;
    }
    return ctx;
}

static void key2ms_freectx(void *vctx)
{
    struct key2ms_ctx_st *ctx = vctx;

    ossl_pw_clear_passphrase_data(&ctx->pwdata);
    OPENSSL_free(ctx);
}

static const OSSL_PARAM *key2pvk_settable_ctx_params(ossl_unused void *provctx)
{
    static const OSSL_PARAM settables[] = {
        OSSL_PARAM_int(OSSL_ENCODER_PARAM_ENCRYPT_LEVEL, NULL),
        OSSL_PARAM_END,
    };

    return settables;
}

static int key2pvk_set_ctx_params(void *vctx, const OSSL_PARAM params[])
{
    struct key2ms_ctx_st *ctx = vctx;
    const OSSL_PARAM *p;

    p = OSSL_PARAM_locate_const(params, OSSL_ENCODER_PARAM_ENCRYPT_LEVEL);
    if (p != NULL && !OSSL_PARAM_get_int(p, &ctx->pvk_encr_level))
        return 0;
    return 1;
}

static int key2ms_does_selection(void *vctx, int selection)
{
    return (selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0;
}

/*
 * The real EVP_PKEY_set1_TYPE() functions take a non-const key, while the key
 * pointer in the encode function is a const pointer.  We violate the constness
 * knowingly, since we know that the key comes from the same provider, is never
 * actually const, and the implied reference count change is safe.
 *
 * EVP_PKEY_assign() can't be used, because there's no way to clear the internal
 * key using that function without freeing the existing internal key.
 */
typedef int evp_pkey_set1_fn(EVP_PKEY *, const void *key);

static int key2msblob_encode(void *vctx, const void *key, int selection,
                             OSSL_CORE_BIO *cout, evp_pkey_set1_fn *set1_key,
                             OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg)
{
    struct key2ms_ctx_st *ctx = vctx;
    int ispub = -1;
    EVP_PKEY *pkey = NULL;
    int ok = 0;

    if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
        ispub = 0;
    else if ((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0)
        ispub = 1;
    else
        return 0;                /* Error */

    if ((pkey = EVP_PKEY_new()) != NULL && set1_key(pkey, key))
        ok = write_msblob(ctx, cout, pkey, ispub);
    EVP_PKEY_free(pkey);
    return ok;
}

static int key2pvk_encode(void *vctx, const void *key, int selection,
                          OSSL_CORE_BIO *cout, evp_pkey_set1_fn *set1_key,
                          OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg)
{
    struct key2ms_ctx_st *ctx = vctx;
    EVP_PKEY *pkey = NULL;
    int ok = 0;

    if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) == 0)
        return 0;                /* Error */

    if ((pkey = EVP_PKEY_new()) != NULL && set1_key(pkey, key)
        && (pw_cb == NULL
            || ossl_pw_set_ossl_passphrase_cb(&ctx->pwdata, pw_cb, pw_cbarg)))
        ok = write_pvk(ctx, cout, pkey);
    EVP_PKEY_free(pkey);
    return ok;
}

#define dsa_set1        (evp_pkey_set1_fn *)EVP_PKEY_set1_DSA
#define rsa_set1        (evp_pkey_set1_fn *)EVP_PKEY_set1_RSA

#define msblob_set_params
#define pvk_set_params                                                        \
        { OSSL_FUNC_ENCODER_SETTABLE_CTX_PARAMS,                              \
          (void (*)(void))key2pvk_settable_ctx_params },                      \
        { OSSL_FUNC_ENCODER_SET_CTX_PARAMS,                                   \
          (void (*)(void))key2pvk_set_ctx_params },

#define MAKE_MS_ENCODER(impl, output, type)                                   \
    static OSSL_FUNC_encoder_import_object_fn                                 \
    impl##2##output##_import_object;                                          \
    static OSSL_FUNC_encoder_free_object_fn impl##2##output##_free_object;    \
    static OSSL_FUNC_encoder_encode_fn impl##2##output##_encode;              \
                                                                              \
    static void *                                                             \
    impl##2##output##_import_object(void *ctx, int selection,                 \
                                    const OSSL_PARAM params[])                \
    {                                                                         \
        return ossl_prov_import_key(ossl_##impl##_keymgmt_functions,          \
                                    ctx, selection, params);                  \
    }                                                                         \
    static void impl##2##output##_free_object(void *key)                      \
    {                                                                         \
        ossl_prov_free_key(ossl_##impl##_keymgmt_functions, key);             \
    }                                                                         \
    static int impl##2##output##_encode(void *vctx, OSSL_CORE_BIO *cout,      \
                                        const void *key,                      \
                                        const OSSL_PARAM key_abstract[],      \
                                        int selection,                        \
                                        OSSL_PASSPHRASE_CALLBACK *cb,         \
                                        void *cbarg)                          \
    {                                                                         \
        /* We don't deal with abstract objects */                             \
        if (key_abstract != NULL) {                                           \
            ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT);           \
            return 0;                                                         \
        }                                                                     \
        return key2##output##_encode(vctx, key, selection, cout, type##_set1, \
                                     cb, cbarg);                              \
    }                                                                         \
    const OSSL_DISPATCH ossl_##impl##_to_##output##_encoder_functions[] = {   \
        { OSSL_FUNC_ENCODER_NEWCTX,                                           \
          (void (*)(void))key2ms_newctx },                                    \
        { OSSL_FUNC_ENCODER_FREECTX,                                          \
          (void (*)(void))key2ms_freectx },                                   \
        output##_set_params                                                   \
        { OSSL_FUNC_ENCODER_DOES_SELECTION,                                   \
          (void (*)(void))key2ms_does_selection },                            \
        { OSSL_FUNC_ENCODER_IMPORT_OBJECT,                                    \
          (void (*)(void))impl##2##output##_import_object },                  \
        { OSSL_FUNC_ENCODER_FREE_OBJECT,                                      \
          (void (*)(void))impl##2##output##_free_object },                    \
        { OSSL_FUNC_ENCODER_ENCODE,                                           \
          (void (*)(void))impl##2##output##_encode },                         \
        OSSL_DISPATCH_END                                                     \
    }

#ifndef OPENSSL_NO_DSA
MAKE_MS_ENCODER(dsa, pvk, dsa);
MAKE_MS_ENCODER(dsa, msblob, dsa);
#endif

MAKE_MS_ENCODER(rsa, pvk, rsa);
MAKE_MS_ENCODER(rsa, msblob, rsa);

Coverage Report

Created: 2025-06-13 06:36

Line	Count	Source (jump to first uncovered line)
1		/*
2		* Copyright 2020-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		* Low level APIs are deprecated for public use, but still ok for internal use.
12		*/
13		#include "internal/deprecated.h"
14
15		#include <string.h>
16		#include <openssl/core.h>
17		#include <openssl/core_dispatch.h>
18		#include <openssl/core_names.h>
19		#include <openssl/params.h>
20		#include <openssl/err.h>
21		#include <openssl/pem.h> /* Functions for writing MSBLOB and PVK */
22		#include <openssl/dsa.h>
23		#include "internal/passphrase.h"
24		#include "crypto/rsa.h"
25		#include "prov/implementations.h"
26		#include "prov/bio.h"
27		#include "prov/provider_ctx.h"
28		#include "endecoder_local.h"
29
30		struct key2ms_ctx_st {
31		PROV_CTX *provctx;
32
33		int pvk_encr_level;
34
35		struct ossl_passphrase_data_st pwdata;
36		};
37
38		static int write_msblob(struct key2ms_ctx_st ctx, OSSL_CORE_BIO cout,
39		EVP_PKEY *pkey, int ispub)
40	0	{
41	0	BIO *out = ossl_bio_new_from_core_bio(ctx->provctx, cout);
42	0	int ret;
43
44	0	if (out == NULL)
45	0	return 0;
46	0	ret = ispub ? i2b_PublicKey_bio(out, pkey) : i2b_PrivateKey_bio(out, pkey);
47
48	0	BIO_free(out);
49	0	return ret;
50	0	}
51
52		static int write_pvk(struct key2ms_ctx_st ctx, OSSL_CORE_BIO cout,
53		EVP_PKEY *pkey)
54	0	{
55	0	BIO *out = NULL;
56	0	int ret;
57	0	OSSL_LIB_CTX *libctx = PROV_LIBCTX_OF(ctx->provctx);
58
59	0	out = ossl_bio_new_from_core_bio(ctx->provctx, cout);
60	0	if (out == NULL)
61	0	return 0;
62	0	ret = i2b_PVK_bio_ex(out, pkey, ctx->pvk_encr_level,
63	0	ossl_pw_pvk_password, &ctx->pwdata, libctx, NULL);
64	0	BIO_free(out);
65	0	return ret;
66	0	}
67
68		static OSSL_FUNC_encoder_freectx_fn key2ms_freectx;
69		static OSSL_FUNC_encoder_does_selection_fn key2ms_does_selection;
70
71		static struct key2ms_ctx_st key2ms_newctx(void provctx)
72	0	{
73	0	struct key2ms_ctx_st ctx = OPENSSL_zalloc(sizeof(ctx));
74
75	0	if (ctx != NULL) {
76	0	ctx->provctx = provctx;
77		/* This is the strongest encryption level */
78	0	ctx->pvk_encr_level = 2;
79	0	}
80	0	return ctx;
81	0	}
82
83		static void key2ms_freectx(void *vctx)
84	0	{
85	0	struct key2ms_ctx_st *ctx = vctx;
86
87	0	ossl_pw_clear_passphrase_data(&ctx->pwdata);
88	0	OPENSSL_free(ctx);
89	0	}
90
91		static const OSSL_PARAM key2pvk_settable_ctx_params(ossl_unused void provctx)
92	0	{
93	0	static const OSSL_PARAM settables[] = {
94	0	OSSL_PARAM_int(OSSL_ENCODER_PARAM_ENCRYPT_LEVEL, NULL),
95	0	OSSL_PARAM_END,
96	0	};
97
98	0	return settables;
99	0	}
100
101		static int key2pvk_set_ctx_params(void *vctx, const OSSL_PARAM params[])
102	0	{
103	0	struct key2ms_ctx_st *ctx = vctx;
104	0	const OSSL_PARAM *p;
105
106	0	p = OSSL_PARAM_locate_const(params, OSSL_ENCODER_PARAM_ENCRYPT_LEVEL);
107	0	if (p != NULL && !OSSL_PARAM_get_int(p, &ctx->pvk_encr_level))
108	0	return 0;
109	0	return 1;
110	0	}
111
112		static int key2ms_does_selection(void *vctx, int selection)
113	0	{
114	0	return (selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0;
115	0	}
116
117		/*
118		* The real EVP_PKEY_set1_TYPE() functions take a non-const key, while the key
119		* pointer in the encode function is a const pointer. We violate the constness
120		* knowingly, since we know that the key comes from the same provider, is never
121		* actually const, and the implied reference count change is safe.
122		*
123		* EVP_PKEY_assign() can't be used, because there's no way to clear the internal
124		* key using that function without freeing the existing internal key.
125		*/
126		typedef int evp_pkey_set1_fn(EVP_PKEY , const void key);
127
128		static int key2msblob_encode(void vctx, const void key, int selection,
129		OSSL_CORE_BIO cout, evp_pkey_set1_fn set1_key,
130		OSSL_PASSPHRASE_CALLBACK pw_cb, void pw_cbarg)
131	0	{
132	0	struct key2ms_ctx_st *ctx = vctx;
133	0	int ispub = -1;
134	0	EVP_PKEY *pkey = NULL;
135	0	int ok = 0;
136
137	0	if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
138	0	ispub = 0;
139	0	else if ((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0)
140	0	ispub = 1;
141	0	else
142	0	return 0; /* Error */
143
144	0	if ((pkey = EVP_PKEY_new()) != NULL && set1_key(pkey, key))
145	0	ok = write_msblob(ctx, cout, pkey, ispub);
146	0	EVP_PKEY_free(pkey);
147	0	return ok;
148	0	}
149
150		static int key2pvk_encode(void vctx, const void key, int selection,
151		OSSL_CORE_BIO cout, evp_pkey_set1_fn set1_key,
152		OSSL_PASSPHRASE_CALLBACK pw_cb, void pw_cbarg)
153	0	{
154	0	struct key2ms_ctx_st *ctx = vctx;
155	0	EVP_PKEY *pkey = NULL;
156	0	int ok = 0;
157
158	0	if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) == 0)
159	0	return 0; /* Error */
160
161	0	if ((pkey = EVP_PKEY_new()) != NULL && set1_key(pkey, key)
162	0	&& (pw_cb == NULL
163	0	\|\| ossl_pw_set_ossl_passphrase_cb(&ctx->pwdata, pw_cb, pw_cbarg)))
164	0	ok = write_pvk(ctx, cout, pkey);
165	0	EVP_PKEY_free(pkey);
166	0	return ok;
167	0	}
168
169	0	#define dsa_set1 (evp_pkey_set1_fn *)EVP_PKEY_set1_DSA
170	0	#define rsa_set1 (evp_pkey_set1_fn *)EVP_PKEY_set1_RSA
171
172		#define msblob_set_params
173		#define pvk_set_params \
174		{ OSSL_FUNC_ENCODER_SETTABLE_CTX_PARAMS, \
175		(void (*)(void))key2pvk_settable_ctx_params }, \
176		{ OSSL_FUNC_ENCODER_SET_CTX_PARAMS, \
177		(void (*)(void))key2pvk_set_ctx_params },
178
179		#define MAKE_MS_ENCODER(impl, output, type) \
180		static OSSL_FUNC_encoder_import_object_fn \
181		impl##2##output##_import_object; \
182		static OSSL_FUNC_encoder_free_object_fn impl##2##output##_free_object; \
183		static OSSL_FUNC_encoder_encode_fn impl##2##output##_encode; \
184		\
185		static void * \
186		impl##2##output##_import_object(void *ctx, int selection, \
187		const OSSL_PARAM params[]) \
188	0	{ \
189	0	return ossl_prov_import_key(ossl_##impl##_keymgmt_functions, \
190	0	ctx, selection, params); \
191	0	} \ Unexecuted instantiation: encode_key2ms.c:dsa2pvk_import_object Unexecuted instantiation: encode_key2ms.c:dsa2msblob_import_object Unexecuted instantiation: encode_key2ms.c:rsa2pvk_import_object Unexecuted instantiation: encode_key2ms.c:rsa2msblob_import_object
192		static void impl##2##output##_free_object(void *key) \
193	0	{ \
194	0	ossl_prov_free_key(ossl_##impl##_keymgmt_functions, key); \
195	0	} \ Unexecuted instantiation: encode_key2ms.c:dsa2pvk_free_object Unexecuted instantiation: encode_key2ms.c:dsa2msblob_free_object Unexecuted instantiation: encode_key2ms.c:rsa2pvk_free_object Unexecuted instantiation: encode_key2ms.c:rsa2msblob_free_object
196		static int impl##2##output##_encode(void vctx, OSSL_CORE_BIO cout, \
197		const void *key, \
198		const OSSL_PARAM key_abstract[], \
199		int selection, \
200		OSSL_PASSPHRASE_CALLBACK *cb, \
201		void *cbarg) \
202	0	{ \
203	0	/* We don't deal with abstract objects */ \
204	0	if (key_abstract != NULL) { \
205	0	ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); \
206	0	return 0; \
207	0	} \
208	0	return key2##output##_encode(vctx, key, selection, cout, type##_set1, \
209	0	cb, cbarg); \
210	0	} \ Unexecuted instantiation: encode_key2ms.c:dsa2pvk_encode Unexecuted instantiation: encode_key2ms.c:dsa2msblob_encode Unexecuted instantiation: encode_key2ms.c:rsa2pvk_encode Unexecuted instantiation: encode_key2ms.c:rsa2msblob_encode
211		const OSSL_DISPATCH ossl_##impl##_to_##output##_encoder_functions[] = { \
212		{ OSSL_FUNC_ENCODER_NEWCTX, \
213		(void (*)(void))key2ms_newctx }, \
214		{ OSSL_FUNC_ENCODER_FREECTX, \
215		(void (*)(void))key2ms_freectx }, \
216		output##_set_params \
217		{ OSSL_FUNC_ENCODER_DOES_SELECTION, \
218		(void (*)(void))key2ms_does_selection }, \
219		{ OSSL_FUNC_ENCODER_IMPORT_OBJECT, \
220		(void (*)(void))impl##2##output##_import_object }, \
221		{ OSSL_FUNC_ENCODER_FREE_OBJECT, \
222		(void (*)(void))impl##2##output##_free_object }, \
223		{ OSSL_FUNC_ENCODER_ENCODE, \
224		(void (*)(void))impl##2##output##_encode }, \
225		OSSL_DISPATCH_END \
226		}
227
228		#ifndef OPENSSL_NO_DSA
229		MAKE_MS_ENCODER(dsa, pvk, dsa);
230		MAKE_MS_ENCODER(dsa, msblob, dsa);
231		#endif
232
233		MAKE_MS_ENCODER(rsa, pvk, rsa);
234		MAKE_MS_ENCODER(rsa, msblob, rsa);