Skip to content

blake2: add unkeyed hashing#612

Merged
newpavlov merged 1 commit intoRustCrypto:masterfrom
threema-theo:blake2b-keyless
Jan 17, 2025
Merged

blake2: add unkeyed hashing#612
newpavlov merged 1 commit intoRustCrypto:masterfrom
threema-theo:blake2b-keyless

Conversation

@threema-theo
Copy link
Contributor

This introduces unkeyed hashing for blake2 as specified in Section 2.5 of RFC 7693 states the following:

The second (little-endian) byte of the parameter block, "kk", specifies the key size in bytes. Set kk = 00 for unkeyed hashing.

I propose to make the key an Option<&[u8]>:

pub fn new_with_salt_and_personal(
    key: Option<&[u8]>, 
    salt: &[u8], 
    persona: &[u8],
) -> Result<Self, InvalidLength>

By making the key an Option<&[u8]> - rather than opting for the unkeyed usage in case of an empty key - we make the unkeyed usage explicit and avoid inadvertent usages.

This closes #482.
See also #509.

Copy link
Member

@newpavlov newpavlov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@newpavlov newpavlov merged commit 01e79f7 into RustCrypto:master Jan 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Blake2 parameters cannot be used without a key

2 participants