#authenticated-encryption #aead #data #mode #security #rfc7253 #ocb

no-std ocb3

Pure Rust implementation of the Offset Codebook Mode v3 (OCB3) Authenticated Encryption with Associated Data (AEAD) Cipher as described in RFC7253

2 unstable releases

0.1.0 Mar 27, 2024
0.0.0 May 5, 2021

#2505 in Cryptography

Download history 3764/week @ 2024-08-20 4282/week @ 2024-08-27 3881/week @ 2024-09-03 3777/week @ 2024-09-10 4061/week @ 2024-09-17 2834/week @ 2024-09-24 4191/week @ 2024-10-01 4251/week @ 2024-10-08 4785/week @ 2024-10-15 5205/week @ 2024-10-22 5725/week @ 2024-10-29 5290/week @ 2024-11-05 5192/week @ 2024-11-12 6415/week @ 2024-11-19 7198/week @ 2024-11-26 7052/week @ 2024-12-03

26,724 downloads per month
Used in 26 crates (2 directly)

Apache-2.0 OR MIT

29KB
452 lines

RustCrypto: OCB3

crate Docs Apache2/MIT licensed Rust Version Project Chat Build Status

Pure Rust implementation of the Offset Codebook Mode v3 (OCB3) Authenticated Encryption with Associated Data (AEAD) cipher as described in RFC7253.

Documentation

Example

use aes::Aes128;
use ocb3::{
    aead::{Aead, AeadCore, KeyInit, OsRng, generic_array::GenericArray},
    consts::U12,
    Ocb3,
};

type Aes128Ocb3 = Ocb3<Aes128, U12>;

let key = Aes128::generate_key(&mut OsRng);
let cipher = Aes128Ocb3::new(&key);
let nonce = Aes128Ocb3::generate_nonce(&mut OsRng);
let ciphertext = cipher.encrypt(&nonce, b"plaintext message".as_ref()).unwrap();
let plaintext = cipher.decrypt(&nonce, ciphertext.as_ref()).unwrap();

assert_eq!(&plaintext, b"plaintext message");

Security Notes

No security audits of this crate have ever been performed, and it has not been thoroughly assessed to ensure its operation is constant-time on common CPU architectures.

USE AT YOUR OWN RISK!

License

Licensed under either of:

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~415–730KB
~15K SLoC