Skip to content

Latest commit

 

History

History

bring_your_own_fips202

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
custom_fips202
custom_fips202
 
 
mlkem_native
mlkem_native
 
 
test_only_rng
test_only_rng
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
main.c
main.c
 
 

README.md

Bring your own FIPS-202

This directory contains a minimal example for how to use mlkem-native as a code package, with a custom FIPS-202 implementation. We use the tiny_sha3 by Markku-J. O. Saarinen as an example.

Components

An application using mlkem-native with a custom FIPS-202 implementation needs the following:

  1. Arithmetic part of the mlkem-native source tree: mlkem/
  2. A secure pseudo random number generator, implementing randombytes.h.
  3. A custom FIPS-202 with fips202.h and fips202x4.h headers compatible with mlkem/fips202/fips202.h and mlkem/fips202/fips202x4.h.
  4. The application source code

WARNING: The randombytes() implementation used here is for TESTING ONLY. You MUST NOT use this implementation outside of testing.

Usage

Build this example with make build, run with make run.