tlsSocket.renegotiate(options, callback)
-
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。
此方法可用于在建立安全连接后请求对等方的证书。
当作为服务器运行时,套接字将在 handshakeTimeout 超时后销毁并出现错误。
对于 TLSv1.3,无法发起重协商,协议不支持。
-
options<Object>rejectUnauthorized<boolean> If notfalse, the server certificate is verified against the list of supplied CAs. An'error'event is emitted if verification fails;err.codecontains the OpenSSL error code. Default:true.requestCert
-
callback<Function> Ifrenegotiate()returnedtrue, callback is attached once to the'secure'event. Ifrenegotiate()returnedfalse,callbackwill be called in the next tick with an error, unless thetlsSockethas been destroyed, in which casecallbackwill not be called at all. -
Returns: <boolean>
trueif renegotiation was initiated,falseotherwise.
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.
When running as the server, the socket will be destroyed with an error after
handshakeTimeout timeout.
For TLSv1.3, renegotiation cannot be initiated, it is not supported by the protocol.