aes-kw 0.3.1

NIST 800-38F AES Key Wrap (KW) and Key Wrap with Padding (KWP) modes
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

#![no_std]
#![doc = include_str!("../README.md")]
#![doc(
    html_logo_url = "https://raw.githubusercontent.com/RustCrypto/media/6ee8e381/logo.svg",
    html_favicon_url = "https://raw.githubusercontent.com/RustCrypto/media/6ee8e381/logo.svg"
)]
#![cfg_attr(docsrs, feature(doc_cfg))]
#![forbid(unsafe_code)]
#![warn(missing_docs, rust_2018_idioms)]

#[cfg(feature = "oid")]
mod oid;

mod ctx;
mod error;
mod kw;
mod kwp;

use aes::cipher::consts::U8;
use aes::cipher::typenum::Unsigned;
pub use error::{Error, IntegrityCheckFailed};
pub use kw::AesKw;
pub use kwp::AesKwp;

pub use aes;
pub use aes::cipher;
pub use aes::cipher::{KeyInit, common::InnerInit};

#[cfg(feature = "zeroize")]
pub use zeroize;

/// AES-128 key wrapping
pub type KwAes128 = AesKw<aes::Aes128>;
/// AES-192 key wrapping
pub type KwAes192 = AesKw<aes::Aes192>;
/// AES-256 key wrapping
pub type KwAes256 = AesKw<aes::Aes256>;

/// AES-128 key wrapping
pub type KwpAes128 = AesKwp<aes::Aes128>;
/// AES-192 key wrapping
pub type KwpAes192 = AesKwp<aes::Aes192>;
/// AES-256 key wrapping
pub type KwpAes256 = AesKwp<aes::Aes256>;

/// Size of an AES-KW and AES-KWP initialization vector in bytes represented as a `typenum` type.
pub type IvLen = U8;
/// Size of an AES-KW and AES-KWP initialization vector in bytes.
///
/// This value is equal to "semiblock" size. From NIST SP 800-38F ยง 4.1:
///
/// > semiblock: given a block cipher, a bit string whose length is half of the block size.
pub const IV_LEN: usize = IvLen::USIZE;