add info for rng use

This commit is contained in:
Conor Patrick 2019-08-16 14:03:07 +08:00
parent abd2eca3ca
commit a8baba422f
3 changed files with 21 additions and 1 deletions

View File

@ -19,7 +19,7 @@ and program it.
### Creating your attestation key pair ### Creating your attestation key pair
Since we are generating keys, it's important to use a good entropy source. Since we are generating keys, it's important to use a good entropy source.
You can use the True RNG on your Solo device to generate some good random numbers. You can use the [True RNG on your Solo](/solo/solo-extras) to generate some good random numbers.
``` ```
# Run for 1 second, then hit control-c # Run for 1 second, then hit control-c

19
docs/solo/solo-extras.md Normal file
View File

@ -0,0 +1,19 @@
# Solo Extras
## Random number generation
Solo contains a True Random Number Generator (TRNG). A TRNG is a hardware based mechanism
that leverages natural phenomenon to generate random numbers, which is often better than a traditional
RNG that has state and updates deterministically using cryptographic methods.
You can easily access the TRNG stream on Solo using our python tool [solo-python](https://github.com/solokeys/solo-python).
```
solo key rng raw > random.bin
```
Or you can seed the state of the RNG on your kernel (/dev/random).
```
solo key rng feedkernel
```

View File

@ -14,6 +14,7 @@ nav:
- Programming instructions: solo/programming.md - Programming instructions: solo/programming.md
- Bootloader mode: solo/bootloader-mode.md - Bootloader mode: solo/bootloader-mode.md
- Customization: solo/customization.md - Customization: solo/customization.md
- Solo Extras: solo/solo-extras.md
- Running on Nucleo32 board: solo/nucleo32-board.md - Running on Nucleo32 board: solo/nucleo32-board.md
- Signed update process: solo/signed-updates.md - Signed update process: solo/signed-updates.md
- Code documentation: solo/code-overview.md - Code documentation: solo/code-overview.md