Struct Ciphertext

Source

pub struct Ciphertext { /* private fields */ }

Expand description

A versionned ciphertext. Can be either symmetric or asymmetric.

Implementations§

Source §

impl Ciphertext

Source

pub fn decrypt(&self, key: &[u8]) -> Result<Vec<u8>>

Decrypt the data blob using a key.

§Arguments

key - Key to use. The recommended size is 32 bytes.

§Returns

Returns the decrypted data.

§Example

use devolutions_crypto::ciphertext::{ encrypt, CiphertextVersion};

let data = b"somesecretdata";
let key = b"somesecretkey";

let encrypted_data = encrypt(data, key, CiphertextVersion::Latest).unwrap();
let decrypted_data = encrypted_data.decrypt(key).unwrap();

assert_eq!(data.to_vec(), decrypted_data);

Source

pub fn decrypt_with_aad(&self, key: &[u8], aad: &[u8]) -> Result<Vec<u8>>

Decrypt the data blob using a key.

§Arguments

key - Key to use. The recommended size is 32 bytes.
aad - Additionnal data to authenticate alongside the ciphertext.

§Returns

Returns the decrypted data.

§Example

use devolutions_crypto::ciphertext::{ encrypt_with_aad, CiphertextVersion};

let data = b"somesecretdata";
let key = b"somesecretkey";
let aad = b"somepublicdata";

let encrypted_data = encrypt_with_aad(data, key, aad, CiphertextVersion::Latest).unwrap();
let decrypted_data = encrypted_data.decrypt_with_aad(key, aad).unwrap();

assert_eq!(data.to_vec(), decrypted_data);

Source

pub fn decrypt_asymmetric(&self, private_key: &PrivateKey) -> Result<Vec<u8>>

Decrypt the data blob using a PrivateKey.

§Arguments

private_key - Key to use. Must be the one in the same keypair as the PublicKey used for encryption.

§Returns

Returns the decrypted data.

§Example

use devolutions_crypto::ciphertext::{ encrypt_asymmetric, CiphertextVersion };
use devolutions_crypto::key::{ generate_keypair, KeyVersion };

let data = b"somesecretdata";
let keypair = generate_keypair(KeyVersion::Latest);

let encrypted_data = encrypt_asymmetric(data, &keypair.public_key, CiphertextVersion::Latest).unwrap();
let decrypted_data = encrypted_data.decrypt_asymmetric(&keypair.private_key).unwrap();

assert_eq!(decrypted_data, data);

Source

pub fn decrypt_asymmetric_with_aad( &self, private_key: &PrivateKey, aad: &[u8], ) -> Result<Vec<u8>>

Decrypt the data blob using a PrivateKey.

§Arguments

private_key - Key to use. Must be the one in the same keypair as the PublicKey used for encryption.
aad - Additionnal data to authenticate alongside the ciphertext.

§Returns

Returns the decrypted data.

§Example

use devolutions_crypto::ciphertext::{ encrypt_asymmetric_with_aad, CiphertextVersion };
use devolutions_crypto::key::{ generate_keypair, KeyVersion };

let data = b"somesecretdata";
let keypair = generate_keypair(KeyVersion::Latest);
let aad = b"somepublicdata";

let encrypted_data = encrypt_asymmetric_with_aad(data, &keypair.public_key, aad, CiphertextVersion::Latest).unwrap();
let decrypted_data = encrypted_data.decrypt_asymmetric_with_aad(&keypair.private_key, aad).unwrap();

assert_eq!(decrypted_data, data);