From 20ab1ffe59c89287f8cc16afb9f99b0c1a5a4bba Mon Sep 17 00:00:00 2001 From: Zeyad <81588100+Corencas@users.noreply.github.com> Date: Sun, 15 Nov 2026 23:07:20 -0600 Subject: [PATCH] gh-152709: Document that PROTOCOL_SSLv3 and PROTOCOL_TLSv1* are not available with OpenSSL 4.0+ --- Doc/library/ssl.rst | 30 +++++++++++++++++++++++------- Lib/ssl.py | 4 +++- 2 files changed, 26 insertions(+), 8 deletions(-) diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 868ef0667597435..449839e6b2c66a4 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -684,7 +684,7 @@ Constants Selects SSL version 3 as the channel encryption protocol. This protocol is not available if OpenSSL is compiled with the - ``no-ssl3`` option. + ``no-ssl3`` option, or if Python is built with OpenSSL 4.0 or later. .. warning:: @@ -702,31 +702,47 @@ Constants Selects TLS version 1.0 as the channel encryption protocol. + This constant is not available if Python is built with + OpenSSL 4.0 or later. + .. deprecated:: 3.6 - OpenSSL has deprecated all version specific protocols. + OpenSSL has deprecated all version specific protocols. Use the default + protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` + with :attr:`SSLContext.minimum_version` and + :attr:`SSLContext.maximum_version` instead. .. data:: PROTOCOL_TLSv1_1 Selects TLS version 1.1 as the channel encryption protocol. - Available only with openssl version 1.0.1+. + + This constant is not available if Python is built with + OpenSSL 4.0 or later. .. versionadded:: 3.4 .. deprecated:: 3.6 - OpenSSL has deprecated all version specific protocols. + OpenSSL has deprecated all version specific protocols. Use the default + protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` + with :attr:`SSLContext.minimum_version` and + :attr:`SSLContext.maximum_version` instead. .. data:: PROTOCOL_TLSv1_2 Selects TLS version 1.2 as the channel encryption protocol. - Available only with openssl version 1.0.1+. + + This constant is not available if Python is built with + OpenSSL 4.0 or later. .. versionadded:: 3.4 .. deprecated:: 3.6 - OpenSSL has deprecated all version specific protocols. + OpenSSL has deprecated all version specific protocols. Use the default + protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` + with :attr:`SSLContext.minimum_version` and + :attr:`SSLContext.maximum_version` instead. .. data:: OP_ALL @@ -2365,7 +2381,7 @@ to speed up repeated connections from the same clients. import socket, ssl - context = ssl.SSLContext(ssl.PROTOCOL_TLSv1_2) + context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT) context.verify_mode = ssl.CERT_REQUIRED context.check_hostname = True context.load_default_certs() diff --git a/Lib/ssl.py b/Lib/ssl.py index 49eec9cde0b6317..81422f32077298c 100644 --- a/Lib/ssl.py +++ b/Lib/ssl.py @@ -52,7 +52,6 @@ The following constants identify various SSL protocol variants: -PROTOCOL_SSLv2 PROTOCOL_SSLv3 PROTOCOL_SSLv23 PROTOCOL_TLS @@ -62,6 +61,9 @@ PROTOCOL_TLSv1_1 PROTOCOL_TLSv1_2 +PROTOCOL_SSLv3, PROTOCOL_TLSv1, PROTOCOL_TLSv1_1 and PROTOCOL_TLSv1_2 are +deprecated, and are not available if Python is built with OpenSSL 4.0 or later. + The following constants identify various SSL alert message descriptions as per http://www.iana.org/assignments/tls-parameters/tls-parameters.xml#tls-parameters-6