Trait KeyDerivationFunction 

pub trait KeyDerivationFunction {
    type Algorithm: KdfAlgorithm;
    type Salt: AsRef<[u8]> + AsMut<[u8]> + Clone;

    // Required methods
    fn new() -> Self;
    fn derive_key(
        &self,
        input: &[u8],
        salt: Option<&[u8]>,
        info: Option<&[u8]>,
        length: usize,
    ) -> Result<ZeroizingBytes>;
    fn builder(&self) -> impl KdfOperation<'_, Self::Algorithm>
       where Self: Sized;
    fn generate_salt<R: RngCore + CryptoRng>(rng: &mut R) -> Result<Self::Salt>;

    // Provided method
    fn security_level() -> SecurityLevel { ... }
}

Common trait for all key derivation functions

Required Associated Types

type Algorithm: KdfAlgorithm

The algorithm this KDF implements

type Salt: AsRef<[u8]> + AsMut<[u8]> + Clone

Salt type with appropriate validation

Required Methods

fn new() -> Self

Creates a new instance of the KDF with default parameters

fn derive_key( &self, input: &[u8], salt: Option<&[u8]>, info: Option<&[u8]>, length: usize, ) -> Result<ZeroizingBytes>

Derives a key using the KDF parameters

Arguments

• input - Input keying material
• salt - Optional salt value
• info - Optional context and application-specific information
• length - Length of the output key in bytes

Returns

The derived key in exact-size, zeroizing storage.

fn builder(&self) -> impl KdfOperation<'_, Self::Algorithm>

where Self: Sized,

Creates a builder for fluent API usage - FIXED: Elided lifetime

fn generate_salt<R: RngCore + CryptoRng>(rng: &mut R) -> Result<Self::Salt>

Generate a random salt with appropriate size

Provided Methods

fn security_level() -> SecurityLevel

Returns the security level of the KDF in bits

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl<H: HashFunction + Clone, const S: usize> KeyDerivationFunction for Hkdf<H, S>

where Salt<S>: HkdfCompatible,

type Algorithm = HkdfAlgorithm<H>

type Salt = Salt<S>

impl<H: HashFunction + Clone, const S: usize> KeyDerivationFunction for Pbkdf2<H, S>

where Salt<S>: Pbkdf2Compatible,

type Algorithm = Pbkdf2Algorithm<H>

type Salt = Salt<S>

impl<H: HashFunction + Clone> KeyDerivationFunction for TypedHkdf<H>

Available on crate feature alloc only.

type Algorithm = HkdfAlgorithm<H>

type Salt = Salt<16>

impl<H: HashFunction + Clone> KeyDerivationFunction for TypedPbkdf2<H>

Available on crate feature alloc only.

type Algorithm = Pbkdf2Algorithm<H>

type Salt = Salt<16>

impl<const S: usize> KeyDerivationFunction for Argon2<S>

where Salt<S>: Argon2Compatible + Clone + Zeroize + Send + Sync + 'static, Params<S>: Default + Clone + Zeroize + Send + Sync + 'static,

type Algorithm = Argon2Algorithm

type Salt = Salt<S>