get-ssl-certificate-next

A micro-library that returns a website's SSL certificate

Usage no npm install needed!

<script type="module">
  import getSslCertificateNext from 'https://cdn.skypack.dev/get-ssl-certificate-next';
</script>

README

get-ssl-certificate-next

A zero-dependency utility that returns a website's SSL certificate

CI Coverage Status Code Climate NPM version

Installation

npm install --save get-ssl-certificate-next

Usage

Import package:

const sslCertificate = require('get-ssl-certificate-next')

Pass a url / domain name:

sslCertificate.get('nodejs.org').then(function (certificate) {
  console.log(certificate)
  // certificate is a JavaScript object

  console.log(certificate.issuer)
  // { C: 'GB',
  //   ST: 'Greater Manchester',
  //   L: 'Salford',
  //   O: 'COMODO CA Limited',
  //   CN: 'COMODO RSA Domain Validation Secure Server CA' }

  console.log(certificate.valid_from)
  // 'Aug  14 00:00:00 2017 GMT'

  console.log(certificate.valid_to)
  // 'Nov 20 23:59:59 2019 GMT'

  // If there was a certificate.raw attribute, then you can access certificate.pemEncoded
  console.log(certificate.pemEncoded)
  // -----BEGIN CERTIFICATE-----
  // ...
  // -----END CERTIFICATE-----
});

Optional parameters: Timeout (in ms), Protocol (Default is 'https:'), Port (Default is 443) and detailed (includes certificate chain, Default is false)

sslCertificate.get('nodejs.org', 250, 443, 'https:', false).then(function (certificate) {
  console.log(certificate)
  // certificate is a JavaScript object

  console.log(certificate.issuer)
  // { C: 'GB',
  //   ST: 'Greater Manchester',
  //   L: 'Salford',
  //   O: 'COMODO CA Limited',
  //   CN: 'COMODO RSA Domain Validation Secure Server CA' }

  console.log(certificate.valid_from)
  // 'Aug  14 00:00:00 2017 GMT'

  console.log(certificate.valid_to)
  // 'Nov 20 23:59:59 2019 GMT'

  // If there was a certificate.raw attribute, then you can access certificate.pemEncoded
  console.log(certificate.pemEncoded)
  // -----BEGIN CERTIFICATE-----
  // ...
  // -----END CERTIFICATE-----
});

License

MIT