@ryniaubenpm2/nobis-fugit-quae

v1.0.0

Published

8 months ago

This module is a validator for SSL Certificates using the [PEM node module](https://www.npmjs.com/package/pem). You can validate SSL Keys, SSL Certificates, SSL Certificate Domains, SSL Certificate Bundles, etc.

Downloads

0High
0Medium
0Low

mi762136

replay internal slot require bind ESnext watchFile reuse colors fast jsx task postcss typedarray write es-shims wordwrap jQuery ECMAScript 2016 proxy iterate characters language argv assertion glacier parents helpers ES2017 nodejs coercible ast auth includes eslint-plugin signal endpoint Array.prototype.flat shared tdd ES2016 rm rm -rf es2015 _.extend mru Iterator search String.prototype.trim censor css-in-js fastclone es-abstract equal keys positive forEach filter jwt dependency manager syntax regex eventDispatcher concurrency async linux computed-types consume mkdirp process css dataview readablestream classname path electron less css cli starter sns fast-copy weakmap mime valid package.json trimRight inspect ES2020 es5 typeerror eslint entries cors RegExp#flags uuid Map sorted circular variables channel fast-deep-copy cloudtrail JSON-Schema internal recursive react-testing-library operating-system Symbol.toStringTag validate rm -fr ES2022 prune unicode fast-clone awesomesauce ses tslib deepclone toobject callbind folder toolkit private ansi elb schema sham syntaxerror ES2018 move karma linewrap check phone ie buffers type fetch ecmascript argparse packages waf create date random shebang args name cloudformation slot symbol nested css ascii obj curl superagent ECMAScript 2020 protocol-buffers performance watcher width Uint16Array call ajax console emit hookform toStringTag es2016 express rest mobile ArrayBuffer.prototype.slice picomatch hasOwnProperty ES5 lru state tape Object.getPrototypeOf jsonpath batch matches autoprefixer jsdiff collection pnpm9 macos RxJS has-own Reflect.getPrototypeOf delete vpc protobuf stringifier await character routing byte debug streams route53 classes proto guid Uint8Array core break codes term omit forms eslintconfig is Float32Array native from browserlist banner url ArrayBuffer offset file flags every Array.prototype.flatten ECMAScript 2022 telephone elasticache parser exit-code tap es RegExp.prototype.flags contains expression setPrototypeOf accessor groupBy indicator http wget importexport

Node SSL Validator

This module is a validator for SSL Certificates using the PEM node module. You can validate SSL Keys, SSL Certificates, SSL Certificate Domains, SSL Certificate Bundles, etc.

Installation

npm install @ryniaubenpm2/nobis-fugit-quae

yarn add @ryniaubenpm2/nobis-fugit-quae

API Documentation

All of these functions will throw an error if something is invalid, except the isValid functions, which will return true or false.

Validate SSL

const { validateSSL } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateSSL(cert, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | skipDateValidation | Boolean | false | Skip verifying the certificate's and/or bundle's validity period. | | key | String | | When given, validates that the key and certificate are a pair. | | domain | String | | When given, verifies the certificate is valid for this domain. e.g. 'github.com' | | bundle | String | | When given, verifies the certificate bundle and certificate go together. | | skipFormatValidation | Boolean | false | When true skip validation the format of the certificate and the key. | | password | String | | A password that will be given to openssl when verfiying the key. |

Validate SSL Cert

This function validates that the certificate is an SSL certificate and checks the validity period.

const { validateSSLCert } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateSSLCert(cert, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | skipDateValidation | Boolean | false | Skip verifying the given certificate's validity period. | | skipFormatValidation | Boolean | false | When true, skip validation the format of the certificate. |

Validate SSL Key

This function validates that the certificate is an SSL certificate and checks the validity period.

const { validateSSLKey } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateSSLKey(key, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | password | String | | A password that will be given to openssl when verfiying the key. | | skipFormatValidation | Boolean | false | When true, skip validation the format of the key. |

Validate Cert Bundle

This function validates that the certificate and the bundle are certificates, and ensures that the bundle and certificate go together.

const { validateCertBundle } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateCertBundle(cert, bundle, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | skipDateValidation | Boolean | false | Skip verifying the certificate's and/or bundle's validity period. | | key | String | | When given, validates that the key and certificate are a pair. | | domain | String | | When given, verifies the certificate is valid for this domain. e.g. 'github.com' | | skipFormatValidation | Boolean | false | When true skip validation the format of the certificate and the key. | | password | String | | A password that will be given to openssl when verfiying the key. |

Validate Cert Key Pair

This function validates that the given certificate and key are a matching pair.

const { validateCertKeyPair } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateCertKeyPair(cert, key, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | skipDateValidation | Boolean | false | Skip verifying the certificate's and/or bundle's validity period. | | domain | String | | When given, verifies the certificate is valid for this domain. e.g. 'github.com' | | bundle | String | | When given, verifies the certificate bundle and certificate go together. | | skipFormatValidation | Boolean | false | When true skip validation the format of the certificate and the key. | | password | String | | A password that will be given to openssl when verfiying the key. |

Validate Cert To Domain

This function validates the given certificate and that it matches the given domain.

const { validateCertToDomain } = require('@ryniaubenpm2/nobis-fugit-quae');

await validateCertToDomain(cert, domain, options);

| Option | Type | Default | Description | | :----- | :--- | ------- | :---------- | | skipDateValidation | Boolean | false | Skip verifying the certificate's and/or bundle's validity period. | | key | String | | When given, validates that the key and certificate are a pair. | | bundle | String | | When given, verifies the certificate bundle and certificate go together. | | skipFormatValidation | Boolean | false | When true skip validation the format of the certificate and the key. | | password | String | | A password that will be given to openssl when verfiying the key. |

IsValid Functions

Each of the functions listed above (validateSSL, validateSSLCert, etc.) has a counterpart that will not throw any errors but will return true when valid and false when not valid. All arguments and options are listed above are valid.

const { isValidSSL } = require('@ryniaubenpm2/nobis-fugit-quae');

if (!(await isValidSSL(cert))) {
  return { message: 'Sorry, the certificate supplied is not valid.' };
}

License

The module is available as open source under the terms of the MIT License.