search

Nitrokey / nitrokey-documentation

User documentation of Nitrokey's products
https://docs.nitrokey.com
33 stars 34 forks source link

Incorrect documentation of pivy-tool #199

Open anotherbridge opened 7 months ago

anotherbridge commented 7 months ago

After going through the setup of creating a certificate on a Nitrokey 3 (firmware v1.5.0) described in https://docs.nitrokey.com/nitrokey3/windows/piv I was not able to get a Nitrokey recognized by pivy tool. It is always prompting pivy-tool: no PIV cards/tokens found. Are there any steps missing in the documentation? If not I would like to have the documentation clarified on that usage.
FYI: I tested this on several Linux distributions as well as macOS and got the same result everytime.

Further the documentation states the usage as pivy-tool <operation> [options] while from pivy the correct usage is pivy-tool [options] <operation>.

sosthene-nitrokey commented 7 months ago

Hi!

PIV is currently not considered stable and is therefore only available on the stable releases of the firmware. To make piv functionality available, you will need to install a test release, marked as test in the name. The latest such firmware release is version 1.5.0-test.20231030.

You can install it with nitropy nk3 update --version v1.5.0-test.20231030.

Note that since these releases are considered unstable, updating the firmware might require reset of the unstable functionality, such as PIV.

This is documented at https://docs.nitrokey.com/nitrokey3/windows/firmware-update#firmware-release-types

anotherbridge commented 7 months ago

Thanks a lot @sosthene-nitrokey

Is there already an estimate on when this feature will be available in the stable release?

daringer commented 7 months ago

see https://github.com/Nitrokey/nitrokey-3-firmware/issues/389