From 5753872f259905dc34921a12975b57bb19a2cac1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joachim=20Stro=CC=88mbergson?= Date: Thu, 11 Sep 2014 16:31:20 +0200 Subject: Adding readme and license for the trng core. --- LICENSE.txt | 27 ++++++++++ README.md | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 193 insertions(+) create mode 100644 LICENSE.txt create mode 100644 README.md diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..b70e7ad --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,27 @@ +Copyright (c) 2014, NORDUnet A/S All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: +- Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + +- Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +- Neither the name of the NORDUnet nor the names of its contributors may + be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS +IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..9446500 --- /dev/null +++ b/README.md @@ -0,0 +1,166 @@ +trng +==== + +True Random Number Generator core implemented in Verilog. + +## Introduction ## +This repo contains the design of a True Random Number Generator (TRNG) +for the [Cryptech OpenHSM](http://cryptech.is/) project. + + +## Design inspiration, ideas and principles ## + +The TRNG **MUST** be a really good one. Furthermore it must be trustable +by its users. That means it should not do wild and crazy stuff. And +users should be able to verify that the TRNG works as expected. + +* Follow best practice +* Be conservative - No big untested ideas. +* Support transparency - The parts should be testable. + + +Some of our inspiration comes from: +* The Fortuna RNG by Ferguson and Schneier as described in Cryptography +Engineering. + +* /dev/random in OpenBSD + + +## System description ## + +The TRNG consists of a chain with three main subsystems + +* Entropy generation +* Entropy accumulation (mixer) +* Random generation + + +### Entropy generation ### + +The entropy generation subsystems consists of at least two separate entropy +generators. Each generator collects entropy from an independent physical +process. The entropy sources MUST be of different types. For example +avalance noise from a reversed bias P/N junction as one source and RSSI +LSB from a receiver. + +The reason for having multiple entropy sources is both to provide +reduncancy as well as making it harder for an attacker to affect the +entropy collection by forcing the attacker to try and affect different +physical processes simultaneously. + +A given entropy generator is responsible for collecting the entropy +(possibly including A/D conversion.). The entropy generator MUST +implement some on-line testing of the physical entropy source based on +the entropy collected. The tests shall be described in detail here but +will at least include tests for: + +* No long run lengths in generated values. +* Variance that exceeds a given threshhold. +* Mean value that don't deviate from expected mean. +* Frequency for all possible values are within expected variance. + +If the tests fails over a period of generated values the entropy source +MUST raise an error flag. And MAY also block access to the entropy it +otherwise provides. + +There shall also be possible to read out the raw entropy collected from +a given entropy generator. This MUST ONLY be possible in a specific +debug mode when no random generation is allowed. Also the entropy +provided in debug mode MUST NOT be used for later random number +generation. + +The entropy generator SHALL perform whitening on the collected entropy +before providing it as 32-bit values to the entropy accumulator. + + + +### Entropy accumulation ### + +The entropy acculumation subsystems reads 32-bit words from the entropy +generators. + +When 1024 bits of mixed entropy has been collected the entropy is used +as a message block which is fed into a hash function. + +The hash function used is SHA-512 (NIST FIPS 180-4). + +The digest is then extracted and provided to the random generation as as +a seed. + + +### Random generation ### + +The random generation consists of a cryptographically safe pseudo random +number generator (CSPRNG). The CSPRNG used in the trng is the strea +cipher ChaCHa. + +ChaCha is seeded with: +- 512 bits block +- 256 bits key +- 64 bits IV +- 64 bits counter + +In total the seed used is: 896 bits. This requires getting two seed +blocks of 512 bits from the mixer. + +The number of rounds used in ChaCha is conservatively +selected. We propose that the number of rounds shall be at least 24 +rounds. Possibly 32 rounds. Given the performance in HW for ChaCha and +the size of the keystream block, the TRNG should be able to generate +plentiful of random values even with 32 rounds. + +The random generator shall support the ability to test its functionality +by seeding it with a user supplied value and then generate a number of +values in a specific debug mode. The normal access to generated random +values MUST NOT be allowed during the debug mode. The random generator +MUST also set an error flag during debug mode. Finally, when exiting the +debug mode, reseeding MUST be done. + +Finally the random generator provides random numbers as 32-bit +values. the 512 bit keystream blocks from ChaCha are divided into 16 +32-bit words and provided in sequence. + + +## Implementation details ## + +The core supports multpiple entropy sources as well as a CSPRNG. For +each entropy source there are some estimators that checks that the +sources are not broken. + +There are also an ability to extract raw entropy as well as inject test +data into the CSPRNG to verify the functionality. + +The core will include one FPGA based entropy source but expects the +other entropy source(s) to be connected on external ports. It is up to +the user/system implementer to provide physical entropy souces. We will +suggest and provide info on how to design at least one such source. + + +## API ## + +Normal operation: +* Extract 32-bit random words. + + +Config parameters: +* Number of blocks in warm-up. +* Number of keystream blocks before reseeding. + + +Debug access +* Enable/disable entropy generator X +* Check health of entropy generator X +* Read raw entropy from entropy generator X as 32-bit word. +* Write 256 bit seed value as 8 32-bit words +* Read out one or more 512 bit keystream blocks as 32-bit words. + + + +## Status ## + +*** (2014-09-11) *** + +The first version of the CSPRNG is debugged and completed. This version +supports automatic reseeding and an output fifo. + + -- cgit v1.2.3