coroutine loop.
start_tls
(transport, protocol, sslcontext, *, server_side=False, server_hostname=None, ssl_handshake_timeout=None)
loop.
start_tls
(transport, protocol, sslcontext, *, server_side=False, server_hostname=None, ssl_handshake_timeout=None)Upgrade an existing transport-based connection to TLS.
Return a new transport instance, that the protocol must start using immediately after the await. The transport instance passed to the start_tls method should never be used again.
Parameters:
-
transport and protocol instances that methods like
create_server()
andcreate_connection()
return. -
sslcontext: a configured instance of
SSLContext
. -
server_side pass
True
when a server-side connection is being upgraded (like the one created bycreate_server()
). -
server_hostname: sets or overrides the host name that the target server’s certificate will be matched against.
-
ssl_handshake_timeout is (for a TLS connection) the time in seconds to wait for the TLS handshake to complete before aborting the connection.
60.0
seconds ifNone
(default).
New in version 3.7.
Watching file descriptors
Related Reading