ussl – SSL/TLS Protocol

ussl realizes the encrypted communication using TLS/SSL protocol, mainly for unidirectional and bidirectional authentication.

Create Secure Channel over SSL

ussl.wrap_socket

ussl.wrap_socket(sock,server_hostname=None,cert=None,key=None)

Parameter

• sock – The usocket.socket object to be wrapped. Required parameter.

• server_hostname – String type. Server IP address. Optional parameter.

• cert – String type. Digital certificate. Optional parameter.

• key – String type. Private key. Optional parameter.

Return Value

A wrapped usocket.socket object.

Example

# Import ussl
# -*- coding: UTF-8 -*-
import ussl
import usocket
import log
import utime
import checkNet

'''
The following two global variables are required. You can modify the values of the following two global variables according to your actual projects.
'''
PROJECT_NAME = "QuecPython_Socket_example"
PROJECT_VERSION = "1.0.0"

checknet = checkNet.CheckNetwork(PROJECT_NAME, PROJECT_VERSION)

# Set the log output level.
log.basicConfig(level=log.INFO)
socket_log = log.getLogger("SOCKET")

if __name__ == '__main__':
    stagecode, subcode = checknet.wait_network_connected(30)
    if stagecode == 3 and subcode == 1:
        socket_log.info('Network connection successful!')
        # 1. Unidirectional-authentication description
        # Create a socket instance.
        sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)
        # Resolve a domain name.
        sockaddr=usocket.getaddrinfo('myssl.com', 443)[0][-1]
        # Set up a connection.
        sock.connect(sockaddr)
        # Create Secure Channel over SSL, supported by the server.
        sock = ussl.wrap_socket(sock, server_hostname="myssl.com")
        # Send messages to the server.
        ret = sock.write('GET / HTTP/1.0\r\nHost: myssl.com\r\nAccept-Encoding: deflate\r\n\r\n')
        socket_log.info('write %d bytes' % ret)
        # Receive the messages from the server.
        data=sock.read(256)
        socket_log.info('read %s bytes:' % len(data))
        socket_log.info(data.decode())

        # Close the connection.
        sock.close()
        socket_log.info('--------------------Socket Ussl End-------------------')
    else:
        socket_log.info('Network connection failed! stagecode = {}, subcode = {}'.format(stagecode, subcode))

# 2. Bidirectional-authentication description
cert = "Certificate"
key = "Private Key"
sock = ussl.wrap_socket(sock, server_hostname="myssl.com", cert=cert, key=key)

List of Supported Cipher Suites