Skip to content

Commit

Permalink
Add thread-safety clarifications to the SSLContext documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
mm-matthias committed Jun 3, 2024
1 parent 0594a27 commit 0948651
Showing 1 changed file with 13 additions and 0 deletions.
13 changes: 13 additions & 0 deletions Doc/library/ssl.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1472,6 +1472,19 @@ to speed up repeated connections from the same clients.
:data:`PROTOCOL_TLS`, :data:`PROTOCOL_TLS_CLIENT`, and
:data:`PROTOCOL_TLS_SERVER` use TLS 1.2 as minimum TLS version.

.. note::

:class:`SSLContext` only supports limited mutation once it has been used
by a connection. Adding new certificates to the internal trust store is
allowed, but changing ciphers, verification settings, or mTLS
certificates may result in surprising behavior.

.. note::

:class:`SSLContext` is designed to be shared and used by multiple
connections.
Thus, it is thread-safe as long as it is not reconfigured after being
used by a connection.

:class:`SSLContext` objects have the following methods and attributes:

Expand Down

0 comments on commit 0948651

Please sign in to comment.