:mod:`ussl` -- SSL/TLS module
=============================

.. module:: ussl
   :synopsis: TLS/SSL wrapper for socket objects

|see_cpython_module| :mod:`python:ssl`.

此模块提供对传输层安全性的访问（以前被广泛称为“Secure Sockets Layer安全套接字层”）加密和对等身份验证
客户端和服务器端网络套接字的功能。

功能
---------

.. function:: ssl.wrap_socket(sock, server_side=False, keyfile=None, certfile=None, cert_reqs=CERT_NONE, ca_certs=None)

   接收流 *sock*（通常是 ``SOCK_STREAM`` 类型的usocket.socket实例），
   并返回ssl.SSLSocket的实例，该实例将底层流包装在SSL上下文中。
   返回的对象具有通常的流接口方法，如 `read()` , `write()` ,等等。
   在MicroPython中，返回的对象不公开socket接口和 `recv()` , `send()` 等方法。
   特别地，应该从非SSL侦听服务器套接字上的 `accept()` 返回的普通套接字创建服务器端SSL套接字。

   根据特定 `MicroPython port` 中的底层模块实现，可能不支持上面的某些或所有关键字参数。

.. warning::

   ``ssl`` 模块的一些实现不验证服务器证书，这使得建立的ssl连接容易受到中间人攻击。

异常
----------

.. data:: ssl.SSLError

   此异常不存在。而是使用它的基类OSError。

常数
---------

.. data:: ssl.CERT_NONE
          ssl.CERT_OPTIONAL
          ssl.CERT_REQUIRED

    *cert_reqs* 参数的支持值。