Node.js new Agent([options])用法及代碼示例

new Agent([options])

參數

• options <Object>要在代理上設置的一組可配置選項。可以具有與 for 相同的字段new Agent([options])， 和

  • maxCachedSessions <number> TLS 緩存會話的最大數量。使用 0 禁用 TLS 會話緩存。 默認： 100 。

  • servername <string> Server Name Indication extension 的值要發送到服務器。使用空字符串'' 禁用發送擴展。 默認： 目標服務器的主機名，除非使用 IP 地址指定目標服務器，在這種情況下默認為 ''(無擴展名)。

    有關 TLS 會話重用的信息，請參閱 Session Resumption 。

事件：'keylog'#

• line <Buffer> ASCII 文本行，NSS SSLKEYLOGFILE 格式。
• tlsSocket <tls.TLSSocket> 生成它的 tls.TLSSocket 實例。

keylog 事件在此代理管理的連接生成或接收 key 材料時發出(通常在握手完成之前，但不一定)。可以存儲此 key 材料以進行調試，因為它允許對捕獲的 TLS 流量進行解密。它可能會為每個套接字發出多次。

一個典型的用例是將接收到的行附加到一個通用文本文件中，稍後軟件(例如 Wireshark)使用該文件來解密流量：

// ...
https.globalAgent.on('keylog', (line, tlsSocket) => {
  fs.appendFileSync('/tmp/ssl-keys.log', line, { mode: 0o600 });
});