diff --git a/docs/install.md b/docs/install.md index 8b1b6fe4b169f9601843aef2459ee76920e3b127..c881ac8fec6bd2bef9fbcc8c9fc413dd14beb2cd 100644 --- a/docs/install.md +++ b/docs/install.md @@ -261,5 +261,32 @@ sudo udevadm control --reload Then, you will need to unplug and replug the key for the rule to trigger. +## Verifying the installation + To test whether the installation was successful, visit a [demo website](https://webauthn.io/) and try to register and login. + +### Troubleshooting (Linux only) + +If you have issues with the demo website, the following commands should help you +understand whether OpenSK was installed properly. + +When plugging in the USB key, the following line should appear in `lsusb`. +``` +$ lsusb +... +Bus XXX Device YYY: ID 1915:521f Nordic Semiconductor ASA OpenSK +``` + +You should also see lines similar to the following in `dmesg`. +``` +$ dmesg +... +[XXX] usb A-BB: new full-speed USB device number 00 using xhci_hcd +[XXX] usb A-BB: New USB device found, idVendor=1915, idProduct=521f, bcdDevice= 0.01 +[XXX] usb A-BB: New USB device strings: Mfr=1, Product=2, SerialNumber=3 +[XXX] usb A-BB: Product: OpenSK +[XXX] usb A-BB: Manufacturer: Nordic Semiconductor ASA +[XXX] usb A-BB: SerialNumber: v0.1 +[XXX] hid-generic 0000:0000:0000.0000: hiddev0,hidraw0: USB HID v1.10 Device [Nordic Semiconductor ASA OpenSK] on usb-0000:00:00.0-00/input0 +```