[thirdparty/openssl.git] / providers / implementations / encode_decode / decode_pvk2key.c

/*
 * 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_dispatch.h>
#include <openssl/core_names.h>
#include <openssl/core_object.h>
#include <openssl/crypto.h>
#include <openssl/params.h>
#include <openssl/err.h>
#include <openssl/pem.h>         /* For public PVK functions */
#include <openssl/x509.h>
#include "internal/passphrase.h"
#include "internal/sizes.h"
#include "crypto/pem.h"          /* For internal PVK and "blob" headers */
#include "crypto/rsa.h"
#include "prov/bio.h"
#include "prov/implementations.h"
#include "endecoder_local.h"

struct pvk2key_ctx_st;            /* Forward declaration */
typedef int check_key_fn(void *, struct pvk2key_ctx_st *ctx);
typedef void adjust_key_fn(void *, struct pvk2key_ctx_st *ctx);
typedef void *b2i_PVK_of_bio_pw_fn(BIO *in, pem_password_cb *cb, void *u,
                                   OSSL_LIB_CTX *libctx, const char *propq);
typedef void free_key_fn(void *);
struct keytype_desc_st {
    int type;                 /* EVP key type */
    const char *name;         /* Keytype */
    const OSSL_DISPATCH *fns; /* Keymgmt (to pilfer functions from) */

    b2i_PVK_of_bio_pw_fn *read_private_key;
    adjust_key_fn *adjust_key;
    free_key_fn *free_key;
};

static OSSL_FUNC_decoder_freectx_fn pvk2key_freectx;
static OSSL_FUNC_decoder_decode_fn pvk2key_decode;
static OSSL_FUNC_decoder_export_object_fn pvk2key_export_object;
static OSSL_FUNC_decoder_settable_ctx_params_fn pvk2key_settable_ctx_params;
static OSSL_FUNC_decoder_set_ctx_params_fn pvk2key_set_ctx_params;

/*
 * Context used for DER to key decoding.
 */
struct pvk2key_ctx_st {
    PROV_CTX *provctx;
    char propq[OSSL_MAX_PROPQUERY_SIZE];
    const struct keytype_desc_st *desc;
    /* The selection that is passed to der2key_decode() */
    int selection;
};

static struct pvk2key_ctx_st *
pvk2key_newctx(void *provctx, const struct keytype_desc_st *desc)
{
    struct pvk2key_ctx_st *ctx = OPENSSL_zalloc(sizeof(*ctx));

    if (ctx != NULL) {
        ctx->provctx = provctx;
        ctx->desc = desc;
    }
    return ctx;
}

static void pvk2key_freectx(void *vctx)
{
    struct pvk2key_ctx_st *ctx = vctx;

    OPENSSL_free(ctx);
}

static const OSSL_PARAM *pvk2key_settable_ctx_params(ossl_unused void *provctx)
{
    static const OSSL_PARAM settables[] = {
        OSSL_PARAM_utf8_string(OSSL_DECODER_PARAM_PROPERTIES, NULL, 0),
        OSSL_PARAM_END,
    };
    return settables;
}

static int pvk2key_set_ctx_params(void *vctx, const OSSL_PARAM params[])
{
    struct pvk2key_ctx_st *ctx = vctx;
    const OSSL_PARAM *p;
    char *str = ctx->propq;

    p = OSSL_PARAM_locate_const(params, OSSL_DECODER_PARAM_PROPERTIES);
    if (p != NULL && !OSSL_PARAM_get_utf8_string(p, &str, sizeof(ctx->propq)))
        return 0;

    return 1;
}

static int pvk2key_does_selection(void *provctx, int selection)
{
    if (selection == 0)
        return 1;

    if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY)  != 0)
        return 1;

    return 0;
}

static int pvk2key_decode(void *vctx, OSSL_CORE_BIO *cin, int selection,
                         OSSL_CALLBACK *data_cb, void *data_cbarg,
                         OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg)
{
    struct pvk2key_ctx_st *ctx = vctx;
    BIO *in = ossl_bio_new_from_core_bio(ctx->provctx, cin);
    void *key = NULL;
    int ok = 0;

    if (in == NULL)
        return 0;

    ctx->selection = selection;

    if ((selection == 0
         || (selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
        && ctx->desc->read_private_key != NULL) {
        struct ossl_passphrase_data_st pwdata;
        int err, lib, reason;

        memset(&pwdata, 0, sizeof(pwdata));
        if (!ossl_pw_set_ossl_passphrase_cb(&pwdata, pw_cb, pw_cbarg))
            goto end;

        key = ctx->desc->read_private_key(in, ossl_pw_pvk_password, &pwdata,
                                          PROV_LIBCTX_OF(ctx->provctx),
                                          ctx->propq);

        /*
         * Because the PVK API doesn't have a separate decrypt call, we need
         * to check the error queue for certain well known errors that are
         * considered fatal and which we pass through, while the rest gets
         * thrown away.
         */
        err = ERR_peek_last_error();
        lib = ERR_GET_LIB(err);
        reason = ERR_GET_REASON(err);
        if (lib == ERR_LIB_PEM
            && (reason == PEM_R_BAD_PASSWORD_READ
                || reason == PEM_R_BAD_DECRYPT)) {
            ERR_clear_last_mark();
            goto end;
        }

        if (selection != 0 && key == NULL)
            goto next;
    }

    if (key != NULL && ctx->desc->adjust_key != NULL)
        ctx->desc->adjust_key(key, ctx);

 next:
    /*
     * Indicated that we successfully decoded something, or not at all.
     * Ending up "empty handed" is not an error.
     */
    ok = 1;

    /*
     * We free resources here so it's not held up during the callback, because
     * we know the process is recursive and the allocated chunks of memory
     * add up.
     */
    BIO_free(in);
    in = NULL;

    if (key != NULL) {
        OSSL_PARAM params[4];
        int object_type = OSSL_OBJECT_PKEY;

        params[0] =
            OSSL_PARAM_construct_int(OSSL_OBJECT_PARAM_TYPE, &object_type);
        params[1] =
            OSSL_PARAM_construct_utf8_string(OSSL_OBJECT_PARAM_DATA_TYPE,
                                             (char *)ctx->desc->name, 0);
        /* The address of the key becomes the octet string */
        params[2] =
            OSSL_PARAM_construct_octet_string(OSSL_OBJECT_PARAM_REFERENCE,
                                              &key, sizeof(key));
        params[3] = OSSL_PARAM_construct_end();

        ok = data_cb(params, data_cbarg);
    }

 end:
    BIO_free(in);
    ctx->desc->free_key(key);

    return ok;
}

static int pvk2key_export_object(void *vctx,
                                const void *reference, size_t reference_sz,
                                OSSL_CALLBACK *export_cb, void *export_cbarg)
{
    struct pvk2key_ctx_st *ctx = vctx;
    OSSL_FUNC_keymgmt_export_fn *export =
        ossl_prov_get_keymgmt_export(ctx->desc->fns);
    void *keydata;

    if (reference_sz == sizeof(keydata) && export != NULL) {
        int selection = ctx->selection;

        if (selection == 0)
            selection = OSSL_KEYMGMT_SELECT_ALL;
        /* The contents of the reference is the address to our object */
        keydata = *(void **)reference;

        return export(keydata, selection, export_cb, export_cbarg);
    }
    return 0;
}

/* ---------------------------------------------------------------------- */

#define dsa_private_key_bio     (b2i_PVK_of_bio_pw_fn *)b2i_DSA_PVK_bio_ex
#define dsa_adjust              NULL
#define dsa_free                (void (*)(void *))DSA_free

/* ---------------------------------------------------------------------- */

#define rsa_private_key_bio     (b2i_PVK_of_bio_pw_fn *)b2i_RSA_PVK_bio_ex

static void rsa_adjust(void *key, struct pvk2key_ctx_st *ctx)
{
    ossl_rsa_set0_libctx(key, PROV_LIBCTX_OF(ctx->provctx));
}

#define rsa_free                (void (*)(void *))RSA_free

/* ---------------------------------------------------------------------- */

#define IMPLEMENT_MS(KEYTYPE, keytype)                                  \
    static const struct keytype_desc_st                                 \
    pvk2##keytype##_desc = {                                            \
        EVP_PKEY_##KEYTYPE, #KEYTYPE,                                   \
        ossl_##keytype##_keymgmt_functions,                             \
        keytype##_private_key_bio,                                      \
        keytype##_adjust,                                               \
        keytype##_free                                                  \
    };                                                                  \
    static OSSL_FUNC_decoder_newctx_fn pvk2##keytype##_newctx;          \
    static void *pvk2##keytype##_newctx(void *provctx)                  \
    {                                                                   \
        return pvk2key_newctx(provctx, &pvk2##keytype##_desc);          \
    }                                                                   \
    const OSSL_DISPATCH                                                 \
    ossl_##pvk_to_##keytype##_decoder_functions[] = {                   \
        { OSSL_FUNC_DECODER_NEWCTX,                                     \
          (void (*)(void))pvk2##keytype##_newctx },                     \
        { OSSL_FUNC_DECODER_FREECTX,                                    \
          (void (*)(void))pvk2key_freectx },                            \
        { OSSL_FUNC_DECODER_DOES_SELECTION,                             \
          (void (*)(void))pvk2key_does_selection },                     \
        { OSSL_FUNC_DECODER_DECODE,                                     \
          (void (*)(void))pvk2key_decode },                             \
        { OSSL_FUNC_DECODER_EXPORT_OBJECT,                              \
          (void (*)(void))pvk2key_export_object },                      \
        { OSSL_FUNC_DECODER_SETTABLE_CTX_PARAMS,                        \
          (void (*)(void))pvk2key_settable_ctx_params },                \
        { OSSL_FUNC_DECODER_SET_CTX_PARAMS,                             \
          (void (*)(void))pvk2key_set_ctx_params },                     \
        OSSL_DISPATCH_END                                               \
    }

#ifndef OPENSSL_NO_DSA
IMPLEMENT_MS(DSA, dsa);
#endif
IMPLEMENT_MS(RSA, rsa);
Commit	Line	Data
f4e46b81	1	/*
da1c088f	2	* Copyright 2020-2023 The OpenSSL Project Authors. All Rights Reserved.
f4e46b81 RL	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
	12	* internal use.
	13	*/
	14	#include "internal/deprecated.h"
	15
	16	#include <string.h>
	17
	18	#include <openssl/core_dispatch.h>
	19	#include <openssl/core_names.h>
	20	#include <openssl/core_object.h>
	21	#include <openssl/crypto.h>
	22	#include <openssl/params.h>
9cc97ddf	23	#include <openssl/err.h>
f4e46b81 RL	24	#include <openssl/pem.h> /* For public PVK functions */
	25	#include <openssl/x509.h>
	26	#include "internal/passphrase.h"
39ed7636	27	#include "internal/sizes.h"
f4e46b81 RL	28	#include "crypto/pem.h" /* For internal PVK and "blob" headers */
	29	#include "crypto/rsa.h"
	30	#include "prov/bio.h"
	31	#include "prov/implementations.h"
	32	#include "endecoder_local.h"
	33
	34	struct pvk2key_ctx_st; /* Forward declaration */
	35	typedef int check_key_fn(void , struct pvk2key_ctx_st ctx);
	36	typedef void adjust_key_fn(void , struct pvk2key_ctx_st ctx);
5e2d22d5 JS	37	typedef void b2i_PVK_of_bio_pw_fn(BIO in, pem_password_cb cb, void u,
5e2d22d5 JS	38	OSSL_LIB_CTX libctx, const char propq);
f4e46b81 RL	39	typedef void free_key_fn(void *);
	40	struct keytype_desc_st {
	41	int type; /* EVP key type */
	42	const char name; / Keytype */
	43	const OSSL_DISPATCH fns; / Keymgmt (to pilfer functions from) */
	44
	45	b2i_PVK_of_bio_pw_fn *read_private_key;
	46	adjust_key_fn *adjust_key;
	47	free_key_fn *free_key;
	48	};
	49
	50	static OSSL_FUNC_decoder_freectx_fn pvk2key_freectx;
f4e46b81 RL	51	static OSSL_FUNC_decoder_decode_fn pvk2key_decode;
f4e46b81 RL	52	static OSSL_FUNC_decoder_export_object_fn pvk2key_export_object;
39ed7636	53	static OSSL_FUNC_decoder_settable_ctx_params_fn pvk2key_settable_ctx_params;
39ed7636	54	static OSSL_FUNC_decoder_set_ctx_params_fn pvk2key_set_ctx_params;
f4e46b81 RL	55
	56	/*
	57	* Context used for DER to key decoding.
	58	*/
	59	struct pvk2key_ctx_st {
	60	PROV_CTX *provctx;
39ed7636	61	char propq[OSSL_MAX_PROPQUERY_SIZE];
f4e46b81	62	const struct keytype_desc_st *desc;
398f8fe1 RL	63	/* The selection that is passed to der2key_decode() */
398f8fe1 RL	64	int selection;
f4e46b81 RL	65	};
	66
	67	static struct pvk2key_ctx_st *
	68	pvk2key_newctx(void provctx, const struct keytype_desc_st desc)
	69	{
	70	struct pvk2key_ctx_st ctx = OPENSSL_zalloc(sizeof(ctx));
	71
	72	if (ctx != NULL) {
	73	ctx->provctx = provctx;
	74	ctx->desc = desc;
	75	}
	76	return ctx;
	77	}
	78
	79	static void pvk2key_freectx(void *vctx)
	80	{
	81	struct pvk2key_ctx_st *ctx = vctx;
	82
	83	OPENSSL_free(ctx);
	84	}
	85
39ed7636	86	static const OSSL_PARAM pvk2key_settable_ctx_params(ossl_unused void provctx)
	87	{
	88	static const OSSL_PARAM settables[] = {
	89	OSSL_PARAM_utf8_string(OSSL_DECODER_PARAM_PROPERTIES, NULL, 0),
	90	OSSL_PARAM_END,
	91	};
	92	return settables;
	93	}
	94
	95	static int pvk2key_set_ctx_params(void *vctx, const OSSL_PARAM params[])
	96	{
	97	struct pvk2key_ctx_st *ctx = vctx;
	98	const OSSL_PARAM *p;
	99	char *str = ctx->propq;
	100
	101	p = OSSL_PARAM_locate_const(params, OSSL_DECODER_PARAM_PROPERTIES);
	102	if (p != NULL && !OSSL_PARAM_get_utf8_string(p, &str, sizeof(ctx->propq)))
	103	return 0;
	104
	105	return 1;
	106	}
	107
6207f2b6 MC	108	static int pvk2key_does_selection(void *provctx, int selection)
	109	{
	110	if (selection == 0)
	111	return 1;
	112
	113	if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
	114	return 1;
	115
	116	return 0;
	117	}
	118
f4e46b81 RL	119	static int pvk2key_decode(void vctx, OSSL_CORE_BIO cin, int selection,
	120	OSSL_CALLBACK data_cb, void data_cbarg,
	121	OSSL_PASSPHRASE_CALLBACK pw_cb, void pw_cbarg)
	122	{
	123	struct pvk2key_ctx_st *ctx = vctx;
	124	BIO *in = ossl_bio_new_from_core_bio(ctx->provctx, cin);
	125	void *key = NULL;
	126	int ok = 0;
	127
352a0bca	128	if (in == NULL)
	129	return 0;
	130
398f8fe1 RL	131	ctx->selection = selection;
398f8fe1 RL	132
f4e46b81 RL	133	if ((selection == 0
	134	\|\| (selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
	135	&& ctx->desc->read_private_key != NULL) {
	136	struct ossl_passphrase_data_st pwdata;
9cc97ddf	137	int err, lib, reason;
f4e46b81 RL	138
	139	memset(&pwdata, 0, sizeof(pwdata));
	140	if (!ossl_pw_set_ossl_passphrase_cb(&pwdata, pw_cb, pw_cbarg))
	141	goto end;
9cc97ddf	142
28257d60	143	key = ctx->desc->read_private_key(in, ossl_pw_pvk_password, &pwdata,
39ed7636	144	PROV_LIBCTX_OF(ctx->provctx),
39ed7636	145	ctx->propq);
9cc97ddf RL	146
	147	/*
	148	* Because the PVK API doesn't have a separate decrypt call, we need
	149	* to check the error queue for certain well known errors that are
	150	* considered fatal and which we pass through, while the rest gets
	151	* thrown away.
	152	*/
	153	err = ERR_peek_last_error();
	154	lib = ERR_GET_LIB(err);
	155	reason = ERR_GET_REASON(err);
	156	if (lib == ERR_LIB_PEM
	157	&& (reason == PEM_R_BAD_PASSWORD_READ
	158	\|\| reason == PEM_R_BAD_DECRYPT)) {
	159	ERR_clear_last_mark();
	160	goto end;
	161	}
	162
f4e46b81 RL	163	if (selection != 0 && key == NULL)
	164	goto next;
	165	}
	166
	167	if (key != NULL && ctx->desc->adjust_key != NULL)
	168	ctx->desc->adjust_key(key, ctx);
	169
	170	next:
9cc97ddf RL	171	/*
	172	* Indicated that we successfully decoded something, or not at all.
	173	* Ending up "empty handed" is not an error.
	174	*/
	175	ok = 1;
	176
f4e46b81 RL	177	/*
	178	* We free resources here so it's not held up during the callback, because
	179	* we know the process is recursive and the allocated chunks of memory
	180	* add up.
	181	*/
	182	BIO_free(in);
	183	in = NULL;
	184
	185	if (key != NULL) {
	186	OSSL_PARAM params[4];
	187	int object_type = OSSL_OBJECT_PKEY;
	188
	189	params[0] =
	190	OSSL_PARAM_construct_int(OSSL_OBJECT_PARAM_TYPE, &object_type);
	191	params[1] =
	192	OSSL_PARAM_construct_utf8_string(OSSL_OBJECT_PARAM_DATA_TYPE,
	193	(char *)ctx->desc->name, 0);
	194	/* The address of the key becomes the octet string */
	195	params[2] =
	196	OSSL_PARAM_construct_octet_string(OSSL_OBJECT_PARAM_REFERENCE,
	197	&key, sizeof(key));
	198	params[3] = OSSL_PARAM_construct_end();
	199
	200	ok = data_cb(params, data_cbarg);
	201	}
	202
	203	end:
	204	BIO_free(in);
	205	ctx->desc->free_key(key);
	206
	207	return ok;
	208	}
	209
	210	static int pvk2key_export_object(void *vctx,
	211	const void *reference, size_t reference_sz,
	212	OSSL_CALLBACK export_cb, void export_cbarg)
	213	{
	214	struct pvk2key_ctx_st *ctx = vctx;
	215	OSSL_FUNC_keymgmt_export_fn *export =
	216	ossl_prov_get_keymgmt_export(ctx->desc->fns);
	217	void *keydata;
	218
	219	if (reference_sz == sizeof(keydata) && export != NULL) {
2acb0d36 TM	220	int selection = ctx->selection;
	221
	222	if (selection == 0)
	223	selection = OSSL_KEYMGMT_SELECT_ALL;
f4e46b81 RL	224	/* The contents of the reference is the address to our object */
	225	keydata = (void *)reference;
	226
2acb0d36	227	return export(keydata, selection, export_cb, export_cbarg);
f4e46b81 RL	228	}
	229	return 0;
	230	}
	231
	232	/* ---------------------------------------------------------------------- */
	233
5e2d22d5	234	#define dsa_private_key_bio (b2i_PVK_of_bio_pw_fn *)b2i_DSA_PVK_bio_ex
f4e46b81 RL	235	#define dsa_adjust NULL
	236	#define dsa_free (void ()(void ))DSA_free
	237
	238	/* ---------------------------------------------------------------------- */
	239
5e2d22d5	240	#define rsa_private_key_bio (b2i_PVK_of_bio_pw_fn *)b2i_RSA_PVK_bio_ex
f4e46b81 RL	241
	242	static void rsa_adjust(void key, struct pvk2key_ctx_st ctx)
	243	{
	244	ossl_rsa_set0_libctx(key, PROV_LIBCTX_OF(ctx->provctx));
	245	}
	246
	247	#define rsa_free (void ()(void ))RSA_free
	248
	249	/* ---------------------------------------------------------------------- */
	250
	251	#define IMPLEMENT_MS(KEYTYPE, keytype) \
	252	static const struct keytype_desc_st \
	253	pvk2##keytype##_desc = { \
	254	EVP_PKEY_##KEYTYPE, #KEYTYPE, \
	255	ossl_##keytype##_keymgmt_functions, \
	256	keytype##_private_key_bio, \
	257	keytype##_adjust, \
	258	keytype##_free \
	259	}; \
	260	static OSSL_FUNC_decoder_newctx_fn pvk2##keytype##_newctx; \
	261	static void pvk2##keytype##_newctx(void provctx) \
	262	{ \
	263	return pvk2key_newctx(provctx, &pvk2##keytype##_desc); \
	264	} \
	265	const OSSL_DISPATCH \
	266	ossl_##pvk_to_##keytype##_decoder_functions[] = { \
	267	{ OSSL_FUNC_DECODER_NEWCTX, \
	268	(void (*)(void))pvk2##keytype##_newctx }, \
	269	{ OSSL_FUNC_DECODER_FREECTX, \
	270	(void (*)(void))pvk2key_freectx }, \
6207f2b6 MC	271	{ OSSL_FUNC_DECODER_DOES_SELECTION, \
6207f2b6 MC	272	(void (*)(void))pvk2key_does_selection }, \
f4e46b81 RL	273	{ OSSL_FUNC_DECODER_DECODE, \
	274	(void (*)(void))pvk2key_decode }, \
	275	{ OSSL_FUNC_DECODER_EXPORT_OBJECT, \
	276	(void (*)(void))pvk2key_export_object }, \
39ed7636	277	{ OSSL_FUNC_DECODER_SETTABLE_CTX_PARAMS, \
	278	(void (*)(void))pvk2key_settable_ctx_params }, \
	279	{ OSSL_FUNC_DECODER_SET_CTX_PARAMS, \
	280	(void (*)(void))pvk2key_set_ctx_params }, \
1e6bd31e	281	OSSL_DISPATCH_END \
f4e46b81 RL	282	}
	283
	284	#ifndef OPENSSL_NO_DSA
	285	IMPLEMENT_MS(DSA, dsa);
	286	#endif
	287	IMPLEMENT_MS(RSA, rsa);