Skip to content

Manages Certificates, private keys as quick as light with cli intergrated!

License

Notifications You must be signed in to change notification settings

HADMARINE/quickcert.js

Repository files navigation

QuickCert.js

IMPORTANT : As a package which handles sensitive datas, QUICKERT DOES NOT COLLECT ANY DATA IF IT IS SENSITIVE OR NOT. So relax!

Installation

// Install Globally
npm install -g quickcert

// Install Locally - NPM
npm install quickcert

// Install Locally - YARN
yarn add quickcert

Terms

Key file

Keyfile is a file in which the private key is saved. Quickcert will search this keyfile (default: qcert.key) unless you provide custom key (by -k option)

Config file

Config file is a file in which the public keys of each file reside - in other words, encrypted. You can publicly save or publish this config file since there are any datas which are confidential. This encryption is executed by AES-256 (GCM Mode) Two-way cryptography and saved in base64 format.

Usage

Use yarn or npx to execute it.

If you installed globally, execute like : quickcert <command> Else locally, execute like : yarn quickcert <command>

Execute quickcert help for help.

quickcert init

Description

Initialize configuration files. You must initialize before all of the commands.
Nothing hard, cli interface will pop out!

Parameters

  • --cfg : custom configuration file root

quickcert decrypt

Description

Decrypt credentials.

Parameters

  • <filePath (positional)> [not required] : directory of credential. Could be one or more.
  • -k : private key (password) of encrypted credentials
  • --kf : custom keyfile root
  • --cfg : custom configuration file root

Examples

quickcert decrypt a.txt quickcert decrypt a.txt b.key c.exe -k test

quickcert encrypt

Description

Register credentials to configuration file.
Of course, all the credentials will be encrypted, so don't be afraid of uploading the qcert.conf file to public!

Parameters

  • <filePath (positional)> [required] : directory of credential. Could be one or more.
  • -k : private key (password) of encrypted credentials
  • --kf : custom keyfile root
  • --cfg : custom configuration file root

Examples

quickcert encrypt a.txt quickcert encrypt a.txt b.key c.exe

quickcert renew

Description

Re-encrypts all the registered credentials.

Parameters

  • -k : private key (password) of encrypted credentials
  • --kf : custom keyfile root
  • --cfg : custom configuration file root

quickcert delete

Description

Unregister credentials from configuration.

Parameters

  • <filePath (positional)> [required] : directory of credential.
  • -k : private key (password) of encrypted credentials
  • --kf : custom keyfile root
  • --cfg : custom configuration file root

Example

quickcert delete a.txt

Bug Report

Please report your bug in the issue tab!

Prerequisites

Node.js environment higher than Node14 (tested on Node14, Node16, Node20 environment)