The version() method of SSLSocket class from the Python ssl module

The version() method when called on an SSLSocket instance which is in an already established connection with a remote host, returns the version string of the SSL Protocol.

Sslsocket Updated 13 Mar 2020 1 min read

Method Name

SSLSocket.version

Method Signature

SSLSocket.version()

Parameters

None

Return Value

The version of the SSL protocol obtained during the SSL handshake. The value is from the set of protocol values {"SSLv2", "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2", "TLSv1.3"}

Overview

  • When an SSL connection is established between two machines in the network, several parameters are established like
    • Protocol version
    • Cipher Suite
    • Compression Method

which will be used for the communication.

  • The method SSLSocket.version() returns the version of the SSL protocol to be used in the communication between two SSL sockets.

Example

python
# Example Python program that prints the SSL

            # protocol version used on an established SSL connection

import ssl

            import socket

            import os

            import platform

# Create an SSL context

            context = ssl.create_default_context()

            context.verify_mode     = ssl.CERT_REQUIRED

            context.check_hostname  = True

            context.load_default_certs()

            # Check for OS X platform

            if platform.system().lower() == 'darwin':

                import certifi

                context.load_verify_locations(

                    cafile=os.path.relpath(certifi.where()),

                    capath=None,

                    cadata=None)

# Create a streaming socket

            con = socket.socket(socket.AF_INET, socket.SOCK_STREAM)

# Create a secure socket

            secure_con          = context.wrap_socket(con, server_hostname="example.org")

            protocol_version    = secure_con.version()

print("The SSL protocol version before calling SSLSocket.connect() is:")

            print(protocol_version)

# Connect to host

            secure_con.connect(("example.org", 443))

            # Find the SSL protocol version obtained after SSL handshake

            protocol_version = secure_con.version()

            print("The SSL protocol version after calling SSLSocket.connect() is:")

            print(protocol_version)

Output

Output
The SSL protocol version before calling SSLSocket.connect() is:

            None

            The SSL protocol version after calling SSLSocket.connect() is:

            TLSv1.3