Struct aes_siv::siv::Siv

pub struct Siv<C, M> where
    C: BlockCipher<BlockSize = U16> + BlockEncryptMut + KeyInit + KeySizeUser,
    M: Mac<OutputSize = U16>, { /* private fields */ }

Synthetic Initialization Vector (SIV) mode, providing misuse-resistant authenticated encryption (MRAE).

Implementations

impl<C, M> Siv<C, M> where
    C: BlockCipher<BlockSize = U16> + BlockEncryptMut + KeyInit + KeySizeUser,
    M: Mac<OutputSize = U16> + FixedOutputReset + KeyInit, 

pub fn encrypt<I, T>(
    &mut self,
    headers: I,
    plaintext: &[u8]
) -> Result<Vec<u8>, Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Encrypt the given plaintext, allocating and returning a Vec<u8> for the ciphertext.

Errors

Returns Error if plaintext.len() is less than M::OutputSize. Returns Error if headers.len() is greater than MAX_HEADERS.

pub fn encrypt_in_place<I, T>(
    &mut self,
    headers: I,
    buffer: &mut dyn Buffer
) -> Result<(), Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Encrypt the given buffer containing a plaintext message in-place.

Errors

Returns Error if plaintext.len() is less than M::OutputSize. Returns Error if headers.len() is greater than MAX_HEADERS.

pub fn encrypt_in_place_detached<I, T>(
    &mut self,
    headers: I,
    plaintext: &mut [u8]
) -> Result<Tag, Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Encrypt the given plaintext in-place, returning the SIV tag on success.

Errors

Returns Error if plaintext.len() is less than M::OutputSize. Returns Error if headers.len() is greater than MAX_HEADERS.

pub fn decrypt<I, T>(
    &mut self,
    headers: I,
    ciphertext: &[u8]
) -> Result<Vec<u8>, Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Decrypt the given ciphertext, allocating and returning a Vec for the plaintext

pub fn decrypt_in_place<I, T>(
    &mut self,
    headers: I,
    buffer: &mut dyn Buffer
) -> Result<(), Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Decrypt the message in-place, returning an error in the event the provided authentication tag does not match the given ciphertext.

The buffer will be truncated to the length of the original plaintext message upon success.

pub fn decrypt_in_place_detached<I, T>(
    &mut self,
    headers: I,
    ciphertext: &mut [u8],
    siv_tag: &Tag
) -> Result<(), Error> where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>, 

Decrypt the given ciphertext in-place, authenticating it against the provided SIV tag.

Errors

Returns Error if the ciphertext is not authentic

Trait Implementations

impl<C, M> Drop for Siv<C, M> where
    C: BlockCipher<BlockSize = U16> + BlockEncryptMut + KeyInit + KeySizeUser,
    M: Mac<OutputSize = U16>, 

fn drop(&mut self)

Executes the destructor for this type.

impl<C, M> KeyInit for Siv<C, M> where
    C: BlockCipher<BlockSize = U16> + BlockEncryptMut + KeyInit + KeySizeUser,
    M: Mac<OutputSize = U16> + FixedOutputReset + KeyInit,
    <C as KeySizeUser>::KeySize: Add,
    KeySize<C>: ArrayLength<u8>, 

fn new(key: &GenericArray<u8, KeySize<C>>) -> Self

Create a new AES-SIV instance

fn new_from_slice(key: &[u8]) -> Result<Self, InvalidLength>

Create new value from variable size key.

fn generate_key(
    rng: impl CryptoRng + RngCore
) -> GenericArray<u8, Self::KeySize>

Generate random key using the provided CryptoRng.

impl<C, M> KeySizeUser for Siv<C, M> where
    C: BlockCipher<BlockSize = U16> + BlockEncryptMut + KeyInit + KeySizeUser,
    M: Mac<OutputSize = U16> + FixedOutputReset + KeyInit,
    <C as KeySizeUser>::KeySize: Add,
    KeySize<C>: ArrayLength<u8>, 

type KeySize = <<C as KeySizeUser>::KeySize as Add<<C as KeySizeUser>::KeySize>>::Output

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.