Struct ccm::Ccm

pub struct Ccm<C, M, N>
where
    C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt,
    M: ArrayLength<u8> + TagSize,
    N: ArrayLength<u8> + NonceSize,
{ /* private fields */ }

CCM instance generic over an underlying block cipher.

Type parameters:

• C: block cipher.
• M: size of MAC tag in bytes, valid values: U4, U6, U8, U10, U12, U14, U12.
• N: size of nonce, valid values: U7, U8, U9, U10, U11, U12, U13.

Trait Implementations

impl<C, M, N> AeadCore for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt, M: ArrayLength<u8> + TagSize, N: ArrayLength<u8> + NonceSize,

type NonceSize = N

The length of a nonce.

type TagSize = M

The maximum length of the nonce.

type CiphertextOverhead = UTerm

The upper bound amount of additional space required to support a ciphertext vs. a plaintext.

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

where GenericArray<u8, Self::NonceSize>: Default,

Generate a random nonce for this AEAD algorithm.

impl<C, M, N> AeadInPlace for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt, M: ArrayLength<u8> + TagSize, N: ArrayLength<u8> + NonceSize,

fn encrypt_in_place_detached( &self, nonce: &Nonce<N>, adata: &[u8], buffer: &mut [u8], ) -> Result<Tag<Self::TagSize>, Error>

Encrypt the data in-place, returning the authentication tag

fn decrypt_in_place_detached( &self, nonce: &Nonce<N>, adata: &[u8], buffer: &mut [u8], tag: &Tag<Self::TagSize>, ) -> Result<(), Error>

Decrypt the message in-place, returning an error in the event the provided authentication tag does not match the given ciphertext (i.e. ciphertext is modified/unauthentic)

fn encrypt_in_place( &self, nonce: &GenericArray<u8, Self::NonceSize>, associated_data: &[u8], buffer: &mut dyn Buffer, ) -> Result<(), Error>

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

fn decrypt_in_place( &self, nonce: &GenericArray<u8, Self::NonceSize>, associated_data: &[u8], buffer: &mut dyn Buffer, ) -> Result<(), Error>

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

impl<C, M, N> Clone for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt + Clone, M: ArrayLength<u8> + TagSize + Clone, N: ArrayLength<u8> + NonceSize + Clone,

fn clone(&self) -> Ccm<C, M, N>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C, M, N> From<C> for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt, M: ArrayLength<u8> + TagSize, N: ArrayLength<u8> + NonceSize,

fn from(cipher: C) -> Self

Converts to this type from the input type.

impl<C, M, N> KeyInit for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt + KeyInit, M: ArrayLength<u8> + TagSize, N: ArrayLength<u8> + NonceSize,

fn new(key: &Key<Self>) -> Self

Create new value from fixed size key.

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, N> KeySizeUser for Ccm<C, M, N>

where C: BlockCipher + BlockSizeUser<BlockSize = U16> + BlockEncrypt + KeyInit, M: ArrayLength<u8> + TagSize, N: ArrayLength<u8> + NonceSize,

type KeySize = <C as KeySizeUser>::KeySize

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.