Nitrokey / Nitrokey/nitrokey-documentation
HSM documentation incorrect: certificates are not signed with correct X509v3 Authority Key Identifier for the intermediate CA
Nobody has claimed this yet.
- Dominant language
- CSS
- Stars
- 36
- Forks
- 53
- Avg merge
- 1d 16h
- Merged PRs (30d)
- 5
Description
File: [nitrokeys/features/openpgp-card/certificate-authority.rst] https://docs.nitrokey.com/nitrokeys/features/openpgp-card/certificate-authority.html
As it is right now, the tutorial seems to fail (tested and verified twice) to correctly document how to create the intermediate CA.
The X509v3 Authority Key Identifier points to the root CA, which is most definitely not the desired outcome (the whole point of the intermediate CA is to be the identified issuer in the certificates).
A workaround is to remove the always keyword for issuer (In sign_server_csrs.cnf):
[ server_cert ]
# Extensions for server certificates (`man x509v3_config`).
basicConstraints = CA:FALSE
nsCertType = server
nsComment = "OpenSSL Generated Server Certificate"
subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid,issuer
keyUsage = critical, digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth,clientAuth
This might break things, and certainly does not make debugging certificate problems easier for people who expect text instead of the bare fingerprint.
Note: the DN is not required and AFAIK there is no consensus on using it at all, since it cannot be verified normally. Still, it's a confusing tidbit that should be properly documented.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with nitrokeys/features/openpgp-card/certificate-authority.rst and inspect the sign_server_csrs.cnf section shown in the issue. Reproduce the intermediate-CA certificate generation and inspect its X509v3 Authority Key Identifier and DN behavior. Done means the tutorial accurately documents the resulting issuer identification and any required configuration choices.
Written by the indexing model from the issue text.
Assessment
- Domain
- cryptography, documentation, security
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100