openssl/doc/man7
Todd Short 37933acbea Add SSL/SSL_CTX_use_cert_and_key()
Add functions that will do the work of assigning certificate, privatekey
and chain certs to an SSL or SSL_CTX. If no privatekey is given, use the
publickey. This will permit the keys to pass validation for both ECDSA
and RSA. If a private key has already been set for the certificate, it
is discarded. A real private key can be set later.

This is an all-or-nothing setting of these parameters. Unlike the
SSL/SSL_CTX_use_certificate() and SSL/SSL_CTX_use_PrivateKey() functions,
the existing cert or privatekey is not modified (i.e. parameters copied).
This permits the existing cert/privatekey to be replaced.

It replaces the sequence of:
* SSL_use_certificate()
* SSL_use_privatekey()
* SSL_set1_chain()
And may actually be faster, as multiple checks are consolidated.

The private key can be NULL, if so an ENGINE module needs to contain the
actual private key that is to be used.

Note that ECDH (using the certificate's ECDSA key) ciphers do not work
without the private key being present, based on how the private key is
used in ECDH. ECDH does not offer PFS; ECDHE ciphers should be used instead.

Reviewed-by: Tim Hudson <tjh@openssl.org>
Reviewed-by: Ben Kaduk <kaduk@mit.edu>
(Merged from https://github.com/openssl/openssl/pull/1130)
2018-03-09 10:28:04 -06:00
..
bio.pod Fix minor typo in bio.pod 2017-12-12 12:31:12 -05:00
crypto.pod Fix referenses in section 7 manuals 2016-11-11 13:06:43 +01:00
ct.pod Fix many doc L<> errors 2017-03-11 08:56:44 -05:00
des_modes.pod Use 'over 2' for bullet lists. 2017-04-07 13:48:19 -04:00
Ed25519.pod Update some documentation for X448/Ed448 2018-03-02 10:14:31 +00:00
evp.pod Update copyright years on all files merged since Jan 1st 2018 2018-01-09 05:49:01 +01:00
ossl_store.pod STORE: Add documentation on search criteria 2018-02-23 07:40:42 +01:00
RSA-PSS.pod Fix spelling errors in manpages 2017-06-11 16:21:33 -04:00
scrypt.pod Add documentation for the scrypt PKEY_METHOD 2017-08-08 15:47:22 +01:00
ssl.pod Add SSL/SSL_CTX_use_cert_and_key() 2018-03-09 10:28:04 -06:00
x509.pod Suggestion for improvements to x509.pod 2017-12-25 21:11:53 -06:00
X25519.pod Update some documentation for X448/Ed448 2018-03-02 10:14:31 +00:00