Italian CNS: rewrite as "Italian CNS, CIE and digital signature" - #38
Open
ale-rinaldi wants to merge 3 commits into
Open
Italian CNS: rewrite as "Italian CNS, CIE and digital signature"#38ale-rinaldi wants to merge 3 commits into
ale-rinaldi wants to merge 3 commits into
Conversation
Rewrite the page around the two questions a user actually has: which of the many Italian cards called "CNS" am I holding, and what can OpenSC do with it. - Explain that CNS is a specification (file system, APDU set, certificate profile) implemented independently by every issuing administration, which is where the fragmentation comes from. - Document how to recognise a CNS authentication certificate (policy OID 1.3.76.16.2.1, clientAuth, no nonRepudiation, commonName layout) and how it differs, legally and technically, from a qualified signature certificate. - Describe how itacns matches a card (15 historical bytes, "CNS" at offset 9) with a decoded example, and list the four keyset layouts the PKCS#15 emulation probes, noting that the IDEMIA 2021 keyset labelled CNS1 actually carries the authentication certificate. - State plainly that the qualified signature side normally does not show up, and why: the file system specification standardises the existence of DF_DS but not its contents, and since 2016 explicitly allows the signature to live in a vendor-specific Java applet with DF_DS present but empty. - Add a support summary per card generation with the change that made each work, the state of CIE 3.0 and ST 2022, and the legacy actalis emulation including the opensc.conf setting it needs. - Drop the incorrect claim that a CNS cannot be issued to a CIE holder. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…S page Both pages described a single facet of the same ecosystem and had gone stale. Their still-valid content is now in Italian-CNS-and-CIE, so reduce them to a pointer, keeping the URLs alive and the facts that were only recorded here (the supported Infocamere card types, and the distinction between the legacy CardOS Actalis signature cards and the CNS-compatible ones). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Point to the merged page, drop the duplicate entry for the Infocamere page and move the Actalis signature cards out of "Unsupported smart cards": they are supported by the cardos driver plus the actalis PKCS#15 emulation, which is a legacy emulation disabled by default. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
As requested in the review of OpenSC/OpenSC#3751 ("What I'd like to see would be some more
documentation in the OpenSC wiki about the different types of Italian CNS and CIE"), this rewrites
the Italian CNS page so that a user can work out which card they are holding and what OpenSC can do
with it.
What the page now answers
specifications — file system, APDU set and certificate profile — that every Italian public
administration implements through its own procurement, choosing its own chip, manufacturer and CA.
1.3.76.16.2.1with its prescribed explicit text,
clientAuth,digitalSignaturewithoutnonRepudiation, andthe
<fiscal code>/<card id>.<hash>commonName.itacnsmatches a card (15 historical bytes withCNSat offset 9),with a decoded ATR, plus a summary per card generation and the change that made each one work.
the specifications rather than in a driver: the file system specification standardises the
existence of
DF_DSbut not its contents, and since its 2016 revision explicitly allows thesignature to live in a dedicated Java applet, with
DF_DSpresent but empty and the appletinterface left to the vendor's middleware. This is the recurring subject of
#2782, #3479 and similar reports.
Corrections to the previous text
technical rules only ask the citizen to declare they hold no CIE, and the preventive check that
once existed applied to the CIE pilot municipalities until 2005 and was repealed in 2009.
CNS1for IDEMIA 2021 cards actually carries their authenticationcertificate (PIN reference
0x10), not a signature one; the page says so explicitly to avoid thesame confusion.
ST 2021andACe/ACx 2021were listed by third-party sources as needing proprietary middleware;they work since #2371 and #2483 respectively. Only
ST 2022is currently unrecognised (#3755).Verification
The ATR, the certificate profile and the observation that only
CNS0is exposed were checked on areal card (ST/Incard CNS in a Bit4id CKey4 token) with OpenSC 0.23.0; the file paths, keyset
layouts, PIN references and the
actalisemulation being registered among the legacy emulators wereread from
card-itacns.c,pkcs15-itacns.c,pkcs15-actalis.candpkcs15-syn.c. Specificationstatements are cited from the AgID documents linked in the page's References section.
Commits
Italian-InfocamereandItalian-signature-card-Actalisreduced to pointers, keeping their URLsalive and the facts recorded only there;
Supported-hardware, including moving the Actalis cards out of"Unsupported smart cards". That last commit is the only editorial change to a page outside this
topic and can be dropped on its own if you would rather keep that list as it is.
Support for the Bit4id Digital-DNA Key is referenced as in progress, pointing at OpenSC/OpenSC#3751;
the page should be updated once that lands.
🤖 Generated with Claude Code