mirror of
https://github.com/openssl/openssl.git
synced 2024-12-27 06:21:43 +08:00
96ebe52e89
Currently only RSA, EC and ECX are supported (DH and DSA need to be added to the keygen PR's seperately because the fields supported have changed significantly). The API's require the keys to be provider based. Made the keymanagement export and get_params functions share the same code by supplying support functions that work for both a OSSL_PARAM_BLD as well as a OSSL_PARAM[]. This approach means that complex code is not required to build an empty OSSL_PARAM[] with the correct sized fields before then doing a second pass to populate the array. The RSA factor arrays have been changed to use unique key names to simplify the interface needed by the user. Reviewed-by: Richard Levitte <levitte@openssl.org> (Merged from https://github.com/openssl/openssl/pull/11365)
72 lines
2.4 KiB
Plaintext
72 lines
2.4 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
EVP_PKEY_param_fromdata_init, EVP_PKEY_key_fromdata_init, EVP_PKEY_fromdata,
|
|
EVP_PKEY_param_fromdata_settable, EVP_PKEY_key_fromdata_settable
|
|
- functions to create key parameters and keys from user data
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/evp.h>
|
|
|
|
int EVP_PKEY_param_fromdata_init(EVP_PKEY_CTX *ctx);
|
|
int EVP_PKEY_key_fromdata_init(EVP_PKEY_CTX *ctx);
|
|
int EVP_PKEY_fromdata(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey, OSSL_PARAM params[]);
|
|
const OSSL_PARAM *EVP_PKEY_param_fromdata_settable(EVP_PKEY_CTX *ctx);
|
|
const OSSL_PARAM *EVP_PKEY_key_fromdata_settable(EVP_PKEY_CTX *ctx);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
EVP_PKEY_param_fromdata_init() initializes a public key algorithm context
|
|
for creating key parameters from user data.
|
|
|
|
EVP_PKEY_key_fromdata_init() initializes a public key algorithm context for
|
|
creating a key from user data.
|
|
|
|
EVP_PKEY_fromdata() creates key parameters or a key, given data from
|
|
I<params> and a context that's been initialized with
|
|
EVP_PKEY_param_fromdata_init() or EVP_PKEY_key_fromdata_init(). The result is
|
|
written to I<*ppkey>. The parameters that can be used for various types of key
|
|
are as described in the "Built-in RSA Import/Export Types" section on the
|
|
L<provider-keymgmt(7)> page.
|
|
|
|
EVP_PKEY_param_fromdata_settable() and EVP_PKEY_key_fromdata_settable()
|
|
get a constant B<OSSL_PARAM> array that describes the settable parameters
|
|
that can be used with EVP_PKEY_fromdata().
|
|
See L<OSSL_PARAM(3)> for the use of B<OSSL_PARAM> as parameter descriptor.
|
|
|
|
=head1 NOTES
|
|
|
|
These functions only work with key management methods coming from a
|
|
provider.
|
|
|
|
=for comment We may choose to make this available for legacy methods too...
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
EVP_PKEY_key_fromdata_init(), EVP_PKEY_param_fromdata_init() and
|
|
EVP_PKEY_fromdata() return 1 for success and 0 or a negative value for
|
|
failure. In particular a return value of -2 indicates the operation is
|
|
not supported by the public key algorithm.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<EVP_PKEY_CTX_new(3)>, L<provider(7)>, L<EVP_PKEY_gettable_params(3)>
|
|
|
|
=head1 HISTORY
|
|
|
|
These functions were added in OpenSSL 3.0.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2019 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
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
=cut
|
|
|