#password #encryption-decryption #file-encryption #encryption #decryption

bin+lib secured

A lightweight, easy-to-use Rust package for file encryption and decryption, suitable for both CLI and library integration in Rust applications

9 releases (5 breaking)

0.6.0 Dec 19, 2023
0.5.1 Dec 18, 2023
0.4.0 Dec 3, 2023
0.3.0 Dec 2, 2023
0.1.2 Nov 29, 2023

#2094 in Cryptography

44 downloads per month

MIT license

93KB
1.5K SLoC

secured

A very fast CLI tool for encryption and decryption of large amounts of data

https://github.com/mikesposito/secured/assets/34438276/d82874b2-348d-4ade-860c-79e393bfd87e

[!WARNING] As this crate is under early development, APIs are rapidly changing, and so is the documentation.

Features

  • Encryption and Decryption: Easily encrypt and decrypt files with password or a pre-generated encryption key.
  • Key Derivation: Generate encryption keys from passwords with customizable iterations and salt.
  • File Inspection: Inspect details of secured files.

Installation

To use secured as a CLI tool or integrate it into your Rust project, ensure you have Rust installed, then:

As a CLI tool

cargo install secured

As a Library

cargo add secured

Usage

Encrypting a Single File

Encrypt a single file with a password. If no password is provided, the tool will prompt you for it.

secured encrypt secret.txt

Decrypting a Single File

Decrypt a single file with a password. If no password is provided, the tool will prompt you for it.

secured decrypt secret.txt.secured

Encrypting/Decrypting Multiple Files with Glob Patterns

Use glob patterns to encrypt or decrypt multiple files with a single command.

secured encrypt data/*.txt
secured decrypt data/*.txt.secured

Generating Encryption Key

Generate an encryption key from a password with customizable iterations and salt.

secured key --password my_secret_password --iterations 1000000 --salt abcdef1234567890

Inspecting Secured Files

Inspect details of one or more secured files.

secured inspect secret.txt.secured
secured inspect data/*.txt.secured

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

License

Secured is distributed under the MIT License. See LICENSE for more information.

Dependencies

~5–16MB
~159K SLoC