Skip to content

bring_your_own_fips202

Directory actions

More options

Directory actions

More options

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 tiny_sha31 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/src/
  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/src/fips202/fips202.h and mlkem/src/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.

Footnotes

  1. Markku-Juhani O. Saarinen: tiny_sha3, https://github.com/mjosaarinen/tiny_sha3 ↩