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 });
});