#hmac #sha1

hmac-sha1

A simple wrapper around the RustCrypto hmac and sha1 crates for simple HMAC-SHA1 generation

5 releases

0.2.2 Dec 8, 2023
0.2.1 Oct 22, 2023
0.1.3 Sep 24, 2016
0.1.2 Sep 24, 2016
0.1.1 Sep 21, 2016

#156 in Cryptography

Download history 7944/week @ 2023-11-04 8720/week @ 2023-11-11 7968/week @ 2023-11-18 8221/week @ 2023-11-25 7691/week @ 2023-12-02 8549/week @ 2023-12-09 7714/week @ 2023-12-16 3414/week @ 2023-12-23 7811/week @ 2023-12-30 11159/week @ 2024-01-06 9154/week @ 2024-01-13 8953/week @ 2024-01-20 7723/week @ 2024-01-27 7654/week @ 2024-02-03 8249/week @ 2024-02-10 7398/week @ 2024-02-17

32,722 downloads per month
Used in 51 crates (16 directly)

BSD-3-Clause

7KB
70 lines

Rust-HMAC-SHA1

crates.io version

A simple wrapper around the RustCrypto hmac and sha1 crates for simple HMAC-SHA1 generation.

Functionality Note

As the crate is now a thin wrapper around RustCrypto, please note that this crate can be replaced with the following code:

use sha1::Sha1;
use hmac::{Hmac, Mac};

pub fn main() {
    ...

    // Create the hasher with the key. We can use expect for Hmac algorithms as they allow arbitrary key sizes.
    let mut hasher: Hmac<Sha1> = Mac::new_from_slice(key) .expect("HMAC algoritms can take keys of any size");

    // hash the message
    hasher.update(message);

    // finalize the hash and convert to a static array
    let hmac: [u8;20] = hasher.finalize().into_bytes().into()

    ...
}

Usage

To import rust-hmac-sha1 add the following to your Cargo.toml:

[dependencies]
hmac-sha1 = "^0.2"

To use rust-hmac-sha1, simply use the single provided function:

let hmac_digest: [u8; hmac_sha1::SHA1_DIGEST_BYTES] = hmac_sha1::hmac_sha1(key, message);

Contributions

Any contributions are welcome.

This was implemented as a learning experience - an implementation for hmac-sha1 from just a SHA1 hasher is included in 0.1.x versions.

License

This crate is licensed under the BSD 3-Clause license.

This crate also depends on the RustCrypto Project to provide the underlying cryptographic implementations. These crates are dual licensed under MIT and Apache-2.0.

Dependencies

~465KB