xref: /freebsd/crypto/openssl/doc/man7/EVP_KEM-RSA.pod (revision 02e9120893770924227138ba49df1edb3896112a)
1=pod
2
3=head1 NAME
4
5EVP_KEM-RSA
6- EVP_KEM RSA keytype and algorithm support
7
8=head1 DESCRIPTION
9
10The B<RSA> keytype and its parameters are described in L<EVP_PKEY-RSA(7)>.
11See L<EVP_PKEY_encapsulate(3)> and L<EVP_PKEY_decapsulate(3)> for more info.
12
13=head2 RSA KEM parameters
14
15=over 4
16
17=item "operation" (B<OSSL_KEM_PARAM_OPERATION>) <UTF8 string>
18
19The OpenSSL RSA Key Encapsulation Mechanism only currently supports the
20following operation
21
22=over 4
23
24=item "RSASVE"
25
26The encapsulate function simply generates a secret using random bytes and then
27encrypts the secret using the RSA public key (with no padding).
28The decapsulate function recovers the secret using the RSA private key.
29
30=back
31
32This can be set using EVP_PKEY_CTX_set_kem_op().
33
34=back
35
36
37=head1 CONFORMING TO
38
39=over 4
40
41=item SP800-56Br2
42
43Section 7.2.1.2 RSASVE Generate Operation (RSASVE.GENERATE).
44Section 7.2.1.3 RSASVE Recovery Operation (RSASVE.RECOVER).
45
46=back
47
48=head1 SEE ALSO
49
50L<EVP_PKEY_CTX_set_kem_op(3)>,
51L<EVP_PKEY_encapsulate(3)>,
52L<EVP_PKEY_decapsulate(3)>
53L<EVP_KEYMGMT(3)>,
54L<EVP_PKEY(3)>,
55L<provider-keymgmt(7)>
56
57=head1 HISTORY
58
59This functionality was added in OpenSSL 3.0.
60
61=head1 COPYRIGHT
62
63Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
64
65Licensed under the Apache License 2.0 (the "License").  You may not use
66this file except in compliance with the License.  You can obtain a copy
67in the file LICENSE in the source distribution or at
68L<https://www.openssl.org/source/license.html>.
69
70=cut
71