2 * Copyright 2019-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
10 #include <openssl/core_names.h>
11 #include "internal/cryptlib.h"
12 #include "internal/nelem.h"
13 #include "crypto/evp.h"
14 #include "crypto/asn1.h"
15 #include "internal/core.h"
16 #include "internal/provider.h"
17 #include "evp_local.h"
20 * match_type() checks if two EVP_KEYMGMT are matching key types. This
21 * function assumes that the caller has made all the necessary NULL checks.
23 static int match_type(const EVP_KEYMGMT
*keymgmt1
, const EVP_KEYMGMT
*keymgmt2
)
25 const OSSL_PROVIDER
*prov2
= EVP_KEYMGMT_provider(keymgmt2
);
26 const char *name2
= evp_first_name(prov2
, EVP_KEYMGMT_number(keymgmt2
));
28 return EVP_KEYMGMT_is_a(keymgmt1
, name2
);
31 struct import_data_st
{
38 static int try_import(const OSSL_PARAM params
[], void *arg
)
40 struct import_data_st
*data
= arg
;
43 * It's fine if there was no data to transfer, we just end up with an
44 * empty destination key.
46 if (params
[0].key
== NULL
)
49 /* Just in time creation of keydata, if needed */
50 if (data
->keydata
== NULL
51 && (data
->keydata
= evp_keymgmt_newdata(data
->keymgmt
)) == NULL
) {
52 ERR_raise(ERR_LIB_EVP
, ERR_R_MALLOC_FAILURE
);
56 return evp_keymgmt_import(data
->keymgmt
, data
->keydata
, data
->selection
,
60 void *evp_keymgmt_util_export_to_provider(EVP_PKEY
*pk
, EVP_KEYMGMT
*keymgmt
)
62 struct import_data_st import_data
;
65 /* Export to where? */
69 /* If we have an unassigned key, give up */
70 if (pk
->keydata
== NULL
)
73 /* If |keymgmt| matches the "origin" |keymgmt|, no more to do */
74 if (pk
->keymgmt
== keymgmt
)
77 /* If this key is already exported to |keymgmt|, no more to do */
78 i
= evp_keymgmt_util_find_operation_cache_index(pk
, keymgmt
);
79 if (i
< OSSL_NELEM(pk
->operation_cache
)
80 && pk
->operation_cache
[i
].keymgmt
!= NULL
)
81 return pk
->operation_cache
[i
].keydata
;
83 /* If the "origin" |keymgmt| doesn't support exporting, give up */
85 * TODO(3.0) consider an evp_keymgmt_export() return value that indicates
86 * that the method is unsupported.
88 if (pk
->keymgmt
->export
== NULL
)
91 /* Check that we have found an empty slot in the export cache */
93 * TODO(3.0) Right now, we assume we have ample space. We will have to
94 * think about a cache aging scheme, though, if |i| indexes outside the
97 if (!ossl_assert(i
< OSSL_NELEM(pk
->operation_cache
)))
101 * Make sure that the type of the keymgmt to export to matches the type
104 if (!ossl_assert(match_type(pk
->keymgmt
, keymgmt
)))
108 * We look at the already cached provider keys, and import from the
109 * first that supports it (i.e. use its export function), and export
110 * the imported data to the new provider.
113 /* Setup for the export callback */
114 import_data
.keydata
= NULL
; /* try_import will create it */
115 import_data
.keymgmt
= keymgmt
;
116 import_data
.selection
= OSSL_KEYMGMT_SELECT_ALL
;
119 * The export function calls the callback (try_import), which does the
120 * import for us. If successful, we're done.
122 if (!evp_keymgmt_export(pk
->keymgmt
, pk
->keydata
, OSSL_KEYMGMT_SELECT_ALL
,
123 &try_import
, &import_data
)) {
124 /* If there was an error, bail out */
125 evp_keymgmt_freedata(keymgmt
, import_data
.keydata
);
129 /* Add the new export to the operation cache */
130 if (!evp_keymgmt_util_cache_keydata(pk
, i
, keymgmt
, import_data
.keydata
)) {
131 evp_keymgmt_freedata(keymgmt
, import_data
.keydata
);
135 return import_data
.keydata
;
138 void evp_keymgmt_util_clear_operation_cache(EVP_PKEY
*pk
)
140 size_t i
, end
= OSSL_NELEM(pk
->operation_cache
);
143 for (i
= 0; i
< end
&& pk
->operation_cache
[i
].keymgmt
!= NULL
; i
++) {
144 EVP_KEYMGMT
*keymgmt
= pk
->operation_cache
[i
].keymgmt
;
145 void *keydata
= pk
->operation_cache
[i
].keydata
;
147 pk
->operation_cache
[i
].keymgmt
= NULL
;
148 pk
->operation_cache
[i
].keydata
= NULL
;
149 evp_keymgmt_freedata(keymgmt
, keydata
);
150 EVP_KEYMGMT_free(keymgmt
);
155 size_t evp_keymgmt_util_find_operation_cache_index(EVP_PKEY
*pk
,
156 EVP_KEYMGMT
*keymgmt
)
158 size_t i
, end
= OSSL_NELEM(pk
->operation_cache
);
160 for (i
= 0; i
< end
&& pk
->operation_cache
[i
].keymgmt
!= NULL
; i
++) {
161 if (keymgmt
== pk
->operation_cache
[i
].keymgmt
)
168 int evp_keymgmt_util_cache_keydata(EVP_PKEY
*pk
, size_t index
,
169 EVP_KEYMGMT
*keymgmt
, void *keydata
)
171 if (keydata
!= NULL
) {
172 if (!EVP_KEYMGMT_up_ref(keymgmt
))
174 pk
->operation_cache
[index
].keydata
= keydata
;
175 pk
->operation_cache
[index
].keymgmt
= keymgmt
;
180 void evp_keymgmt_util_cache_keyinfo(EVP_PKEY
*pk
)
183 * Cache information about the provider "origin" key.
185 * This services functions like EVP_PKEY_size, EVP_PKEY_bits, etc
187 if (pk
->keydata
!= NULL
) {
189 int security_bits
= 0;
191 OSSL_PARAM params
[4];
193 params
[0] = OSSL_PARAM_construct_int(OSSL_PKEY_PARAM_BITS
, &bits
);
194 params
[1] = OSSL_PARAM_construct_int(OSSL_PKEY_PARAM_SECURITY_BITS
,
196 params
[2] = OSSL_PARAM_construct_int(OSSL_PKEY_PARAM_MAX_SIZE
, &size
);
197 params
[3] = OSSL_PARAM_construct_end();
198 if (evp_keymgmt_get_params(pk
->keymgmt
, pk
->keydata
, params
)) {
199 pk
->cache
.size
= size
;
200 pk
->cache
.bits
= bits
;
201 pk
->cache
.security_bits
= security_bits
;
206 void *evp_keymgmt_util_fromdata(EVP_PKEY
*target
, EVP_KEYMGMT
*keymgmt
,
207 int selection
, const OSSL_PARAM params
[])
209 void *keydata
= NULL
;
211 if ((keydata
= evp_keymgmt_newdata(keymgmt
)) == NULL
212 || !evp_keymgmt_import(keymgmt
, keydata
, selection
, params
)
213 || !EVP_PKEY_set_type_by_keymgmt(target
, keymgmt
)) {
214 evp_keymgmt_freedata(keymgmt
, keydata
);
217 if (keydata
!= NULL
) {
218 target
->keydata
= keydata
;
219 evp_keymgmt_util_cache_keyinfo(target
);
225 int evp_keymgmt_util_has(EVP_PKEY
*pk
, int selection
)
227 /* Check if key is even assigned */
228 if (pk
->keymgmt
== NULL
)
231 return evp_keymgmt_has(pk
->keymgmt
, pk
->keydata
, selection
);
235 * evp_keymgmt_util_match() doesn't just look at the provider side "origin",
236 * but also in the operation cache to see if there's any common keymgmt that
237 * supplies OP_keymgmt_match.
239 * evp_keymgmt_util_match() adheres to the return values that EVP_PKEY_eq()
240 * and EVP_PKEY_parameters_eq() return, i.e.:
244 * -1 not same key type
245 * -2 unsupported operation
247 int evp_keymgmt_util_match(EVP_PKEY
*pk1
, EVP_PKEY
*pk2
, int selection
)
249 EVP_KEYMGMT
*keymgmt1
= NULL
, *keymgmt2
= NULL
;
250 void *keydata1
= NULL
, *keydata2
= NULL
;
252 if (pk1
== NULL
|| pk2
== NULL
) {
253 if (pk1
== NULL
&& pk2
== NULL
)
258 keymgmt1
= pk1
->keymgmt
;
259 keydata1
= pk1
->keydata
;
260 keymgmt2
= pk2
->keymgmt
;
261 keydata2
= pk2
->keydata
;
263 if (keymgmt1
!= keymgmt2
) {
265 * The condition for a successful cross export is that the
266 * keydata to be exported is NULL (typed, but otherwise empty
267 * EVP_PKEY), or that it was possible to export it with
268 * evp_keymgmt_util_export_to_provider().
270 * We use |ok| to determine if it's ok to cross export one way,
271 * but also to determine if we should attempt a cross export
272 * the other way. There's no point doing it both ways.
276 /* Complex case, where the keymgmt differ */
279 && !match_type(keymgmt1
, keymgmt2
)) {
280 ERR_raise(ERR_LIB_EVP
, EVP_R_DIFFERENT_KEY_TYPES
);
281 return -1; /* Not the same type */
285 * The key types are determined to match, so we try cross export,
286 * but only to keymgmt's that supply a matching function.
289 && keymgmt2
->match
!= NULL
) {
290 void *tmp_keydata
= NULL
;
293 if (keydata1
!= NULL
) {
295 evp_keymgmt_util_export_to_provider(pk1
, keymgmt2
);
296 ok
= (tmp_keydata
!= NULL
);
300 keydata1
= tmp_keydata
;
304 * If we've successfully cross exported one way, there's no point
305 * doing it the other way, hence the |!ok| check.
309 && keymgmt1
->match
!= NULL
) {
310 void *tmp_keydata
= NULL
;
313 if (keydata2
!= NULL
) {
315 evp_keymgmt_util_export_to_provider(pk2
, keymgmt1
);
316 ok
= (tmp_keydata
!= NULL
);
320 keydata2
= tmp_keydata
;
325 /* If we still don't have matching keymgmt implementations, we give up */
326 if (keymgmt1
!= keymgmt2
)
329 /* If both keydata are NULL, then they're the same key */
330 if (keydata1
== NULL
&& keydata2
== NULL
)
332 /* If only one of the keydata is NULL, then they're different keys */
333 if (keydata1
== NULL
|| keydata2
== NULL
)
335 /* If both keydata are non-NULL, we let the backend decide */
336 return evp_keymgmt_match(keymgmt1
, keydata1
, keydata2
, selection
);
339 int evp_keymgmt_util_copy(EVP_PKEY
*to
, EVP_PKEY
*from
, int selection
)
341 /* Save copies of pointers we want to play with without affecting |to| */
342 EVP_KEYMGMT
*to_keymgmt
= to
->keymgmt
;
343 void *to_keydata
= to
->keydata
, *alloc_keydata
= NULL
;
345 /* An unassigned key can't be copied */
346 if (from
== NULL
|| from
->keydata
== NULL
)
350 * If |to| is unassigned, ensure it gets the same KEYMGMT as |from|,
351 * Note that the final setting of KEYMGMT is done further down, with
352 * EVP_PKEY_set_type_by_keymgmt(); we don't want to do that prematurely.
354 if (to_keymgmt
== NULL
)
355 to_keymgmt
= from
->keymgmt
;
357 if (to_keymgmt
== from
->keymgmt
&& to_keymgmt
->copy
!= NULL
) {
358 /* Make sure there's somewhere to copy to */
359 if (to_keydata
== NULL
360 && ((to_keydata
= alloc_keydata
= evp_keymgmt_newdata(to_keymgmt
))
362 ERR_raise(ERR_LIB_EVP
, ERR_R_MALLOC_FAILURE
);
367 * |to| and |from| have the same keymgmt, and the copy function is
368 * implemented, so just copy and be done
370 if (!evp_keymgmt_copy(to_keymgmt
, to_keydata
, from
->keydata
,
373 } else if (match_type(to_keymgmt
, from
->keymgmt
)) {
374 struct import_data_st import_data
;
376 import_data
.keymgmt
= to_keymgmt
;
377 import_data
.keydata
= to_keydata
;
378 import_data
.selection
= selection
;
380 if (!evp_keymgmt_export(from
->keymgmt
, from
->keydata
, selection
,
381 &try_import
, &import_data
)) {
382 evp_keymgmt_freedata(to_keymgmt
, alloc_keydata
);
387 * In case to_keydata was previously unallocated, try_import()
388 * may have created it for us.
390 if (to_keydata
== NULL
)
391 to_keydata
= alloc_keydata
= import_data
.keydata
;
393 ERR_raise(ERR_LIB_EVP
, EVP_R_DIFFERENT_KEY_TYPES
);
397 if (to
->keymgmt
== NULL
398 && !EVP_PKEY_set_type_by_keymgmt(to
, to_keymgmt
)) {
399 evp_keymgmt_freedata(to_keymgmt
, alloc_keydata
);
402 to
->keydata
= to_keydata
;
403 evp_keymgmt_util_cache_keyinfo(to
);
408 void *evp_keymgmt_util_gen(EVP_PKEY
*target
, EVP_KEYMGMT
*keymgmt
,
409 void *genctx
, OSSL_CALLBACK
*cb
, void *cbarg
)
411 void *keydata
= NULL
;
413 if ((keydata
= evp_keymgmt_gen(keymgmt
, genctx
, cb
, cbarg
)) == NULL
414 || !EVP_PKEY_set_type_by_keymgmt(target
, keymgmt
)) {
415 evp_keymgmt_freedata(keymgmt
, keydata
);
418 if (keydata
!= NULL
) {
419 target
->keydata
= keydata
;
420 evp_keymgmt_util_cache_keyinfo(target
);
427 * Returns the same numbers as EVP_PKEY_get_default_digest_name()
428 * When the string from the EVP_KEYMGMT implementation is "", we use
429 * SN_undef, since that corresponds to what EVP_PKEY_get_default_nid()
430 * returns for no digest.
432 int evp_keymgmt_util_get_deflt_digest_name(EVP_KEYMGMT
*keymgmt
,
434 char *mdname
, size_t mdname_sz
)
436 OSSL_PARAM params
[3];
437 char mddefault
[100] = "";
438 char mdmandatory
[100] = "";
443 OSSL_PARAM_construct_utf8_string(OSSL_PKEY_PARAM_DEFAULT_DIGEST
,
444 mddefault
, sizeof(mddefault
));
446 OSSL_PARAM_construct_utf8_string(OSSL_PKEY_PARAM_MANDATORY_DIGEST
,
448 sizeof(mdmandatory
));
449 params
[2] = OSSL_PARAM_construct_end();
451 if (!evp_keymgmt_get_params(keymgmt
, keydata
, params
))
454 if (OSSL_PARAM_modified(params
+ 1)) {
455 if (params
[1].return_size
<= 1) /* Only a NUL byte */
458 result
= mdmandatory
;
460 } else if (OSSL_PARAM_modified(params
)) {
461 if (params
[0].return_size
<= 1) /* Only a NUL byte */
468 OPENSSL_strlcpy(mdname
, result
, mdname_sz
);