KMAC-SHA3

KMAC algorithm based on SHA3, with 128 and 256 bit security. More...

Files
file	ocrypto_kmac.h
	KMAC algorithm based on SHA3, with 128 and 256 bit security.

Functions
void	ocrypto_kmac128 (uint8_t *r, size_t r_len, const uint8_t *key, size_t key_len, const uint8_t *in, size_t in_len, const uint8_t *s, size_t s_len)
void	ocrypto_kmac256 (uint8_t *r, size_t r_len, const uint8_t *key, size_t key_len, const uint8_t *in, size_t in_len, const uint8_t *s, size_t s_len)

Incremental KMAC generator
This group of functions can be used to incrementally compute the KMAC authenticator for a given message.
void	ocrypto_kmac128_init (ocrypto_kmac_ctx *ctx, const uint8_t *key, size_t key_len, const uint8_t *s, size_t s_len)
void	ocrypto_kmac256_init (ocrypto_kmac_ctx *ctx, const uint8_t *key, size_t key_len, const uint8_t *s, size_t s_len)
void	ocrypto_kmac128_update (ocrypto_kmac_ctx *ctx, const uint8_t *in, size_t in_len)
void	ocrypto_kmac256_update (ocrypto_kmac_ctx *ctx, const uint8_t *in, size_t in_len)
void	ocrypto_kmac128_final (ocrypto_kmac_ctx *ctx, uint8_t *r, size_t r_len)
void	ocrypto_kmac256_final (ocrypto_kmac_ctx *ctx, uint8_t *r, size_t r_len)

Detailed Description

KMAC algorithm based on SHA3, with 128 and 256 bit security.

The KMAC family is a set of cryptographic MAC functions based on SHA3 and cSHAKE.

A fixed-sized message digest is computed from variable length input data. The function is practically impossible to revert, and small changes in the input message lead to major changes in the message digest.

See also

FIPS - SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions

NIST - SHA-3 Derived Functions: cSHAKE, KMAC, TupleHash and ParallelHash