Blame SOURCES/README.legacy-settings

c05f5d
Guide for legacy support enablement
c05f5d
===================================
c05f5d
c05f5d
To improve security provided by use of OpenSSL especially in context of
c05f5d
TLS connections we regularly review and deprecate algorithms and algorithm
c05f5d
settings which are no longer viewed as secure.
c05f5d
c05f5d
For some of these deprecated algorithms we provide a way for the
c05f5d
system administrator to reenable them.
c05f5d
c05f5d
Deprecated algorithms, protocols and settings in OpenSSL
c05f5d
========================================================
c05f5d
c05f5d
Previous Red Hat Enterprise Linux 7 update releases:
c05f5d
c05f5d
* SSL2 protocol disabled by default.
c05f5d
* Minimum DH group size accepted by SSL/TLS client 768 bits.
c05f5d
* Verification of certificates and signatures using MD5 hash
c05f5d
  disabled.
c05f5d
c05f5d
Red Hat Enterprise Linux 7.4:
c05f5d
c05f5d
* SSL2 protocol support completely disabled (cannot be re-enabled).
c05f5d
* All SSL/TLS export ciphers disabled.
c05f5d
* All SSL/TLS ciphersuites with keys smaller than 128 bits disabled.
c05f5d
* Minimum DH group size accepted by SSL/TLS client 1024 bits.
c05f5d
* Disabled support for verification of certificates and signatures
c05f5d
  using MD2, MD4, MD5, and SHA0 hashes.
c05f5d
c05f5d
Legacy support enablement
c05f5d
=========================
c05f5d
c05f5d
The OpenSSL now supports /etc/pki/tls/legacy-settings configuration file
c05f5d
which can be created by the system administrator which contains lines with
c05f5d
simple Key Value pairs.
c05f5d
c05f5d
The library recognizes the following possible configuration settings in
c05f5d
that file:
c05f5d
c05f5d
LegacySigningMDs md2 md5
c05f5d
MinimumDHBits 512
c05f5d
c05f5d
The LegacySigningMDs option allows reenabling support for verification of
c05f5d
signatures with the specified hash algorithms. These can be any combination
c05f5d
of md2, md4, md5 and sha. (sha represents SHA0 algorithm, not SHA1.) Any
c05f5d
unrecognized algorithms are ignored.
c05f5d
c05f5d
The MinimumDHBits option allows setting of the minimum bit size of DH group
c05f5d
accepted by SSL/TLS client. It can be any value between 512 and 10000.
c05f5d
c05f5d
If the configuration file is not present the built-in defaults (that is the
c05f5d
secure defaults) are used. Any unrecognized lines (with other parameter
c05f5d
names or comments) are ignored.