Macro cosmian_crypto_core::kdf128

source · 
macro_rules! kdf128 {
    ($res: expr, $($bytes: expr),+) => { ... };
}
Expand description

Key Derivation Function (KDF).

Derives the given inputs to the desired length using SHAKE128, which should then be imported where this macro is used.

§Security

The input length needs to be at least 256 bits to give 128 bits of security.

source

For smaller inputs like passwords, the Argon2 algorithm should be used.

§Example

#[macro_use]
use cosmian_crypto_core::kdf128;

const KEY_LENGTH: usize = 16;

const IKM: &str = "asdf34@!dsa@grq5e$2ASGy5";

// derive a 32-bytes key
let mut key = [0; KEY_LENGTH];
kdf128!(&mut key, IKM.as_bytes());

assert_eq!(KEY_LENGTH, key.len());

let mut key2 = [0; KEY_LENGTH];
kdf128!(&mut key2, IKM.as_bytes());
assert_eq!(key, key2);

§Parameters

  • res : output to be updated in-place
  • bytes : KDF input