Enum Cipher 

pub enum Cipher {
    None,
    Aes128Xts(Cipher),
    Aes256Xts(Cipher),
    Aes256Gcm(Cipher),
}

Cipher object to encrypt/decrypt data.

Variants

None

Aes128Xts(Cipher)

Aes256Xts(Cipher)

Aes256Gcm(Cipher)

Implementations

impl Cipher

pub fn encrypt<'a>( &self, key: &[u8], iv: Option<&[u8]>, data: &'a [u8], ) -> Result<Cow<'a, [u8]>, Error>

Encrypt plaintext with optional IV and return the encrypted data.

For XTS, the caller needs to ensure that the top half of key is not identical to the bottom half of the key, otherwise the encryption will fail.

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

Decrypt encrypted data with optional IV and return the decrypted data.

pub fn encrypt_aead( &self, key: &[u8], iv: Option<&[u8]>, data: &[u8], tag: &mut [u8], ) -> Result<Vec<u8>, Error>

Encrypt plaintext and return the ciphertext with authentication tag.

pub fn decrypt_aead( &self, key: &[u8], iv: Option<&[u8]>, data: &[u8], tag: &[u8], ) -> Result<Vec<u8>, Error>

Decrypt plaintext and return the encrypted data with authentication tag.

pub fn tag_size(&self) -> usize

Get size of tag associated with encrypted data.

pub fn encrypted_size(&self, plaintext_size: usize) -> usize

Get size of ciphertext from size of plaintext.

pub fn tweak_key_for_xts(key: &[u8]) -> Cow<'_, [u8]>

Tweak key for XTS mode.

pub fn generate_random_key(cipher_algo: Algorithm) -> Result<Vec<u8>, Error>

pub fn generate_random_iv() -> Result<Vec<u8>, Error>

Trait Implementations

impl Debug for Cipher

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Cipher

fn default() -> Cipher

Returns the “default value” for a type.