Struct pwbox::CipherWithMac

pub struct CipherWithMac<C, M> { /* fields omitted */ }

Authenticated cipher constructed from an ordinary symmetric cipher and a MAC construction.

See Cipher implementation for details how this implementation works.

Trait Implementations

impl<C, M> Cipher for CipherWithMac<C, M> where
    C: UnauthenticatedCipher,
    M: Mac, 

const KEY_LEN: usize

Equals to the sum of key sizes for the cipher and MAC.

const NONCE_LEN: usize

Byte size of a nonce (aka initialization vector, or IV).

const MAC_LEN: usize

Byte size of a message authentication code (MAC).

fn seal(message: &[u8], nonce: &[u8], key: &[u8]) -> CipherOutput

Works as follows:

1. Split the key into cipher_key (first bytes of the key) and mac_key (remaining bytes).
2. Encrypt the message using the cipher under cipher_key and nonce.
3. Compute MAC over the ciphertext with mac_key.

fn open(
    output: &mut [u8],
    enc: &CipherOutput,
    nonce: &[u8],
    key: &[u8]
) -> Result<(), MacMismatch>

Works as follows:

1. Split the key into cipher_key (first bytes of the key) and mac_key (remaining bytes).
2. Compute MAC over the ciphertext with mac_key. If MAC is not equal to the supplied one, return None.
3. Decrypt the ciphertext under the cipher_key and nonce.

impl<C: Debug, M: Debug> Debug for CipherWithMac<C, M>

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

Formats the value using the given formatter.