]> granicus.if.org Git - python/commit
bpo-32951: Disable SSLSocket/SSLObject constructor (#5864)
authorChristian Heimes <christian@python.org>
Tue, 27 Feb 2018 09:17:30 +0000 (10:17 +0100)
committerGitHub <noreply@github.com>
Tue, 27 Feb 2018 09:17:30 +0000 (10:17 +0100)
commit9d50ab563df6307cabbcc9883cb8c52c614b0f22
treec3e294b7e97d43152f87b00255ff5b875635448b
parent90f05a527c7d439f1d0cba80f2eb32e60ee20fc3
bpo-32951: Disable SSLSocket/SSLObject constructor (#5864)

Direct instantiation of SSLSocket and SSLObject objects is now prohibited.
The constructors were never documented, tested, or designed as public
constructors. The SSLSocket constructor had limitations. For example it was
not possible to enabled hostname verification except was
ssl_version=PROTOCOL_TLS_CLIENT with cert_reqs=CERT_REQUIRED.

SSLContext.wrap_socket() and SSLContext.wrap_bio are the recommended API
to construct SSLSocket and SSLObject instances. ssl.wrap_socket() is
also deprecated.

The only test case for direct instantiation was added a couple of days
ago for IDNA testing.

Signed-off-by: Christian Heimes <christian@python.org>
Doc/library/ssl.rst
Doc/whatsnew/3.7.rst
Lib/ssl.py
Lib/test/test_ssl.py
Misc/NEWS.d/next/Library/2018-02-25-18-22-01.bpo-32951.gHrCXq.rst [new file with mode: 0644]