FlowEncrypt 1.1.0

FlowEncrypt

<img src="https://raw.githubusercontent.com/forReason/FlowEncrypt/master/FlowEncryptLogo.png" width="200" height="200">

Description

FlowEncrypt is a C# library providing robust encryption and decryption functionalities for files and in-memory data. Utilizing AES encryption with support for asymmetric key encryption of the salt, this library ensures secure handling of sensitive data.

Features

• Encrypt and decrypt data streams, files and byte arrays (IEnumerable).
• Support for RSA public/private key pair for salt encryption in AES.
• Simple and intuitive API.
• Secure and efficient implementation.

Getting Started

Prerequisites

• .NET 8.0 or later.

Installation

Clone the repository to your local machine:

git clone https://github.com/forReason/FlowEncrypt.git

Usage

File Encryption and Decryption

string inputFile = "path/to/input.txt";
string encryptedFile = "path/to/encrypted.txt";
string decryptedFile = "path/to/decrypted.txt";
string password = "yourStrongPassword";

// Encrypting a file
EncryptFiles.Encrypt(inputFile, eoutputFile, password);

// Decrypting a file
EncryptFiles.Decrypt(inputFile, outputFile, password);

In-Memory Data Encryption and Decryption

string originalText = "Hello, World!";
IEnumerable<byte> data = Encoding.UTF8.GetBytes(originalText);

// Encrypting data
IEnumerable<byte> encryptedData = EncryptData.Encrypt(data, password);

// Decrypting data
IEnumerable<byte> decryptedData = EncryptData.Decrypt(encryptedData, password);

Usage with streams

Basic Encryption

using MemoryStream outputStream = new MemoryStream(dataToEncrypt);
using (EncryptingStream encryptStream = new (outputStream, password, publicKey: null))
{
    encryptStream.Write(originalData, 0, originalData.Length);
}

Basic Decryption

using MemoryStream inputStream = new MemoryStream(encryptedData);
using DecryptingStream decryptStream = new DecryptingStream(inputStream, password);

using StreamReader reader = new StreamReader(decryptStream);
string decryptedText = reader.ReadToEnd();

Encryption with Public Key

If the data was encrypted using a public key:

(X509Certificate2 PublicKey, X509Certificate2 PrivateKey) keys = HelperFunctions.GenerateKeys();

using MemoryStream outputStream = new ();
using (EncryptingStream encryptStream = new (outputStream, password, keys.PublicKey))
{
    encryptStream.Write(originalData, 0, originalData.Length);
}

Decryption with Private Key

If the data was encrypted using a public key:

(X509Certificate2 PublicKey, X509Certificate2 PrivateKey) keys = HelperFunctions.GenerateKeys();

using MemoryStream inputStream = new MemoryStream(encryptedDataWithPublicKey);
using DecryptingStream decryptStream = new DecryptingStream(inputStream, password, keys.PrivateKey);

using StreamReader reader = new StreamReader(decryptStream);
string decryptedTextWithPrivateKey = reader.ReadToEnd();

Notes

• Ensure that the EncryptStream and DecryptStream are properly disposed of to release all resources.
• For encryption with a public key, ensure the corresponding private key is available for decryption.
• These classes are designed to work seamlessly with streams, making them versatile for various data sources.

Contributing

Contributions are welcome! Please read our Contributing Guide for more information.

License

This project is licensed under the MIT License.