doc/man7/EVP_KEM-RSA.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 EVP_KEM-RSA
   6 - EVP_KEM RSA keytype and algorithm support
   7
   8 =head1 DESCRIPTION
   9
  10 The B<RSA> keytype and its parameters are described in L<EVP_PKEY-RSA(7)>.
  11 See 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
  19 The OpenSSL RSA Key Encapsulation Mechanism only currently supports the
  20 following operation
  21
  22 =over 4
  23
  24 =item "RSASVE"
  25
  26 The encapsulate function simply generates a secret using random bytes and then
  27 encrypts the secret using the RSA public key (with no padding).
  28 The decapsulate function recovers the secret using the RSA private key.
  29
  30 =back
  31
  32 This 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
  43 Section 7.2.1.2 RSASVE Generate Operation (RSASVE.GENERATE).
  44 Section 7.2.1.3 RSASVE Recovery Operation (RSASVE.RECOVER).
  45
  46 =back
  47
  48 =head1 SEE ALSO
  49
  50 L<EVP_PKEY_CTX_set_kem_op(3)>,
  51 L<EVP_PKEY_encapsulate(3)>,
  52 L<EVP_PKEY_decapsulate(3)>
  53 L<EVP_KEYMGMT(3)>,
  54 L<EVP_PKEY(3)>,
  55 L<provider-keymgmt(7)>
  56
  57 =head1 HISTORY
  58
  59 This functionality was added in OpenSSL 3.0.
  60
  61 =head1 COPYRIGHT
  62
  63 Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
  64
  65 Licensed under the Apache License 2.0 (the "License").  You may not use
  66 this file except in compliance with the License.  You can obtain a copy
  67 in the file LICENSE in the source distribution or at
  68 L<https://www.openssl.org/source/license.html>.
  69
  70 =cut