https://github.com/fajarkim/node-openssl-enc
A Node.js CLI tool and library for encryption and decryption with OpenSSL Enc.
https://github.com/fajarkim/node-openssl-enc
cipher compress cryptography decipher decompress decrypt encrypt node nodejs
Last synced: 4 months ago
JSON representation
A Node.js CLI tool and library for encryption and decryption with OpenSSL Enc.
- Host: GitHub
- URL: https://github.com/fajarkim/node-openssl-enc
- Owner: FajarKim
- License: agpl-3.0
- Created: 2023-12-30T03:02:24.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-07-08T01:59:41.000Z (7 months ago)
- Last Synced: 2025-07-08T04:23:53.892Z (7 months ago)
- Topics: cipher, compress, cryptography, decipher, decompress, decrypt, encrypt, node, nodejs
- Language: JavaScript
- Homepage:
- Size: 281 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## Node OpenSSL Enc
A Node.js CLI tool and library for encryption and decryption with OpenSSL Enc.
[](https://www.npmjs.com/package/@fajarkim/node-openssl-enc)
[](https://github.com/FajarKim/node-openssl-enc/stargazers/)
[](https://github.com/FajarKim/node-openssl-enc/network/members/)
[](https://github.com/FajarKim/node-openssl-enc/issues)
[](https://github.com/FajarKim/node-openssl-enc/archive/refs/heads/master.zip)
### Introduction
In the dynamic and ever-evolving realm of cybersecurity, data encryption serves as an indispensable shield against potential threats and unauthorized access. Node.js developers find themselves equipped with a library similar to OpenSSL, namely Crypto. Within the vast expanse of OpenSSL tools, OpenSSL Enc takes center stage, offering a command-line interface for symmetric encryption and decryption. Therefore, we have created a similar tool specifically designed for data encryption and decryption using Node.js, known as Node OpenSSL Enc.
### Installation
Maybe on some systems or versions of Node.js there will be an error when running this tool. You don't need to worry, follow these steps:
- Copy this code
```shell
export NODE_OPTIONS=--openssl-legacy-provider
```
- Paste the code to file `.bashrc` or `.zshrc`.
- Reload your terminal again.
If so, you can now carry out the installation:
- Library Node.js
```shell
npm install @fajarkim/node-openssl-enc
```
- Command CLI
```shell
npm -g install @fajarkim/node-openssl-enc
```
### Usage
To start using Node OpenSSL, follow these steps:
- Library Node.js
```javascript
const { encrypt, decrypt } = require("@fajarkim/node-openssl-enc");
```
Example usage:
```javascript
const { encrypt, decrypt } = require("@fajarkim/node-openssl-enc");
const algorithm = "aes-128-cbc";
const text = "Hello, World!";
const pass = "secret";
const encrypted = encrypt(algorithm, text, pass);
const decrypted = decrypt(algorithm, encrypted, pass);
console.log(encrypted);
//
console.log(decrypted);
// Hello, World!
```
or with extra encrypted and decrypted:
```javascript
const { encrypt, decrypt } = require("@fajarkim/node-openssl-enc");
const algorithm = "aes-128-cbc";
const text = "Hello, World!";
const pass = "secret";
const extra = "base64"; // You can replace "base64", with "binary", "hex", or "zlib"
const encrypted = encrypt(algorithm, text, pass, extra);
const decrypted = decrypt(algorithm, encrypted, pass, extra);
console.log(encrypted);
// U2FsdGVkX19KDX5oAY11Ph3bGVCnhlvSThkR1b1+DWgUcyVSBVuO/Gb+QQ6eFp5r
console.log(decrypted);
// Hello, World!
```
- Command CLI
```shell
ncssl -h
```
List options:
```text
Usage: ncssl [options]
Node OpenSSL Enc (ncssl) is encryption and decryption data
stdin or file with OpenSSL Ciphers
Options:
-V, --version output the version number
-c, --cipher select cipher for encrypt or decrypt
-f, --file input path file for encrypt or decrypt
-p, --passkey input passphrase key
-d, --dec decrypted data stdin or file
-o, --out saved encryption or decryption to out file
-l, --list list all supported ciphers
-a, --base64 extra encrypt or decrypt data stdout using base64
-b, --binary extra encrypt or decrypt data stdout using binary
-H, --hex extra encrypt or decrypt data stdout using hex
-z, --zlib extra encrypt or decrypt data stdout using zlib
-s, --special special tool for encryption/decryption with
base64 or zlib (without cipher)
-h, --help display help for command
This tool licensed under AGPL-3.0 License, see
Report any bugs to
Full documentation
```
Example usage:
```shell
ncssl -c aes-128-cbc -p "secret" -f input.txt
```
or
```shell
echo "Hello, World!" | ncssl -c aes-128-cbc -p "secret"
```
### Supported Cipher
List supported ciphers:
```text
aes128 aes-128-cbc aes-128-ccm
aes-128-cfb aes-128-cfb1 aes-128-cfb8
aes-128-ctr aes-128-ecb aes-128-gcm
aes-128-ocb aes-128-ofb aes192
aes-192-cbc aes-192-ccm aes-192-cfb
aes-192-cfb1 aes-192-cfb8 aes-192-ctr
aes-192-ecb aes-192-gcm aes-192-ocb
aes-192-ofb aes256 aes-256-cbc
aes-256-ccm aes-256-cfb aes-256-cfb1
aes-256-cfb8 aes-256-ctr aes-256-ecb
aes-256-gcm aes-256-ocb aes-256-ofb
aria128 aria-128-cbc aria-128-ccm
aria-128-cfb aria-128-cfb1 aria-128-cfb8
aria-128-ctr aria-128-ecb aria-128-gcm
aria-128-ofb aria192 aria-192-cbc
aria-192-ccm aria-192-cfb aria-192-cfb1
aria-192-cfb8 aria-192-ctr aria-192-ecb
aria-192-gcm aria-192-ofb aria256
aria-256-cbc aria-256-ccm aria-256-cfb
aria-256-cfb1 aria-256-cfb8 aria-256-ctr
aria-256-ecb aria-256-gcm aria-256-ofb
camellia128 camellia-128-cbc camellia-128-cfb
camellia-128-cfb1 camellia-128-cfb8 camellia-128-ctr
camellia-128-ecb camellia-128-ofb camellia192
camellia-192-cbc camellia-192-cfb camellia-192-cfb1
camellia-192-cfb8 camellia-192-ctr camellia-192-ecb
camellia-192-ofb camellia256 camellia-256-cbc
camellia-256-cfb camellia-256-cfb1 camellia-256-cfb8
camellia-256-ctr camellia-256-ecb camellia-256-ofb
des des-cbc des-cfb
des-cfb1 des-cfb8 des-ecb
des-ofb des-ede des-ede-cbc
des-ede-cfb des-ede-ecb des-ede-ofb
des-ede3 des-ede3-cbc des-ede3-cfb
des-ede3-cfb1 des-ede3-cfb8 des-ede3-ecb
des-ede3-ofb des3 desx
desx-cbc id-aes128-ccm id-aes128-gcm
id-aes192-ccm id-aes192-gcm id-aes256-ccm
id-aes256-gcm seed seed-cbc
seed-cfb seed-ecb seed-ofb
sm4 sm4-cbc sm4-cfb
sm4-ctr sm4-ecb sm4-ofb
```
### License
Node OpenSSL Enc is released under the AGPL-3.0 license, which grants the following permissions:
- Commercial use
- Modification
- Distribution
- Patent use
- Private use
For more convoluted language, see the [LICENSE](/LICENSE).
### Donate
Love the project? Please consider donating to help it improve!
[](https://github.com/sponsors/FajarKim/)
[](https://buymeacoffee.com/fajarkim/)
[](https://trakteer.id/fajarkim/)
Are you considering supporting the project by donating to me? Please DO NOT!!
Please visit [this link](https://fajarkim.github.io/donate) and make a small donation to help the people in need. A small donation goes a long way. ❤️
Made with ❤️ and JavaScript
Copyright © 2023-present Rangga Fajar Oktariansyah
