renegotiate
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.
Since
v0.11.8
Return
true
if renegotiation was initiated, false
otherwise.
Parameters
If renegotiate()
returned true
, callback is attached once to the 'secure'
event. If renegotiate()
returned false
, callback
will be called in the next tick with an error, unless the tlsSocket
has been destroyed, in which case callback
will not be called at all.