Skip to content

Deprecate the SecureTransport TLS implementation #2681

@sethmlarson

Description

@sethmlarson

The SecureTransport implementation was added to support OpenSSL versions that didn't support TLS 1.2 and later on macOS. Python on macOS has been improved greatly over time that we're now in a place to force OpenSSL 1.1.1+ in Python and urllib3.

Now that there's little upside to using SecureTransport it's hard to justify the maintenance burden.

My proposal for now is:

  • Create documentation for SecureTransport's deprecation in the docs. We'll be targetting a "future 2.x release" with the actual removal.
  • Begin unconditionally emitting a DeprecationWarning when urllib3.contrib.securetransport.inject_into_urllib3 is called and point to the documentation.
  • Find projects using urllib3.contrib.securetransport and help them remove support.

In a future 2.x version:

  • Make the inject_into_urllib3 function raise an exception with a URL to the documentation.

In a version after that:

  • Remove the inject_into_urllib3 function and urllib3.contrib.securetransport contrib module.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions