tlsSocket.renegotiate(options, callback)

版本历史
版本变更
v18.0.0

Passing an invalid callback to the callback argument now throws ERR_INVALID_ARG_TYPE instead of ERR_INVALID_CALLBACK.

v0.11.8

新增于: v0.11.8

  • options <Object>
    • rejectUnauthorized <boolean> 如果不是 false，服务器证书将会根据提供的 CA 列表进行验证。如果验证失败，会触发 'error' 事件；err.code 包含 OpenSSL 错误代码。默认值： true。
    • requestCert
  • callback <Function> 如果 renegotiate() 返回 true，回调会被附加一次到 'secure' 事件上。如果 renegotiate() 返回 false，callback 将在下一个周期被调用并带有一个错误，除非 tlsSocket 已被销毁，在这种情况下 callback 将根本不会被调用。
  • 返回：<boolean> 如果重新协商已启动，则为 true，否则为 false。

tlsSocket.renegotiate() 方法会启动一个 TLS 重新协商过程。完成后，callback 函数将接收一个参数，该参数要么是 Error（如果请求失败），要么是 null。

🌐 The tlsSocket.renegotiate() method initiates a TLS renegotiation process. Upon completion, the callback function will be passed a single argument that is either an Error (if the request failed) or null.

此方法可在建立安全连接后用于请求对端的证书。

🌐 This method can be used to request a peer's certificate after the secure connection has been established.

作为服务器运行时，套接字将在 handshakeTimeout 超时后因错误而被销毁。

🌐 When running as the server, the socket will be destroyed with an error after handshakeTimeout timeout.

对于 TLSv1.3，无法发起重新协商，协议不支持此功能。

🌐 For TLSv1.3, renegotiation cannot be initiated, it is not supported by the protocol.