google / OpenSK

OpenSK is an open-source implementation for security keys written in Rust that supports both FIDO U2F and FIDO2 standards.
Apache License 2.0
3k stars 291 forks source link

Document how to check whether the device is working #27

Closed markushx closed 4 years ago

markushx commented 4 years ago

Expected Behavior

Documentation should explain what to expect after the device has been flashed. Is there supposed to be a ttyUSB? How do you check whether the device works properly (https://webauthn.io/)?

Actual Behavior

Only setup, compiling, flashing is documented.

Steps to Reproduce the Problem

  1. Follow documentation
ibndias commented 4 years ago

In my case, i checked it by going to webauthn, don't forget to push reset the board (mine is the DK version), insert my name, then try Register. It will ask for your secure device and touch any button available (in my case there are 4 buttons, any of these will work). After that your name will be registered. Then you can login with your name and authenticate again.

Or you can just watch this video

kaczmarczyck commented 4 years ago

Can you please clarify your question or confirm? My understanding is: You would like us to mention webauthn.io in our documentation as the recommended end-to-end test after flashing OpenSK? Or is this asking for other ways to test your security key?

markushx commented 4 years ago

Yes, I think the documentation should mention how the device would appear in dmesg, lsusb and/or in /dev/tty* as well as a basic test of the security functionality with webauthn.io.