ssl

ssl 模块提供 SSL 上下文来包装套接字。

在这些板上可用
  • ATMegaZero ESP32-S2
  • Adafruit FunHouse
  • Adafruit MagTag
  • Adafruit Metro ESP32S2
  • Artisense Reference Design RD00
  • BastWiFi
  • CrumpS2
  • ESP 12k NodeMCU
  • Feather ESP32S2 without PSRAM
  • FeatherS2
  • FeatherS2 Neo
  • FeatherS2 PreRelease
  • Franzininho WIFI w/Wroom
  • Franzininho WIFI w/Wrover
  • Gravitech Cucumber M
  • Gravitech Cucumber MS
  • Gravitech Cucumber R
  • Gravitech Cucumber RS
  • HMI-DevKit-1.1
  • Kaluga 1
  • LILYGO TTGO T8 ESP32-S2 w/Display
  • MORPHEANS MorphESP-240
  • Oak Dev Tech PixelWing ESP32S2
  • S2Mini
  • Saola 1 w/Wroom
  • Saola 1 w/Wrover
  • Targett Module Clip w/Wroom
  • Targett Module Clip w/Wrover
  • TinyS2
  • microS2
  • nanoESP32-S2 w/Wrover
  • nanoESP32-S2 w/Wroom

ssl.create_default_context()SSLContext

返回默认的 SSLContext。

class ssl.SSLContext

与 SSL 相关的设置,可以通过包装将其应用于套接字。这对于向特定连接而不是所有连接提供 SSL 证书很有用。

ssl.wrap_socket(sock: socketpool.Socket, *, server_side: bool = False, server_hostname: Optional[str] = None)SSLSocket

将套接字包装到处理 SSL 协商的套接字兼容类中。套接字必须是 SOCK_STREAM 类型。

class ssl.SSLSocket

socketpool.Socket函数子集上实现 TLS 安全性。不能直接创建。相反,调用 wrap_socket 现有的套接字对象。

提供 CPython 的 ssl.SSLSocket API 的一个子集。它只实现不分配字节对象的 recv 版本。

__enter__(self)SSLSocket

上下文管理器使用的无操作。

__exit__(self)None

退出上下文时自动关闭 Socket。有关更多信息,请参阅 Lifetime 和 ContextManagers

accept(self)Tuple[SSLSocket, Tuple[str, int]]

接受 SOCK_STREAM 类型的侦听套接字上的连接,创建 SOCK_STREAM 类型的新套接字。返回 (new_socket, remote_address) 的元组

bind(self, address: Tuple[str, int])None

将套接字绑定到地址

参数

address (~tuple) – (remote_address, remote_port) 的元组

close(self)None

关闭这个套接字

connect(self, address: Tuple[str, int])None

将套接字连接到远程地址

参数

address (~tuple) – (remote_address, remote_port) 的元组

listen(self, backlog: int)None

设置套接字以侦听传入连接

参数

backlog (~int) – 等待连接的 backlog 队列长度

recv_into(self, buffer: _typing.WriteableBuffer, bufsize: int)int

从连接的远程地址读取一些字节,写入提供的缓冲区。如果给定 bufsize <= len(buffer),则最多将 bufsize 字节读入缓冲区。如果没有为 bufsize 提供有效值,则默认值为给定缓冲区的长度。

适合 SOCK_STREAM 类型的套接字返回读取的字节数的 int。

参数
  • buffer (bytearray) – 要接收的缓冲区

  • bufsize (int) – 可选,要读取的最大字节数。

send(self, bytes: _typing.ReadableBuffer)int

向连接的远程地址发送一些字节。适合 SOCK_STREAM 类型的套接字

参数

bytes (~bytes) – 要发送的一些字节

settimeout(self, value: int)None

设置此套接字的超时值。

参数

value (~int) – 以秒为单位的超时时间。0 表示非阻塞。None 表示无限期阻止。

setblocking(self, flag: bool)Optional[int]

设置此套接字的阻塞行为。

参数

flag (~bool) – False 表示非阻塞,True 表示无限期阻塞。

__hash__(self)int

返回 Socket 的哈希值。