2 * Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
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
11 * low level APIs are deprecated for public use, but still ok for
14 #include "internal/deprecated.h"
16 #include <openssl/core_dispatch.h>
17 #include <openssl/core_names.h>
18 #include <openssl/crypto.h>
19 #include <openssl/params.h>
20 #include <openssl/x509.h>
22 #include "prov/implementations.h"
23 #include "serializer_local.h"
25 static OSSL_FUNC_deserializer_newctx_fn der2rsa_newctx;
27 static OSSL_FUNC_deserializer_freectx_fn der2key_freectx;
28 static OSSL_FUNC_deserializer_gettable_params_fn der2key_gettable_params;
29 static OSSL_FUNC_deserializer_get_params_fn der2key_get_params;
30 static OSSL_FUNC_deserializer_deserialize_fn der2key_deserialize;
31 static OSSL_FUNC_deserializer_export_object_fn der2key_export_object;
33 typedef void *(extract_key_fn)(EVP_PKEY *);
34 typedef void (free_key_fn)(void *);
35 struct keytype_desc_st {
36 int type; /* EVP key type */
37 const char *name; /* Keytype */
38 const OSSL_DISPATCH *fns; /* Keymgmt (to pilfer functions from) */
41 * These must be the correct EVP_PKEY_get1_{TYPE}() and {TYPE}_free()
42 * function for the key.
44 extract_key_fn *extract_key;
45 free_key_fn *free_key;
49 * Context used for DER to key deserialization.
51 struct der2key_ctx_st {
53 const struct keytype_desc_st *desc;
56 static struct der2key_ctx_st *
57 der2key_newctx(void *provctx, const struct keytype_desc_st *desc)
59 struct der2key_ctx_st *ctx = OPENSSL_zalloc(sizeof(*ctx));
62 ctx->provctx = provctx;
68 static void der2key_freectx(void *vctx)
70 struct der2key_ctx_st *ctx = vctx;
75 static const OSSL_PARAM *der2key_gettable_params(void)
77 static const OSSL_PARAM gettables[] = {
78 { OSSL_DESERIALIZER_PARAM_INPUT_TYPE, OSSL_PARAM_UTF8_PTR, NULL, 0, 0 },
85 static int der2key_get_params(OSSL_PARAM params[])
89 p = OSSL_PARAM_locate(params, OSSL_DESERIALIZER_PARAM_INPUT_TYPE);
90 if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, "DER"))
96 static int der2key_deserialize(void *vctx, OSSL_CORE_BIO *cin,
97 OSSL_CALLBACK *data_cb, void *data_cbarg,
98 OSSL_PASSPHRASE_CALLBACK *pw_cb, void *pw_cbarg)
100 struct der2key_ctx_st *ctx = vctx;
101 void *libctx = PROV_LIBRARY_CONTEXT_OF(ctx->provctx);
102 unsigned char *der = NULL;
103 const unsigned char *derp;
105 unsigned char *new_der = NULL;
107 EVP_PKEY *pkey = NULL;
111 if (!ossl_prov_read_der(ctx->provctx, cin, &der, &der_len))
115 * Opportunistic attempt to decrypt. If it doesn't work, we try to
116 * decode our input unencrypted.
118 if (ossl_prov_der_from_p8(&new_der, &new_der_len, der, der_len,
122 der_len = new_der_len;
126 pkey = d2i_PrivateKey_ex(ctx->desc->type, NULL, &derp, der_len,
130 pkey = d2i_PUBKEY(NULL, &derp, der_len);
135 * Tear out the low-level key pointer from the pkey,
136 * but only if it matches the expected key type.
138 * TODO(3.0): The check should be done with EVP_PKEY_is_a(), but
139 * as long as we still have #legacy internal keys, it's safer to
140 * use the type numbers in side the provider.
142 if (EVP_PKEY_id(pkey) == ctx->desc->type)
143 key = ctx->desc->extract_key(pkey);
146 * ctx->desc->extract_key() is expected to have incremented |key|'s
147 * reference count, so it should be safe to free |pkey| now.
155 OSSL_PARAM params[3];
158 OSSL_PARAM_construct_utf8_string(OSSL_DESERIALIZER_PARAM_DATA_TYPE,
159 (char *)ctx->desc->name, 0);
160 /* The address of the key becomes the octet string */
162 OSSL_PARAM_construct_octet_string(OSSL_DESERIALIZER_PARAM_REFERENCE,
164 params[2] = OSSL_PARAM_construct_end();
166 ok = data_cb(params, data_cbarg);
168 ctx->desc->free_key(key);
173 static int der2key_export_object(void *vctx,
174 const void *reference, size_t reference_sz,
175 OSSL_CALLBACK *export_cb, void *export_cbarg)
177 struct der2key_ctx_st *ctx = vctx;
178 OSSL_FUNC_keymgmt_export_fn *export =
179 ossl_prov_get_keymgmt_export(ctx->desc->fns);
182 if (reference_sz == sizeof(keydata) && export != NULL) {
183 /* The contents of the reference is the address to our object */
184 keydata = *(void **)reference;
186 return export(keydata, OSSL_KEYMGMT_SELECT_ALL,
187 export_cb, export_cbarg);
192 #define IMPLEMENT_NEWCTX(KEYTYPEstr, KEYTYPE, keytype, extract, free) \
193 static const struct keytype_desc_st keytype##_desc = \
194 { EVP_PKEY_##KEYTYPE, KEYTYPEstr, keytype##_keymgmt_functions, \
195 (extract_key_fn *)extract, \
196 (free_key_fn *)free }; \
197 static void *der2##keytype##_newctx(void *provctx) \
199 return der2key_newctx(provctx, &keytype##_desc); \
201 const OSSL_DISPATCH der_to_##keytype##_deserializer_functions[] = { \
202 { OSSL_FUNC_DESERIALIZER_NEWCTX, \
203 (void (*)(void))der2##keytype##_newctx }, \
204 { OSSL_FUNC_DESERIALIZER_FREECTX, \
205 (void (*)(void))der2key_freectx }, \
206 { OSSL_FUNC_DESERIALIZER_GETTABLE_PARAMS, \
207 (void (*)(void))der2key_gettable_params }, \
208 { OSSL_FUNC_DESERIALIZER_GET_PARAMS, \
209 (void (*)(void))der2key_get_params }, \
210 { OSSL_FUNC_DESERIALIZER_DESERIALIZE, \
211 (void (*)(void))der2key_deserialize }, \
212 { OSSL_FUNC_DESERIALIZER_EXPORT_OBJECT, \
213 (void (*)(void))der2key_export_object }, \
217 #ifndef OPENSSL_NO_DH
218 IMPLEMENT_NEWCTX("DH", DH, dh, EVP_PKEY_get1_DH, DH_free);
220 #ifndef OPENSSL_NO_DSA
221 IMPLEMENT_NEWCTX("DSA", DSA, dsa, EVP_PKEY_get1_DSA, DSA_free);
223 #ifndef OPENSSL_NO_EC
224 IMPLEMENT_NEWCTX("EC", EC, ec, EVP_PKEY_get1_EC_KEY, EC_KEY_free);
225 IMPLEMENT_NEWCTX("X25519", X25519, x25519,
226 EVP_PKEY_get1_X25519, ecx_key_free);
227 IMPLEMENT_NEWCTX("X448", X448, x448,
228 EVP_PKEY_get1_X448, ecx_key_free);
229 IMPLEMENT_NEWCTX("ED25519", ED25519, ed25519,
230 EVP_PKEY_get1_ED25519, ecx_key_free);
231 IMPLEMENT_NEWCTX("ED448", ED448, ed448, EVP_PKEY_get1_ED448, ecx_key_free);
233 IMPLEMENT_NEWCTX("RSA", RSA, rsa, EVP_PKEY_get1_RSA, RSA_free);
234 IMPLEMENT_NEWCTX("RSA-PSS", RSA_PSS, rsapss, EVP_PKEY_get1_RSA, RSA_free);