Home | History | Annotate | Line # | Download | only in man7 
      1 =pod
      2 
      3 =head1 NAME
      4 
      5 EVP_KEYEXCH-X25519,
      6 EVP_KEYEXCH-X448
      7 - X25519 and X448 Key Exchange algorithm support
      8 
      9 =head1 DESCRIPTION
     10 
     11 Key exchange support for the B<X25519> and B<X448> key types.
     12 
     13 =head2 Key exchange parameters
     14 
     15 =over 4
     16 
     17 =item "pad" (B<OSSL_EXCHANGE_PARAM_PAD>) <unsigned integer>
     18 
     19 =item "fips-indicator" (B<OSSL_EXCHANGE_PARAM_FIPS_APPROVED_INDICATOR>) <integer>
     20 
     21 B<X25519> and B<X448> are not FIPS approved in FIPS 140-3.
     22 So this getter will return 0.
     23 
     24 See L<provider-keyexch(7)/Common Key Exchange parameters>.
     25 
     26 =back
     27 
     28 =head1 EXAMPLES
     29 
     30 Keys for the host and peer can be generated as shown in
     31 L<EVP_PKEY-X25519(7)/Examples>.
     32 
     33 The code to generate a shared secret is identical to
     34 L<EVP_KEYEXCH-DH(7)/Examples>.
     35 
     36 =head1 SEE ALSO
     37 
     38 L<EVP_PKEY-FFC(7)>,
     39 L<EVP_PKEY-DH(7)>
     40 L<EVP_PKEY(3)>,
     41 L<provider-keyexch(7)>,
     42 L<provider-keymgmt(7)>,
     43 L<OSSL_PROVIDER-default(7)>,
     44 L<OSSL_PROVIDER-FIPS(7)>,
     45 
     46 =head1 COPYRIGHT
     47 
     48 Copyright 2020-2024 The OpenSSL Project Authors. All Rights Reserved.
     49 
     50 Licensed under the Apache License 2.0 (the "License").  You may not use
     51 this file except in compliance with the License.  You can obtain a copy
     52 in the file LICENSE in the source distribution or at
     53 L<https://www.openssl.org/source/license.html>.
     54 
     55 =cut
     56