2017-04-16 07:41:32 +01:00
|
|
|
:mod:`ussl` -- SSL/TLS module
|
|
|
|
=============================
|
2015-10-20 14:04:55 +01:00
|
|
|
|
|
|
|
.. module:: ussl
|
|
|
|
:synopsis: TLS/SSL wrapper for socket objects
|
|
|
|
|
2017-07-02 13:37:31 +01:00
|
|
|
|see_cpython_module| :mod:`python:ssl`.
|
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
This module provides access to Transport Layer Security (previously and
|
|
|
|
widely known as “Secure Sockets Layer”) encryption and peer authentication
|
|
|
|
facilities for network sockets, both client-side and server-side.
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
Functions
|
|
|
|
---------
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
.. function:: ssl.wrap_socket(sock, server_side=False, keyfile=None, certfile=None, cert_reqs=CERT_NONE, ca_certs=None)
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-06-29 22:34:52 +01:00
|
|
|
Takes a stream *sock* (usually usocket.socket instance of ``SOCK_STREAM`` type),
|
2017-04-16 07:41:32 +01:00
|
|
|
and returns an instance of ssl.SSLSocket, which wraps the underlying stream in
|
|
|
|
an SSL context. Returned object has the usual stream interface methods like
|
|
|
|
`read()`, `write()`, etc. In MicroPython, the returned object does not expose
|
|
|
|
socket interface and methods like `recv()`, `send()`. In particular, a
|
|
|
|
server-side SSL socket should be created from a normal socket returned from
|
|
|
|
`accept()` on a non-SSL listening server socket.
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
Depending on the underlying module implementation for a particular board,
|
|
|
|
some or all keyword arguments above may be not supported.
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
.. warning::
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
Some implementations of ``ssl`` module do NOT validate server certificates,
|
|
|
|
which makes an SSL connection established prone to man-in-the-middle attacks.
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
Exceptions
|
|
|
|
----------
|
2015-10-20 15:24:25 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
.. data:: ssl.SSLError
|
2015-10-20 15:24:25 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
This exception does NOT exist. Instead its base class, OSError, is used.
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
Constants
|
|
|
|
---------
|
2015-10-20 14:04:55 +01:00
|
|
|
|
2017-04-16 07:41:32 +01:00
|
|
|
.. data:: ssl.CERT_NONE
|
|
|
|
ssl.CERT_OPTIONAL
|
|
|
|
ssl.CERT_REQUIRED
|
2015-10-21 21:52:36 +01:00
|
|
|
|
2017-06-29 22:34:52 +01:00
|
|
|
Supported values for *cert_reqs* parameter.
|