Skip to content

Commit

Permalink
Add information to CSR generation
Browse files Browse the repository at this point in the history
  • Loading branch information
mmerklinger committed Jan 15, 2024
1 parent e4499a8 commit 8bcb489
Showing 1 changed file with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions nitrokey3/windows/piv.rst
Original file line number Diff line number Diff line change
Expand Up @@ -53,13 +53,22 @@ This step can take a couple of minutes for RSA keys, as the pure software implem
2. Generate a Certificate Signing Request (CSR)
-----------------------------------------------

This step generates a certificate for the key in the authentication slot. ``pivy-tool -n 'Nitro Test' -u "[email protected]" -T user-auth req-cert 9A``
The following command generates a certificate signing request (CSR) for the key in the authentication slot.

The ``Nitro Test`` username and the ``[email protected]`` email address must be changed to own values.
.. code-block::
pivy-tool -n <cn-or-dn> -u <upn> -T user-auth req-cert 9A
Expected output:
In the above command replace ``<cn-or-dn>`` and ``<upn>`` with their respective values.
The values are based on the Active Directory user account, for which the CSR is generated.
The value for ``<cn-or-dn>`` is the value of the ``commonName`` attribute.
Depending on the *Workstation Authentication Template* configuration this field might needs to contain the value from the ``distinguishedName`` attribute.
The value for ``<upn>`` is the value of the ``userPrincipal`` attribute.

A successful generation of the CSR returns the certificate request in PEM format.

.. code-block::
-----BEGIN CERTIFICATE REQUEST-----
MIIC4DCCAcgCAQEwFTETMBEGA1UEAwwKTml0cm8gVGVzdDCCASIwDQYJKoZIhvcN
AQEBBQADggEPADCCAQoCggEBAMo7kQ3CsreooECAOTKrW1+LDknGegIQiIzdVz7w
Expand All @@ -79,7 +88,7 @@ Expected output:
eGQvuPRBmR71GRkGmqu+e1oyze8=
-----END CERTIFICATE REQUEST-----
Copy the certificate signing request to a file ``request.csr``
Save the certificate signing request to a file ``request.csr``

3. Sign the CSR
---------------
Expand Down

0 comments on commit 8bcb489

Please sign in to comment.