Git-Mirrors/tillitis-key
1
0
Fork 0
mirror of https://github.com/tillitis/tillitis-key1.git synced 2024-12-18 12:24:31 -05:00
Code Issues Packages Projects Releases Wiki Activity

Reference a bit more

Browse Source 
Try to make it a bit easier to understand "measure" and where to read
more.
This commit is contained in:
Daniel Lublin 2022-09-21 08:55:13 +02:00
parent fcae028007
commit 98c2463dbc
No known key found for this signature in database
GPG Key ID: 75BD0FEB8D3E7830
4 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@ -9,8 +9,8 @@ different, as other security tokens utilize closed source hardware for
its security-critical operations. its security-critical operations.
What makes the Tillitis Key 1 security token unique is that it doesn’t What makes the Tillitis Key 1 security token unique is that it doesn’t
verify applications, it measures them, before running them on its open verify applications, it measures them (hashes a digest over the
hardware security processor. binary), before running them on its open hardware security processor.
Each security token contains a Unique Device Secret (UDS), Each security token contains a Unique Device Secret (UDS),
which together with an application measurement, and an optional which together with an application measurement, and an optional

7
doc/quickstart.md
View File

@ -52,6 +52,13 @@ your computer (use the USB-C-to-A adapter if needed) and will boot the
firmware. When boot has completed it will start flashing the LED firmware. When boot has completed it will start flashing the LED
white. This indicates that it is ready to receive and measure an app. white. This indicates that it is ready to receive and measure an app.
To try out an app, continue to the README.md the apps repo:
https://github.com/tillitis/tillitis-key1-apps#readme
To learn more about the concepts and workings of the firmware, see:
[system_description/system_description.md](system_description/system_description.md)
and [system_description/software.md](system_description/software.md).
# Device personalization # Device personalization
To personalize Tillitis Key 1, you need to modify the hex file that To personalize Tillitis Key 1, you need to modify the hex file that

6
doc/system_description/software.md
View File

@ -5,7 +5,11 @@
* Firmware -- software that is part of ROM, and is currently * Firmware -- software that is part of ROM, and is currently
supplied via the FPGA bit stream. supplied via the FPGA bit stream.
* Application -- software supplied by the host machine, which is * Application -- software supplied by the host machine, which is
received, loaded, and measured by the firmware. received, loaded, and measured by the firmware (by hashing a
digest over the binary).
Learn more about the concepts in the
[system_description.md](system_description.md).
## CPU ## CPU

4
doc/system_description/system_description.md
View File

@ -35,8 +35,8 @@ user. Some examples of such security functionality are:
### Measured Based Security ### Measured Based Security
The key, unique feature of the TK1 is that it measures the secure The key, unique feature of the TK1 is that it measures the secure
application when the application is being loaded onto the device. The application when the application is being loaded onto the device. The
measurement, combined with a Unique Device Secret (UDS) is used to measurement (a hash digest), combined with a Unique Device Secret
derive secrets for the application. (UDS) is used to derive secrets for the application.
The consequence of this is that if the application is altered, the keys The consequence of this is that if the application is altered, the keys
derived will also change. Conversely, if the keys derived are the same as derived will also change. Conversely, if the keys derived are the same as