TLS (SSL)

稳定度: 2 - 稳定

通过require('tls')来使用这个模块。

tls模块使用OpenSSL来提供传输层的安全 和/或 安全socket层:已加密的流通信。

TLS/SSL是一种公/私钥架构。每个客户端和每个服务器都必须有一个私钥。一个私钥通过像如下的方式创建:

openssl genrsa -out ryans-key.pem 2048

所有的服务器和部分的客户端需要一个证书。证书是被CA签名或自签名的公钥。获取一个证书第一步是创建一个“证书签署请求(Certificate Signing Request)”(CSR)文件。通过:

openssl req -new -sha256 -key ryans-key.pem -out ryans-csr.pem

要通过CSR创建一个自签名证书,通过:

openssl x509 -req -in ryans-csr.pem -signkey ryans-key.pem -out ryans-cert.pem

另外,你也可以把CSR交给一个CA请求签名。

为了完全向前保密(PFS),需要产生一个 迪菲-赫尔曼 参数:

openssl dhparam -outform PEM -out dhparam.pem 2048

创建.pfx.p12,通过:

openssl pkcs12 -export -in agent5-cert.pem -inkey agent5-key.pem \
    -certfile ca-cert.pem -out agent5.pfx
  • in: 证书
  • inkey: 私钥
  • certfile: 将所有CA certs串联在一个文件中,就像cat ca1-cert.pem ca2-cert.pem > ca-cert.pem

客户端发起的重新协商攻击的减缓

TLS协议让客户端可以重新协商某些部分的TLS会话。不幸的是,会话重协商需要不相称的服务器端资源,这它可能成为潜在的DOS攻击。

为了减缓这种情况,重新协商被限制在了每10分钟最多3次。当超过阀值时,tls.TLSSocket会触发一个错误。阀值是可以调整的:

  • tls.CLIENT_RENEG_LIMIT: 重新协商限制,默认为3

  • tls.CLIENT_RENEG_WINDOW: 重新协商窗口(秒),默认为10分钟。

除非你知道你在做什么,否则不要改变默认值。

为了测试你的服务器,使用openssl s_client -connect address:port来连接它,然后键入R<CR>(字母R加回车)多次。

NPN 和 SNI

NPN(下个协议协商)和SNI(服务器名称指示)都是TLS握手拓展,它们允许你:

  • NPN - 通过多个协议(HTTP,SPDY)使用一个TLS服务器。
  • SNI - 通过多个有不同的SSL证书的主机名来使用一个TLS服务器。

完全向前保密

术语“向前保密”或“完全向前保密”描述了一个密钥-协商(如密钥-交换)方法的特性。事实上,它意味着,甚至是当(你的)服务器的私钥被窃取了,窃取者也只能在他成功获得所有会话产生的密钥对时,才能解码信息。

它通过在每次握手中(而不是所有的会话都是同样的密钥)随机地产生用于密钥-协商的密钥对来实现。实现了这个技术的方法被称作“ephemeral”。

目前有两种普遍的方法来实现完全向前保密:

  • DHE - 一个 迪菲-赫尔曼 密钥-协商 协议的ephemeral版本。
  • ECDHE - 一个椭圆曲线 迪菲-赫尔曼 密钥-协商 协议的ephemeral版本。

ephemeral方法可能有一些性能问题,因为密钥的生成是昂贵的。

tls.getCiphers()

返回支持的SSL加密器的名字数组。

例子:

var ciphers = tls.getCiphers();
console.log(ciphers); // ['AES128-SHA', 'AES256-SHA', ...]

tls.createServer(options[, secureConnectionListener])

创一个新的tls.Server实例。connectionListener参数被自动添加为secureConnection事件的监听器。options参数可以有以下属性:

  • pfx: 一个包含PFXPKCS12格式的私钥,加密凭证和CA证书的字符串或buffer

  • key: 一个带着PEM加密私钥的字符串(可以是密钥数组)(必选)。

  • passphrase: 一个私钥或pfx密码字符串。

  • cert: 一个包含了PEM格式的服务器证书密钥的字符串或buffer(可以是cert数组)(必选)。

  • ca: 一个PEM格式的受信任证书的字符串或buffer数组。如果它被忽略,将使用一些众所周知的“根”CA,像VeriSign。这些被用来授权连接。

  • crl : 一个PEM编码的证书撤销列表(Certificate Revocation List)字符串或字符串列表。

  • ciphers: 一个描述要使用或排除的加密器的字符串,通过:分割。默认的加密器套件是:

ECDHE-RSA-AES128-GCM-SHA256:
ECDHE-ECDSA-AES128-GCM-SHA256:
ECDHE-RSA-AES256-GCM-SHA384:
ECDHE-ECDSA-AES256-GCM-SHA384:
DHE-RSA-AES128-GCM-SHA256:
ECDHE-RSA-AES128-SHA256:
DHE-RSA-AES128-SHA256:
ECDHE-RSA-AES256-SHA384:
DHE-RSA-AES256-SHA384:
ECDHE-RSA-AES256-SHA256:
DHE-RSA-AES256-SHA256:
HIGH:
!aNULL:
!eNULL:
!EXPORT:
!DES:
!RC4:
!MD5:
!PSK:
!SRP:
!CAMELLIA

默认的加密器套件更倾向于Chrome's 'modern cryptography' setting的GCM加密器,也倾向于PFC的ECDHE和DHE加密器,它们提供了一些向后兼容性。

鉴于specific attacks affecting larger AES key sizes,所以更倾向于使用128位的AES而不是192和256位的AES。

旧的依赖于不安全的和弃用的RC4或基于DES的加密器(像IE6)的客户端将不能完成默认配置下的握手。如果你必须支持这些客户端,TLS推荐规范可能提供了一个兼容的加密器套件。更多格式细节,参阅OpenSSL cipher list format documentation

  • ecdhCurve: 一个描述用于ECDH密钥协商的已命名的椭圆的字符串,如果要禁用ECDH,就设置为false

默认值为prime256v1(NIST P-256)。使用crypto.getCurves()来获取一个可用的椭圆列表。在最近的发行版中,运行openssl ecparam -list_curves命令也会展示所有可用的椭圆的名字和描述。

  • dhparam: 一个包含了迪菲-赫尔曼参数的字符串或buffer,要求有完全向前保密。使用openssl dhparam来创建它。它的密钥长度需要大于等于1024字节,否则会抛出一个错误。强力推荐使用2048或更多位,来获取更高的安全性。如果参数被忽略或不合法,它会被默默丢弃并且DHE加密器将不可用。

  • handshakeTimeout: 当SSL/TLS握手在这个指定的毫秒数后没有完成时,终止这个链接。默认为120秒。

当握手超时时,tls.Server会触发一个clientError事件。

  • honorCipherOrder : 选择一个加密器时,使用使用服务器的首选项而不是客户端的首选项。默认为true

  • requestCert: 如果设置为true,服务器将会向连接的客户端请求一个证书,并且试图验证这个证书。默认为true

  • rejectUnauthorized: 如果设置为true,服务器会拒绝所有没有在提供的CA列表中被授权的客户端。只有在requestCerttrue时这个选项才有效。默认为false

  • NPNProtocols: 一个可用的NPN协议的字符串或数组(协议应该由它们的优先级被排序)。

  • SNICallback(servername, cb): 当客户端支持SNI TLS扩展时,这个函数会被调用。这个函数会被传递两个参数:servername和cb。SNICallback必须执行cb(null, ctx),ctx是一个SecureContext实例(你可以使用tls.createSecureContext(...)来获取合适的SecureContext)。如果SNICallback没有被提供 - 默认的有高层次API的回调函数会被使用(参阅下文)。

  • sessionTimeout: 一个指定在TLS会话标识符和TLS会话门票(tickets)被服务器创建后的超时时间。更多详情参阅SSL_CTX_set_timeout

  • ticketKeys: 一个由16字节前缀,16字节hmac密钥,16字节AEC密钥组成的48字节buffer。你可以使用它在不同的tls服务器实例上接受tls会话门票。

注意:会在cluster模块工作进程间自动共享。

  • sessionIdContext: 一个包含了会话恢复标识符的字符串。如果requestCerttrue,默认值是通过命令行生成的MD5哈希值。否则,就将不提供默认值。

  • secureProtocol: 将要使用的SSL方法,举例,SSLv3_method将强制使用SSL v3。可用的值取决于OpenSSL的安装和SSL_METHODS常量中被定义的值。

下面是一个简单应答服务器的例子:

var tls = require('tls');
var fs = require('fs');

var options = {
  key: fs.readFileSync('server-key.pem'),
  cert: fs.readFileSync('server-cert.pem'),

  // This is necessary only if using the client certificate authentication.
  requestCert: true,

  // This is necessary only if the client uses the self-signed certificate.
  ca: [ fs.readFileSync('client-cert.pem') ]
};

var server = tls.createServer(options, function(socket) {
  console.log('server connected',
              socket.authorized ? 'authorized' : 'unauthorized');
  socket.write("welcome!\n");
  socket.setEncoding('utf8');
  socket.pipe(socket);
});
server.listen(8000, function() {
  console.log('server bound');
});

var tls = require('tls');
var fs = require('fs');

var options = {
  pfx: fs.readFileSync('server.pfx'),

  // This is necessary only if using the client certificate authentication.
  requestCert: true,

};

var server = tls.createServer(options, function(socket) {
  console.log('server connected',
              socket.authorized ? 'authorized' : 'unauthorized');
  socket.write("welcome!\n");
  socket.setEncoding('utf8');
  socket.pipe(socket);
});
server.listen(8000, function() {
  console.log('server bound');
});

你可以通过openssl s_client来连接服务器:

openssl s_client -connect 127.0.0.1:8000

tls.connect(options[, callback])

tls.connect(port[, host][, options][, callback])

根据给定的 端口和主机(旧API)或 options.portoptions.host 创建一个新的客户端连接。如果忽略了主机,默认为localhostoptions可是一个含有以下属性的对象:

  • host: 客户端应该连接到的主机。

  • port: 客户端应该连接到的端口。

  • socket: 根据给定的socket的来建立安全连接,而不是创建一个新的socket。如果这个选项被指定,hostport会被忽略。

  • path: 创建到path的unix socket连接。如果这个选项被指定,hostport会被忽略。

  • pfx: 一个PFXPKCS12格式的包含了私钥,证书和CA证书的字符串或buffer

  • key: 一个PEM格式的包含了客户端私钥的字符串或buffer(可以是密钥的数组)。

  • passphrase: 私钥或pfx的密码字符串。

  • cert: 一个PEM格式的包含了证书密钥的字符串或buffer(可以是密钥的数组)。

  • ca: 一个PEM格式的受信任证书的字符串或buffer数组。如果它被忽略,将使用一些众所周知的CA,像VeriSign。这些被用来授权连接。

  • ciphers: 一个描述了要使用或排除的加密器,由:分割。使用的默认加密器套件与tls.createServer使用的一样。

  • rejectUnauthorized: 若被设置为true,会根据提供的CA列表来验证服务器证书。当验证失败时,会触发error事件;err.code包含了一个OpenSSL错误码。默认为true

  • NPNProtocols: 包含支持的NPN协议的字符串或buffer数组。buffer必须有以下格式:0x05hello0x05world,第一个字节是下一个协议名的长度(传递数组会更简单:['hello', 'world'])。

  • servername: SNI TLS 扩展的服务器名。

  • checkServerIdentity(servername, cert): 为根据证书的服务器主机名检查提供了覆盖。必须在验证失败时返回一个错误,验证通过时返回undefined

  • secureProtocol: 将要使用的SSL方法,举例,SSLv3_method将强制使用SSL v3。可用的值取决于OpenSSL的安装和SSL_METHODS常量中被定义的值。

  • session: 一个Buffer实例,包含了TLS会话。

callback参数会被自动添加为secureConnect事件的监听器。

tls.connect()返回一个tls.TLSSocket对象。

以下是一个上述应答服务器的客户端的例子:

var tls = require('tls');
var fs = require('fs');

var options = {
  // These are necessary only if using the client certificate authentication
  key: fs.readFileSync('client-key.pem'),
  cert: fs.readFileSync('client-cert.pem'),

  // This is necessary only if the server uses the self-signed certificate
  ca: [ fs.readFileSync('server-cert.pem') ]
};

var socket = tls.connect(8000, options, function() {
  console.log('client connected',
              socket.authorized ? 'authorized' : 'unauthorized');
  process.stdin.pipe(socket);
  process.stdin.resume();
});
socket.setEncoding('utf8');
socket.on('data', function(data) {
  console.log(data);
});
socket.on('end', function() {
  server.close();
});

var tls = require('tls');
var fs = require('fs');

var options = {
  pfx: fs.readFileSync('client.pfx')
};

var socket = tls.connect(8000, options, function() {
  console.log('client connected',
              socket.authorized ? 'authorized' : 'unauthorized');
  process.stdin.pipe(socket);
  process.stdin.resume();
});
socket.setEncoding('utf8');
socket.on('data', function(data) {
  console.log(data);
});
socket.on('end', function() {
  server.close();
});

Class: tls.TLSSocket

net.Socket实例的包装,替换了内部socket的 读/写例程,来提供透明的对 传入/传出数据 的 加密/解密。

new tls.TLSSocket(socket, options)

根据已存在的TCPsocket,构造一个新的TLSSocket对象。

socket是一个net.Socket实例。

options是一个可能包含以下属性的对象:

  • secureContext: 一个可选的通过tls.createSecureContext( ... )得到的TLS内容对象。

  • isServer: 如果为true,TLS socket将会在服务器模式(server-mode)下被初始化。

  • server: 一个可选的net.Server实例。

  • requestCert: 可选,参阅tls.createSecurePair

  • rejectUnauthorized: 可选,参阅tls.createSecurePair

  • NPNProtocols: 可选,参阅tls.createServer

  • SNICallback: 可选,参阅tls.createServer

  • session: 可选,一个Buffer实例,包含了TLS会话。

  • requestOCSP: 可选,如果为trueOCSP状态请求扩展将会被添加到客户端 hello,并且OCSPResponse事件将会在建立安全通信前,于socket上触发。

tls.createSecureContext(details)

创建一个证书对象,details有可选的以下值:

  • pfx : 一个含有PFXPKCS12编码的私钥,证书和CA证书的字符串或buffer
  • key : 一个含有PEM编码的私钥的字符串。
  • passphrase : 一个私钥或pfx密码字符串。
  • cert : 一个含有PEM加密证书的字符串。
  • ca : 一个用来信任的PEM加密CA证书的字符串或字符串列表。
  • crl : 一个PEM加密CRL的字符串或字符串列表。
  • ciphers: 一个描述需要使用或排除的加密器的字符串。更多加密器的格式细节参阅http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT
  • honorCipherOrder : 选择一个加密器时,使用使用服务器的首选项而不是客户端的首选项。默认为true。更多细节参阅tls模块文档。

如果没有指定ca,那么node.js将会使用http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt提供的默认公共可信任CA列表。

tls.createSecurePair([context][, isServer][, requestCert][, rejectUnauthorized])

根据两个流,创建一个新的安全对(secure pair)对象,一个是用来读/写加密数据,另一个是用来读/写明文数据。通常加密的数据是从加密数据流被导流而来,明文数据被用来作为初始加密流的一个替代。

  • credentials: 一个通过tls.createSecureContext( ... )得到的安全内容对象。

  • isServer: 一个表明了 是否这个tls连接应被作为一个服务器或一个客户端打开 的布尔值。

  • requestCert: 一个表明了 是否服务器应该向连接的客户端请求证书 的布尔值。只应用于服务器连接。

  • rejectUnauthorized: 一个表明了 是否服务器应该拒绝包含不可用证书的客户端 的布尔值。只应用于启用了requestCert的服务器。

tls.createSecurePair()返回一个带有cleartextencrypted流 属性的对象。

注意:cleartexttls.TLSSocket有相同的API。

Class: SecurePair

tls.createSecurePair返回。

Event: 'secure'

SecurePair成功建立一个安全连接时,SecurePair会触发这个事件

与检查服务器的secureConnection事件相似,pair.cleartext.authorized必须被检查,来确认证书是否使用了合适的授权。

Class: tls.Server

这是一个net.Server的子类,并且与其有相同的方法。除了只接受源TCP连接,这个类还接受通过TLS或SSL加密的数据。

Event: 'secureConnection'

  • function (tlsSocket) {}

当一个新连接被成功握手后,这个事件会被触发。参数是一个tls.TLSSocket实例。它拥有所有普通流拥有的事件和方法。

socket.authorized是一个表明了 客户端是否通过提供的服务器CA来进行了认证 的布尔值。如果socket.authorizedfalse,那么socket.authorizationError将被设置用来描述授权失败的原因。一个不明显的但是值得提出的点:依靠TLS服务器的设定,未授权的连接可能会被接受。socket.npnProtocol是一个包含了被选择的NPN协议的字符串。socket.servernam是一个包含了通过SNI请求的服务器名的字符串。

Event: 'clientError'

  • function (exception, tlsSocket) { }

当安全连接被建立之前,服务器触发了一个error事件 - 它会被转发到这里。

tlsSocket是错误来自的tls.TLSSocket

Event: 'newSession'

  • function (sessionId, sessionData, callback) { }

在TLS会话创建时触发。可能会被用来在外部存储会话。callback必须最终被执行,否则安全连接将不会收到数据。

注意:这个事件监听器只会影响到它被添加之后建立的连接。

Event: 'resumeSession'

  • function (sessionId, callback) { }

当客户端想要恢复先前的TLS会话时触发。事件监听器可能会在外部通过sessionId来寻找会话,并且在结束后调用callback(null, sessionData)。如果会话不能被恢复(例如没有找到),可能会调用callback(null, null)。调用callback(err)会关闭将要到来的连接并且销毁socket

注意:这个事件监听器只会影响到它被添加之后建立的连接。

Event: 'OCSPRequest'

  • function (certificate, issuer, callback) { }

当客户端发送一个证书状态请求时触发。你可以解释服务器当前的证书来获取OCSP url和证书id,并且在获取了OCSP响应后执行callback(null, resp)resp是一个Buffer实例。certificateissuer都是一个Buffer,即主键和发起人证书的DER代表(DER-representations)。它们可以被用来获取OCSP证书id 和 OCSP末端url。

另外,callback(null, null)可以被调用,意味着没有OCSP响应。

调用callback(err),将会导致调用socket.destroy(err)

典型的流程:

  1. 客户端连接到服务器,然后发送一个OCSPRequest给它(通过ClientHello中扩展的状态信息)。
  2. 服务器接受请求,然后执行OCSPRequest事件监听器(如果存在)。
  3. 服务器通过证书或发起人抓取OCSP url,然后向CA发起一个OCSP请求。
  4. 服务器从CA收到一个OCSPResponse,然后通过回调函数的参数将其返回给客户端。
  5. 客户端验证响应,然后销毁socket或者进行握手。

注意:issuer可以是null,如果证书是自签名的或issuer不在根证书列表之内(你可以通过ca参数提供一个issuer)。

注意:这个事件监听器只会影响到它被添加之后建立的连接。

注意:你可能想要使用一些如asn1.jsnpm模块来解释证书。

server.listen(port[, hostname][, callback])

从指定的端口和主机名接收连接。如果hostname被忽略,服务器会在当IPv6可用时,接受任意IPv6地址(::)上的连接,否则为任意IPv4(0.0.0.0)上的。将port设置为0则会赋予其一个随机端口。

这个函数是异步的。最后一个参数callback会在服务器被绑定后执行。

更多信息请参阅net.Server

server.close([callback])

阻止服务器继续接收新连接。这个函数是异步的,当服务器触发一个close事件时,服务器将最终被关闭。可选的,你可以传递一个回调函数来监听close事件。

server.address()

返回绑定的地址,服务器地址的协议族名和端口通过操作系统报告。更多信息请参阅net.Server.address()

server.addContext(hostname, context)

添加安全内容,它将会在如果客户端请求的SNI主机名被传递的主机名匹配(可以使用通配符)时使用。context可以包含密钥,证书,CA 和/或 其他任何tls.createSecureContextoptions参数的属性。

server.maxConnections

当服务器连接数变多时,设置这个值来拒绝连接。

server.connections

服务器上的当前连接数。

Class: CryptoStream

稳定度: 0 - 弃用。 使用tls.TLSSocket替代。

这是一个加密流。

cryptoStream.bytesWritten

一个底层socketbytesWritten存取器的代理,它会返回写入socket的总字节数,包括TLS开销。

Class: tls.TLSSocket

这是一个net.Socket的包装,但是对写入的数据做了透明的加密,并且要求TLS协商。

这个实例实现了一个双工流接口。它有所有普通流所拥有的事件和方法。

Event: 'secureConnect'

在一个新连接成功握手后,这个事件被触发。无论服务器的证书被授权与否,这个监听器都会被调用。测试tlsSocket.authorized来 验证服务器证书是否被一个指定CA所签名 取决于用户。如果tlsSocket.authorized === false那么错误可以从tlsSocket.authorizationError里被发现。如果NPN被使用,你可以通过tlsSocket.npnProtocol来检查已协商协议。

Event: 'OCSPResponse'

  • function (response) { }

如果requestOCSP选项被设置,这个事件会触发。response是一个buffer对象,包含了服务器的OCSP响应。

习惯上,response是一个来自服务器的CA(包含服务器的证书撤销状态)的已签名对象。

tlsSocket.encrypted

静态布尔变量,总是true。可能会被用来区分TLS socket和普通的socket

tlsSocket.authorized

如果对等(peer)证书通过一个指定的CA被签名,那么这个值为true。否则为false

tlsSocket.authorizationError

对等(peer)的证书没有被验证的原因。这个值只在tlsSocket.authorized === false时可用。

tlsSocket.getPeerCertificate([ detailed ])

返回了一个代表了对等证书的对象。返回的对象有一些属性与证书的属性一致。如果detailed参数被设置为trueissuer属性的完整链都会被返回,如果为false,只返回不包含issuer属性的顶端的证书。

例子:

{ subject:
   { C: 'UK',
     ST: 'Acknack Ltd',
     L: 'Rhys Jones',
     O: 'node.js',
     OU: 'Test TLS Certificate',
     CN: 'localhost' },
  issuerInfo:
   { C: 'UK',
     ST: 'Acknack Ltd',
     L: 'Rhys Jones',
     O: 'node.js',
     OU: 'Test TLS Certificate',
     CN: 'localhost' },
  issuer:
   { ... another certificate ... },
  raw: < RAW DER buffer >,
  valid_from: 'Nov 11 09:52:22 2009 GMT',
  valid_to: 'Nov  6 09:52:22 2029 GMT',
  fingerprint: '2A:7A:C2:DD:E5:F9:CC:53:72:35:99:7A:02:5A:71:38:52:EC:8A:DF',
  serialNumber: 'B9B0D332A1AA5635' }

如果peer没有提供一个证书,那么会返回null或空对象。

tlsSocket.getCipher()

返回一个代表了当前连接的加密器名和SSL/TLS协议版本的对象。

例子: { name: 'AES256-SHA', version: 'TLSv1/SSLv3' }

参阅http://www.openssl.org/docs/ssl/ssl.html#DEALING_WITH_CIPHERSSSL_CIPHER_get_name()SSL_CIPHER_get_version()

tlsSocket.renegotiate(options, callback)

初始化TLS重新协商过程。optios可以包含以下属性:rejectUnauthorizedrequestCert(详情参阅tls.createServer)。一旦重协商成功,callback(err)会带着errnull执行。

注意:可以被用来请求对等(peer)证书在安全连接建立之后。

另一个注意点:当作为服务器运行时,socekthandshakeTimeout超时后,会带着一个错误被销毁。

tlsSocket.setMaxSendFragment(size)

设置TLS碎片大小的最大值(默认最大值为16384,最小值为512)。若设置成功返回true,否则返回false

更小的碎片大小来减少客户端的缓冲延迟:大的碎片通过TLS层缓冲,直到收到全部的碎片并且它的完整性被验证;大碎片可能会跨越多次通信,并且可能会被报文丢失和重新排序所延迟。但是,更小的碎片增加了额外的TLS框架字节和CPU开销,可能会减少总体的服务器负载。

tlsSocket.getSession()

返回ASN.1编码的TLS会话,如果没有被协商,返回undefined。可以被用在重新连接服务器时,加速握手的建立。

tlsSocket.getTLSTicket()

注意:仅在客户端TLS socket中工作。仅在调试时有用,因为会话重新使用了给tls.connect提供的session选项。

返回TLS会话门票(ticket),如果没有被协商,返回undefined

tlsSocket.address()

返回绑定的地址,协议族名和端口由底层系统报告。返回一个含有三个属性的对象,例如:{ port: 12346, family: 'IPv4', address: '127.0.0.1' }

tlsSocket.remoteAddress

代表了远程IP地址的字符串。例子:'74.125.127.100''2001:4860:a005::68'

tlsSocket.remoteFamily

代表了远程IP协议族的字符串。'IPv4''IPv6'

tlsSocket.remotePort

代表了远程端口数字。例子:443

tlsSocket.localAddress

代表了本地IP地址的字符串。

tlsSocket.localPort

代表了本地端口的数字。

results matching ""

    No results matching ""