From fe12b71fe488746de85032c3549c416052ad481d Mon Sep 17 00:00:00 2001
From: Jan A <jolo1581@gmail.com>
Date: Thu, 2 Apr 2020 16:03:25 +0200
Subject: [PATCH] Added new site with questions about Solo. There were some
 questions about pin support in issue 349, which are now written into
 documentation

---
 docs/solo/questions.md | 38 ++++++++++++++++++++++++++++++++++++++
 mkdocs.yml             |  1 +
 2 files changed, 39 insertions(+)
 create mode 100644 docs/solo/questions.md

diff --git a/docs/solo/questions.md b/docs/solo/questions.md
new file mode 100644
index 00000000..289c8725
--- /dev/null
+++ b/docs/solo/questions.md
@@ -0,0 +1,38 @@
+#Questions
+## Pin Support
+**1. Does SoloKey implement PIN-support?**
+
+Yes
+
+
+**2. Is the Pin stored and checked inside the SoloKey?**
+
+The pin is stored on the key not in plain text. Only the pin hash is stored. For more information see:
+ 
+- [Fidoallicace specification: setting new pin][fido2_new_pin] 
+- [Fidoallicance specification: authentificator client pin][fido2_client_pin].
+
+
+**3. What happens if someone enters a faulty pin many times?**
+
+After **M** wrong PINs, you have to powercycle.<br>
+After **N** wrong PINs, you have to fully reset the key to use it again.<br>
+Constants can be find in repository under [solo/fido2/ctap.h][ctap_constants]
+
+Actually the constants are:
+
+- M (PIN_BOOT_ATTEMPTS):    3 times before reboot
+- N (PIN_LOCKOUT_ATTEMPTS): 8 times before fully reset
+
+
+
+
+
+
+
+
+
+[//]: # "links"
+[ctap_constants]: https://github.com/solokeys/solo/blob/master/fido2/ctap.h
+[fido2_new_pin]: https://fidoalliance.org/specs/fido-v2.0-ps-20190130/fido-client-to-authenticator-protocol-v2.0-ps-20190130.html#settingNewPin)
+[fido2_client_pin]: https://fidoalliance.org/specs/fido-v2.0-ps-20190130/fido-client-to-authenticator-protocol-v2.0-ps-20190130.html#authenticatorClientPIN
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 9baf8019..906e6c02 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,6 +15,7 @@ nav:
     - Bootloader mode: solo/bootloader-mode.md
     - Customization: solo/customization.md
     - Solo Extras: solo/solo-extras.md
+    - Questions about Solo: solo/questions.md  
     - Application Ideas: solo/application-ideas.md
     - Running on Nucleo32 board: solo/nucleo32-board.md
     - Signed update process: solo/signed-updates.md