diff options
author | Sam Roberts <vieuxtech@gmail.com> | 2016-12-20 14:16:18 -0800 |
---|---|---|
committer | Sam Roberts <vieuxtech@gmail.com> | 2017-01-12 11:10:32 -0800 |
commit | f9665280a495d80b7ace32d59ab29b1983f96731 (patch) | |
tree | a79c0ed6cdf3dd7d1ed346c6b676c69160abbc45 /doc/api/tls.md | |
parent | ea72331afc66150a9f5578e5b50f9a6d9024bc22 (diff) | |
download | android-node-v8-f9665280a495d80b7ace32d59ab29b1983f96731.tar.gz android-node-v8-f9665280a495d80b7ace32d59ab29b1983f96731.tar.bz2 android-node-v8-f9665280a495d80b7ace32d59ab29b1983f96731.zip |
doc: use correct tls certificate property name
Docs referred to an `issuer` property being optionally present, when it
should have referred to the `issuerCertificate` property.
PR-URL: https://github.com/nodejs/node/pull/10389
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Diffstat (limited to 'doc/api/tls.md')
-rw-r--r-- | doc/api/tls.md | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/doc/api/tls.md b/doc/api/tls.md index 377bfd3dd7..64fd343c04 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -583,13 +583,16 @@ For Example: `{ type: 'ECDH', name: 'prime256v1', size: 256 }` added: v0.11.4 --> -* `detailed` {boolean} Specify `true` to request that the full certificate - chain with the `issuer` property be returned; `false` to return only the - top certificate without the `issuer` property. +* `detailed` {boolean} Include the full certificate chain if `true`, otherwise + include just the peer's certificate. Returns an object representing the peer's certificate. The returned object has some properties corresponding to the fields of the certificate. +If the full certificate chain was requested, each certificate will include a +`issuerCertificate` property containing an object representing its issuer's +certificate. + For example: ```text @@ -600,15 +603,15 @@ For example: O: 'node.js', OU: 'Test TLS Certificate', CN: 'localhost' }, - issuerInfo: + issuer: { C: 'UK', ST: 'Acknack Ltd', L: 'Rhys Jones', O: 'node.js', OU: 'Test TLS Certificate', CN: 'localhost' }, - issuer: - { ... another certificate ... }, + issuerCertificate: + { ... another certificate, possibly with a .issuerCertificate ... }, raw: < RAW DER buffer >, valid_from: 'Nov 11 09:52:22 2009 GMT', valid_to: 'Nov 6 09:52:22 2029 GMT', @@ -616,8 +619,7 @@ For example: serialNumber: 'B9B0D332A1AA5635' } ``` -If the peer does not provide a certificate, `null` or an empty object will be -returned. +If the peer does not provide a certificate, an empty object will be returned. ### tlsSocket.getProtocol() <!-- YAML |