Changelog¶
Versions are year-based with a strict backward-compatibility policy. The third digit is only for regressions.
23.3.0 (UNRELEASED)¶
Backward-incompatible changes:¶
- Dropped support for Python 3.6.
- The minimum
cryptography
version is now 41.0.0. - Removed
OpenSSL.crypto.loads_pkcs7
andOpenSSL.crypto.loads_pkcs12
which had been deprecated for 3 years. - Added
OpenSSL.SSL.OP_LEGACY_SERVER_CONNECT
to allow legacy insecure renegotiation between OpenSSL and unpatched servers. #1234.
Deprecations:¶
- Deprecated
OpenSSL.crypto.PKCS12
(which was intended to have been deprecated at the same time asOpenSSL.crypto.load_pkcs12
). - Deprecated
OpenSSL.crypto.NetscapeSPKI
. - Deprecated
OpenSSL.crypto.CRL
- Deprecated
OpenSSL.crypto.Revoked
- Deprecated
OpenSSL.crypto.load_crl
andOpenSSL.crypto.dump_crl
Changes:¶
22.1.0 (2022-09-25)¶
Backward-incompatible changes:¶
- Remove support for SSLv2 and SSLv3.
- The minimum
cryptography
version is now 38.0.x (and we now pin releases againstcryptography
major versions to prevent future breakage) - The
OpenSSL.crypto.X509StoreContextError
exception has been refactored, changing its internal attributes. #1133
Deprecations:¶
OpenSSL.SSL.SSLeay_version
is deprecated in favor ofOpenSSL.SSL.OpenSSL_version
. The constantsOpenSSL.SSL.SSLEAY_*
are deprecated in favor ofOpenSSL.SSL.OPENSSL_*
.
Changes:¶
22.0.0 (2022-01-29)¶
Backward-incompatible changes:¶
- Drop support for Python 2.7. #1047
- The minimum
cryptography
version is now 35.0.
Deprecations:¶
21.0.0 (2021-09-28)¶
Backward-incompatible changes:¶
- The minimum
cryptography
version is now 3.3. - Drop support for Python 3.5
Deprecations:¶
Changes:¶
- Raise an error when an invalid ALPN value is set. #993
- Added
OpenSSL.SSL.Context.set_min_proto_version
andOpenSSL.SSL.Context.set_max_proto_version
to set the minimum and maximum supported TLS version #985. - Updated
to_cryptography
andfrom_cryptography
methods to support an upcoming release ofcryptography
without raising deprecation warnings. #1030
20.0.1 (2020-12-15)¶
Backward-incompatible changes:¶
Deprecations:¶
Changes:¶
- Fixed compatibility with OpenSSL 1.1.0.
20.0.0 (2020-11-27)¶
Backward-incompatible changes:¶
- The minimum
cryptography
version is now 3.2. - Remove deprecated
OpenSSL.tsafe
module. - Removed deprecated
OpenSSL.SSL.Context.set_npn_advertise_callback
,OpenSSL.SSL.Context.set_npn_select_callback
, andOpenSSL.SSL.Connection.get_next_proto_negotiated
. - Drop support for Python 3.4
- Drop support for OpenSSL 1.0.1 and 1.0.2
Deprecations:¶
- Deprecated
OpenSSL.crypto.loads_pkcs7
andOpenSSL.crypto.loads_pkcs12
.
Changes:¶
- Added a new optional
chain
parameter toOpenSSL.crypto.X509StoreContext()
where additional untrusted certificates can be specified to help chain building. #948 - Added
OpenSSL.crypto.X509Store.load_locations
to set trusted certificate file bundles and/or directories for verification. #943 - Added
Context.set_keylog_callback
to log key material. #910 - Added
OpenSSL.SSL.Connection.get_verified_chain
to retrieve the verified certificate chain of the peer. #894. - Make verification callback optional in
Context.set_verify
. If omitted, OpenSSL’s default verification is used. #933 - Fixed a bug that could truncate or cause a zero-length key error due to a
null byte in private key passphrase in
OpenSSL.crypto.load_privatekey
andOpenSSL.crypto.dump_privatekey
. #947
19.1.0 (2019-11-18)¶
Backward-incompatible changes:¶
- Removed deprecated
ContextType
,ConnectionType
,PKeyType
,X509NameType
,X509ReqType
,X509Type
,X509StoreType
,CRLType
,PKCS7Type
,PKCS12Type
, andNetscapeSPKIType
aliases. Use the classes without theType
suffix instead. #814 - The minimum
cryptography
version is now 2.8 due to issues on macOS with a transitive dependency. #875
19.0.0 (2019-01-21)¶
Backward-incompatible changes:¶
X509Store.add_cert
no longer raises an error if you add a duplicate cert. #787
Deprecations:¶
none
18.0.0 (2018-05-16)¶
Backward-incompatible changes:¶
- The minimum
cryptography
version is now 2.2.1. - Support for Python 2.6 has been dropped.
Deprecations:¶
none
17.5.0 (2017-11-30)¶
Backward-incompatible changes:¶
- The minimum
cryptography
version is now 2.1.4.
Deprecations:¶
none
17.1.0 (2017-06-30)¶
Backward-incompatible changes:¶
- Removed the deprecated
OpenSSL.rand.egd()
function. Applications should preferos.urandom()
for random number generation. #630 - Removed the deprecated default
digest
argument toOpenSSL.crypto.CRL.export()
. Callers must now always pass an explicitdigest
. #652 - Fixed a bug with
ASN1_TIME
casting inX509.set_notBefore()
,X509.set_notAfter()
,Revoked.set_rev_date()
,Revoked.set_nextUpdate()
, andRevoked.set_lastUpdate()
. You must now pass times in the formYYYYMMDDhhmmssZ
.YYYYMMDDhhmmss+hhmm
andYYYYMMDDhhmmss-hhmm
will no longer work. #612
Deprecations:¶
- Deprecated the legacy “Type” aliases:
ContextType
,ConnectionType
,PKeyType
,X509NameType
,X509ExtensionType
,X509ReqType
,X509Type
,X509StoreType
,CRLType
,PKCS7Type
,PKCS12Type
,NetscapeSPKIType
. The names without the “Type”-suffix should be used instead.
Changes:¶
- Added
OpenSSL.crypto.X509.from_cryptography()
andOpenSSL.crypto.X509.to_cryptography()
for converting X.509 certificate to and from pyca/cryptography objects. #640 - Added
OpenSSL.crypto.X509Req.from_cryptography()
,OpenSSL.crypto.X509Req.to_cryptography()
,OpenSSL.crypto.CRL.from_cryptography()
, andOpenSSL.crypto.CRL.to_cryptography()
for converting X.509 CSRs and CRLs to and from pyca/cryptography objects. #645 - Added
OpenSSL.debug
that allows to get an overview of used library versions (including linked OpenSSL) and other useful runtime information usingpython -m OpenSSL.debug
. #620 - Added a fallback path to
Context.set_default_verify_paths()
to accommodate the upcoming release ofcryptography
manylinux1
wheels. #633
17.0.0 (2017-04-20)¶
Backward-incompatible changes:¶
none
Deprecations:¶
none
Changes:¶
- Added
OpenSSL.X509Store.set_time()
to set a custom verification time when verifying certificate chains. #567 - Added a collection of functions for working with OCSP stapling.
None of these functions make it possible to validate OCSP assertions, only to staple them into the handshake and to retrieve the stapled assertion if provided.
Users will need to write their own code to handle OCSP assertions.
We specifically added:
Context.set_ocsp_server_callback()
,Context.set_ocsp_client_callback()
, andConnection.request_ocsp()
. #580 - Changed the
SSL
module’s memory allocation policy to avoid zeroing memory it allocates when unnecessary. This reduces CPU usage and memory allocation time by an amount proportional to the size of the allocation. For applications that process a lot of TLS data or that use very lage allocations this can provide considerable performance improvements. #578 - Automatically set
SSL_CTX_set_ecdh_auto()
onOpenSSL.SSL.Context
. #575 - Fix empty exceptions from
OpenSSL.crypto.load_privatekey()
. #581
16.1.0 (2016-08-26)¶
Backward-incompatible changes:¶
none
Deprecations:¶
- Dropped support for OpenSSL 0.9.8.
Changes:¶
- Fix memory leak in
OpenSSL.crypto.dump_privatekey()
withFILETYPE_TEXT
. #496 - Enable use of CRL (and more) in verify context. #483
OpenSSL.crypto.PKey
can now be constructed fromcryptography
objects and also exported as such. #439- Support newer versions of
cryptography
which use opaque structs for OpenSSL 1.1.0 compatibility.
16.0.0 (2016-03-19)¶
This is the first release under full stewardship of PyCA. We have made many changes to make local development more pleasing. The test suite now passes both on Linux and OS X with OpenSSL 0.9.8, 1.0.1, and 1.0.2. It has been moved to pytest, all CI test runs are part of tox and the source code has been made fully flake8 compliant.
We hope to have lowered the barrier for contributions significantly but are open to hear about any remaining frustrations.
Backward-incompatible changes:¶
- Python 3.2 support has been dropped.
It never had significant real world usage and has been dropped by our main dependency
cryptography
. Affected users should upgrade to Python 3.3 or later.
Deprecations:¶
The support for EGD has been removed. The only affected function
OpenSSL.rand.egd()
now usesos.urandom()
to seed the internal PRNG instead. Please see pyca/cryptography#1636 for more background information on this decision. In accordance with our backward compatibility policyOpenSSL.rand.egd()
will be removed no sooner than a year from the release of 16.0.0.Please note that you should use urandom for all your secure random number needs.
Python 2.6 support has been deprecated. Our main dependency
cryptography
deprecated 2.6 in version 0.9 (2015-05-14) with no time table for actually dropping it. pyOpenSSL will drop Python 2.6 support oncecryptography
does.
Changes:¶
- Fixed
OpenSSL.SSL.Context.set_session_id
,OpenSSL.SSL.Connection.renegotiate
,OpenSSL.SSL.Connection.renegotiate_pending
, andOpenSSL.SSL.Context.load_client_ca
. They were lacking an implementation since 0.14. #422 - Fixed segmentation fault when using keys larger than 4096-bit to sign data. #428
- Fixed
AttributeError
whenOpenSSL.SSL.Connection.get_app_data()
was called before setting any app data. #304 - Added
OpenSSL.crypto.dump_publickey()
to dumpOpenSSL.crypto.PKey
objects that represent public keys, andOpenSSL.crypto.load_publickey()
to load such objects from serialized representations. #382 - Added
OpenSSL.crypto.dump_crl()
to dump a certificate revocation list out to a string buffer. #368 - Added
OpenSSL.SSL.Connection.get_state_string()
using the OpenSSL bindingstate_string_long
. #358 - Added support for the
socket.MSG_PEEK
flag toOpenSSL.SSL.Connection.recv()
andOpenSSL.SSL.Connection.recv_into()
. #294 - Added
OpenSSL.SSL.Connection.get_protocol_version()
andOpenSSL.SSL.Connection.get_protocol_version_name()
. #244 - Switched to
utf8string
mask by default. OpenSSL formerly defaulted to aT61String
if there were UTF-8 characters present. This was changed to default toUTF8String
in the config around 2005, but the actual code didn’t change it until late last year. This will default us to the setting that actually works. To revert this you can callOpenSSL.crypto._lib.ASN1_STRING_set_default_mask_asc(b"default")
. #234
Older Changelog Entries¶
The changes from before release 16.0.0 are preserved in the repository.