tc_buffered_cipher 0.2.0

One buffered interface over block modes with or without padding, stream ciphers, AEADs and asymmetric block ciphers, after Bouncy Castle's IBufferedCipher.
Documentation

tc_buffered_cipher

crates.io docs.rs CI license rustc

One buffered interface over block modes with or without padding, stream ciphers, AEADs and asymmetric block ciphers, after Bouncy Castle's IBufferedCipher. no_std, no unsafe, Rust 1.85 or later.

Types

  • FixedBufferedBlockCipher, BufferedBlockCipher (alloc) — a block mode buffered to whole blocks.
  • FixedPaddedBufferedBlockCipher, PaddedBufferedBlockCipher (alloc) — the same with padding, PKCS#7 by default.
  • BufferedStreamCipher — a stream cipher.
  • BufferedAeadBlockCipher, BufferedAeadCipher — an AEAD over a block cipher, or one that carries its own primitive.
  • FixedBufferedAsymmetricBlockCipher, BufferedAsymmetricBlockCipher (alloc) — an asymmetric cipher or encoding, such as RSA with OAEP, fed in pieces.
  • CipherDirection — encryption or decryption.
  • BufferedError — the failures of the block, stream and asymmetric adapters.

Traits

  • BufferedCipher — sizing, process_bytes, do_final and reset.
  • BufferedCipherInit — starts a message from parameters of type P.

Features

  • alloc (off by default) — the adapters sized at run time.

Usage

[dependencies]
tc_buffered_cipher = "0.2.0"
tc_block_modes = "0.1.0"
tc_aes = "0.1.0"
use tc_aes::AesEngine;
use tc_block_modes::{FixedCbcBlockCipher, KeyWithIvRef};
use tc_buffered_cipher::{BufferedCipher, BufferedCipherInit, CipherDirection, FixedPaddedBufferedBlockCipher};

let mode = FixedCbcBlockCipher::<_, 16>::new(AesEngine::new());
let mut cipher = FixedPaddedBufferedBlockCipher::<_, 16>::new(mode);
cipher.init(CipherDirection::Encrypt, &KeyWithIvRef::new(&[0x42; 16], &[0x24; 16])).expect("valid key and IV");
let mut sealed = [0; 16];
let written = cipher.process_bytes(b"attack at dawn", &mut sealed).expect("initialized");
cipher.do_final(&mut sealed[written..]).expect("room for the final block");

Security

Padded decryption is a padding oracle: the length it writes and a CorruptPadding error reveal the padding. Authenticate CBC ciphertext before decrypting it, or use an AEAD. Each adapter is constant time exactly when the cipher it wraps is; the documentation states the timing of every item.

License

Licensed under either the MIT license or the Apache License, Version 2.0, at your option.