1.0.10 • Published 2 years ago
encr v1.0.10
encr
Simple promise based encryption wrapper for Node.js and CLI based on crypto module
Installation
npm i encr -Syarn add encrCLI
## Encrypt
encr -i <input> -o <output> [--force] [--key <secret>] [--alg <algorithm>]
## Decrypt
encr -d -i <input> -o <output> [--force] [--key <secret>] [--alg <algorithm>]
## Random generator of length (default = 32)
encr -g <length>Arguments
| Arg | Description |
|---|---|
-i | Input file - this can be encrypted or plain data file |
-o | Output file. If this option is stdout it is output as string. Do not use this option to store to file as this will corrupt the encoding of buffer |
-d | Use this option to decrypt the input |
-g | Generate nonce |
--key | The secret key to use for encryption. Alternatively you can provide environment variable ENCR_SECRET. If none of these options are provided then you will be securely asked for the key |
Optional arguments
| Arg | Description |
|---|---|
--force | If output file already exists, use this option to overwrite. |
--alg | Encryption algorithm to use. List depends upon OpenSSL (as per Node.js docs) Run openssl list -cipher-algorithms to choose the possible option. You must choose 256 bit option for correct key length. It defaults to AES-256 CBC |
-h | Display this list of options for convenience |
-v | Display version information |
API
const Encr = require('encr');
const encr = new Encr('MySecret');
const plain = Buffer.from('Hello world');
encr.encrypt(plain).then(encrypted => {
console.log('Encrypted:', encrypted.toString('base64'));
return encr.decrypt(encrypted);
}).then(decrypted => {
console.log('Decrypted:', decrypted.toString());
})License
Copyright (c) 2020 @abumusamq
https://amrayn.com
https://github.com/amrayn/
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.