Skip to content

Add documentation for genuine check - #643

Merged
robin-nitrokey merged 4 commits into
Nitrokey:mainfrom
AdityaMitra5102:genuine-verif
Nov 12, 2026
Merged

robin-nitrokey merged 4 commits into
Nitrokey:mainfrom
AdityaMitra5102:genuine-verif

Conversation

@AdityaMitra5102

Copy link
Copy Markdown
Contributor

No description provided.

@AdityaMitra5102

Copy link
Copy Markdown
Contributor Author

I'll update them after my university work today

@jans23 jans23 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall try to make it shorter. Also avoid questions as subtitles.

@robin-nitrokey robin-nitrokey left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The text now only uses the term “authenticity” but the page is still called “genuine”/“Genuine Verification”. We should use consistent terms here.

-----------------------------------

Nitrokeys are provisioned with model-specific attestation keys. These attestation keys can only be provisioned by Nitrokey. If the firmware of the keys are tampered with, this attestation certificate will not be available anymore. The Nitrokey user applications like pynitrokey and Nitrokey App 2 offers a mechanism to cryptographically validate these certificates to ensure the firmware was not tampered with or the device was not replaced with a malicious, non-Nitrokey device.
Nitrokeys are provisioned with model-specific attestation keys. These attestation keys can only be provisioned by Nitrokey. The Nitrokey user applications like pynitrokey and Nitrokey App 2 offers a mechanism to cryptographically validate these certificates to ensure the device was not replaced with a malicious, non-Nitrokey device.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"like pynitrokey and Nitrokey App 2 offers" -> "like pynitrokey and Nitrokey App 2 offer"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed


Connect the Nitrokey and run ``nitropy nk3 test`` or ``nitropy nkpk test`` for Nitrokey 3 or Nitrokey Passkey respectively. The FIDO2 test includes the verification test. If the key passes the test, it would imply the key is authentic.

.. code-block:: shell-session

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

think this shouldn't be intended - otherwise it will be a blockquote

@robin-nitrokey

Copy link
Copy Markdown
Member

@AdityaMitra5102 Please check the CI failures.

@AdityaMitra5102

Copy link
Copy Markdown
Contributor Author

Could you pls run the CI once more

@robin-nitrokey

Copy link
Copy Markdown
Member

@daringer Please review again to unblock the merge.

@robin-nitrokey
robin-nitrokey merged commit 5a28030 into Nitrokey:main Nov 12, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants