diff --git a/docs/common/common_definitions.rst b/docs/common/common_definitions.rst index 058180e7..b45704ea 100644 --- a/docs/common/common_definitions.rst +++ b/docs/common/common_definitions.rst @@ -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 diff --git a/docs/en/pid-eaa-data-model.rst b/docs/en/pid-eaa-data-model.rst index 2111da26..d0859347 100644 --- a/docs/en/pid-eaa-data-model.rst +++ b/docs/en/pid-eaa-data-model.rst @@ -6,8 +6,8 @@ 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 @@ -15,6 +15,13 @@ The User attributes provided within the Italian PID are the ones listed below: - 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. @@ -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** @@ -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-`` - +.. list-table:: + :widths: 20 60 20 + :header-rows: 1 + + * - **Legal Person Claim** + - **Description** + - **Reference** + * - **LegalName** + - [SD]. Current Legal Name. + - `[eIDAS LegalName] `_ + * - **LegalPersonIdentifier** + - [SD]. Current Legal Person Identifier. + - `[eIDAS LegalPersonIdentifier] `_ + * - **VATRegistration** + - [SD]. VAT Registration Number for the organization. + - `[eIDAS VATRegistration] `_ + * - **LegalEmailAddress** + - [SD]. Contact Email Address. + - `[eIDAS LegalEmailAddress] `_ The PID attribute schema, which encompasses all potential User data, is defined in `ARF v1.4 `_, and furthermore detailed in the `PID Rulebook `_.