Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[PID/(Q)EAA Data Model - PID Claims] Legal Entity identification #415

Draft
wants to merge 3 commits into
base: versione-corrente
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/common/common_definitions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -69,3 +69,4 @@
.. _W3C-SRI: https://www.w3.org/TR/SRI/
.. _OIDC-IDA: https://openid.net/specs/openid-connect-4-identity-assurance-1_0.html
.. _SPID/CIE-OpenID-Connect-Specifications: https://italia.github.io/spid-cie-oidc-docs/en
.. _EIDAS_SAML_ATTRIBUTE_PROFILE_1_4: https://ec.europa.eu/digital-building-blocks/sites/download/attachments/467109280/eIDAS%20SAML%20Attribute%20Profile%20v1.4_final.pdf
32 changes: 29 additions & 3 deletions docs/en/pid-eaa-data-model.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,22 @@
PID/(Q)EAA Data Model
+++++++++++++++++++++

The Person Identification Data (PID) is issued by the PID Provider according to national laws. The main scope of the PID is allowing natural persons to be authenticated for the access to a service or to a protected resource.
The User attributes provided within the Italian PID are the ones listed below:
The Person Identification Data (PID) is issued by the PID Provider according to national laws. The main scope of the PID is allowing natural or legal person to be authenticated for the access to a service or to a protected resource.
The User attributes, for natural person, provided within the Italian PID are the ones listed below:

- Current Family Name
- Current First Name
- Date of Birth
- Unique Identifier
- Taxpayer identification number

For legal person, the user attributes provided within the Italian PID are based on the eIDAS document `EIDAS_SAML_ATTRIBUTE_PROFILE_1_4`_, and the minimum dataset is listed below:

- LegalName
- LegalPersonIdentifier
- VATRegistration
- LegalEmailAddress (PEC)

The (Q)EAAs are issued by (Q)EAA Issuers to a Wallet Instance and MUST be provided in SD-JWT-VC or MDOC-CBOR data format.

The PID/(Q)EAA data format and the mechanism through which a digital credential is issued to the Wallet Instance and presented to a Relying Party are described in the following sections.
Expand Down Expand Up @@ -198,7 +205,7 @@ Depending on the Digital Credential type **vct**, additional claims data MAY be
:widths: 20 60 20
:header-rows: 1

* - **Claim**
* - **Natural Person Claim**
- **Description**
- **Reference**
* - **given_name**
Expand All @@ -216,6 +223,25 @@ Depending on the Digital Credential type **vct**, additional claims data MAY be
* - **tax_id_code**
- [SD]. National tax identification code of natural person as a String format. It MUST be set according to ETSI EN 319 412-1. For example ``TINIT-<ItalianTaxIdentificationNumber>``
-
.. list-table::
:widths: 20 60 20
:header-rows: 1

* - **Legal Person Claim**
- **Description**
- **Reference**
* - **LegalName**
- [SD]. Current Legal Name.
- `[eIDAS LegalName] <http://eidas.europa.eu/attributes/legalperson/LegalName>`_
* - **LegalPersonIdentifier**
- [SD]. Current Legal Person Identifier.
- `[eIDAS LegalPersonIdentifier] <http://eidas.europa.eu/attributes/legalperson/LegalPersonIdentifier>`_
* - **VATRegistration**
- [SD]. VAT Registration Number for the organization.
- `[eIDAS VATRegistration] <http://eidas.europa.eu/attributes/legalperson/VATRegistration>`_
* - **LegalEmailAddress**
- [SD]. Contact Email Address.
- `[eIDAS LegalEmailAddress] <http://eidas.europa.eu/attributes/legalperson/LegalEmailAddress>`_

The PID attribute schema, which encompasses all potential User data, is defined in `ARF v1.4 <https://github.com/eu-digital-identity-wallet/eudi-doc-architecture-and-reference-framework/blob/main/docs/arf.md#21-identification-and-authentication-to-access-online-services>`_, and furthermore detailed in the `PID Rulebook <https://github.com/eu-digital-identity-wallet/eudi-doc-architecture-and-reference-framework/blob/main/docs/annexes/annex-3/annex-3.01-pid-rulebook.md#23-pid-attributes>`_.

Expand Down
Loading