ic-mac 0.2.9

HMAC, CMAC, KMAC, and Poly1305 message authentication for IronCrypto
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

//! # ic-mac — message authentication codes
//!
//! * [`Hmac`] — FIPS 198-1, generic over any [`Digest`](ic_core::traits::Digest) in `ic-hash`.
//! * [`CmacAes128`] / [`CmacAes256`] — SP 800-38B CMAC over AES.
//! * [`Poly1305`] — re-exported from `ic-cipher` for one-time authentication.
//!
//! All verification goes through [`ic_core::ct::verify`], so tag comparison
//! cannot become a timing oracle.
//!
//! ```
//! use ic_mac::HmacSha256;
//! use ic_core::traits::Mac;
//!
//! let tag = HmacSha256::mac(b"key", b"message")?;
//! HmacSha256::verify(b"key", b"message", tag.as_ref())?;
//! assert!(HmacSha256::verify(b"key", b"tampered", tag.as_ref()).is_err());
//! # Ok::<(), ic_core::Error>(())
//! ```
#![cfg_attr(not(feature = "std"), no_std)]
#![forbid(unsafe_code)]
#![deny(missing_docs)]
#![warn(clippy::all)]

mod cmac;
mod hmac;
mod kmac;

pub use cmac::{CmacAes128, CmacAes192, CmacAes256};
pub use hmac::{
    Hmac, HmacSha256, HmacSha384, HmacSha3_256, HmacSha3_512, HmacSha512, HmacSha512_256,
};
pub use ic_cipher::Poly1305;
pub use kmac::{Kmac128, Kmac256};

/// Ontology identifiers for the MACs this crate provides.
pub const MAC_IDS: &[&str] = &[
    "hmac-sha2-256",
    "hmac-sha2-384",
    "hmac-sha2-512",
    "hmac-sha2-512-256",
    "hmac-sha3-256",
    "hmac-sha3-512",
    "cmac-aes-128",
    "cmac-aes-192",
    "cmac-aes-256",
    "poly1305",
];