Skip to content

Commit 7f8ea01

Browse files
authored
Merge pull request italia#710 from steps88/patch-4
Added missing info about PID naming
2 parents c3da159 + 27678a3 commit 7f8ea01

File tree

1 file changed

+11
-14
lines changed

1 file changed

+11
-14
lines changed

docs/en/functionalities.rst

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -57,14 +57,16 @@ Below are the requirements for displaying and using the PID that each Wallet Pro
5757
- The PID MUST display its status if different from valid to provide transparency on its lifecycle and MAY display it if valid. Specific details about the PID status, if invalid, MAY be provided (e.g., the reason why the PID is revoked);
5858
- The PID MUST include Action Buttons to enable lifecycle management and allow the User to revoke the PID, thus the entire Wallet Instance with all EAAs issued, or to update the PID at any time (see :ref:`functionalities:Management of Electronic Attestations`);
5959
- The PID MUST be an interactive element, for the User to be authenticated by a Relying Party in a digital context (see :ref:`functionalities:Authentication`), to access services in proximity contexts, and to request the issuance of additional EAAs (see :ref:`functionalities:Issuance of Electronic Attestation of Attributes`);
60-
- The PID MUST display a method of assistance by the PID Provider (see :ref:`functionalities:User Assistance`);
60+
- The PID MUST display a method of assistance by the PID Provider (see :ref:`functionalities:User Assistance`);
61+
- The PID MUST be recognizable by the User and distinguishable from other EAAs;
62+
- The PID MUST be named with the naming convention that will be defined in this document’s future version, avoiding custom or technical terms such as “Person Identification Data” or its acronym “PID”;
6163
- The PID representation MUST adhere to a defined set of specifications provided by the PID Provider to ensure recognizability, consistency and homogeneity among different Wallet Solutions.
6264

6365

6466
The PID Provider MUST:
6567

6668
- Implement a name/naming convention to refer to the PID, to guarantee consistency across all Wallet Solutions;
67-
- Define a clear set of specifications for the PID to ensure consistent identification and representation of the PID across different Wallet Solutions, in terms of format, structure and appearance standards (e.g. name, color, background image, etc.).
69+
- Define a clear set of specifications for the PID to ensure consistent identification and representation of the PID across different Wallet Solutions, in terms of format, structure and appearance standards (e.g. color, background image, etc.).
6870

6971

7072
Issuance of Electronic Attestations of Attributes
@@ -122,13 +124,8 @@ The EAAs obtained within the Wallet Instance SHOULD be displayed in a list withi
122124

123125
The Electronic Attestation of Attributes Provider:
124126

125-
- The Electronic Attestation MUST be displayed correctly across all devices, ensuring a consistent experience on screens of varying sizes;
126-
- The name of the Electronic Attestation MUST be clearly visible and always displayed in both the Detail View and the Preview View;
127-
- The Electronic Attestation, both in the Preview View and the Detailed View, MUST display its status if different from valid and MAY display it if valid. The Preview View MAY also include additional attributes to enhance the User Experience and management; for example, it MAY display the name or logo of the Electronic Attestation of Attributes Provider or the PID Provider;
128-
- The layout of elements in the Preview View of the Electronic Attestation MUST be optimized for scalability and usability, especially when multiple Electronic Attestations are displayed on the same screen;
129-
- The Electronic Attestation MAY adopt a card format, in line with approaches already used by other Wallets in the market, to mirror the appearance of a corresponding physical document. When applicable, the digital nature of the document MAY be indicated, such as by labeling it as a "digital version" in the layout;
130-
- The Electronic Attestation MUST display the same information in the Detail View as shown in the Preview View and MAY include additional details;
131-
- The Electronic Attestation MUST include Action Buttons in the Detail View to allow for management, as outlined in the `Management of Electronic Attestations`_ section.
127+
- MUST define a name/ naming convention to refer to the EAAs issued, to guarantee consistency across all Wallet Solutions; the EAA name MUST be comprehensible and user-friendly avoiding technical terms or acronyms whenever possible;
128+
- MUST define a clear set of specifications for the EAA to ensure consistent identification and representation of the EAA across different Wallet Solutions, in terms of format, structure, and appearance standards (e.g. color, background image, etc.).
132129

133130

134131
Presentation of Electronic Attestations
@@ -421,7 +418,7 @@ Below are the requirements and main best practices for error management, specifi
421418
Below is a non-exhaustive list of the main error cases, with reference to the actor responsible for their management, for each phase of the User Experience.
422419

423420
Activation of the Wallet Instance Errors
424-
----------------------------------------
421+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
425422

426423
.. list-table::
427424
:widths: 80 20
@@ -439,7 +436,7 @@ Activation of the Wallet Instance Errors
439436
- National Identity Provider
440437

441438
Issuance of Electronic Attestations of Attributes Errors
442-
--------------------------------------------------------
439+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
443440

444441
.. list-table::
445442
:widths: 80 20
@@ -455,7 +452,7 @@ Issuance of Electronic Attestations of Attributes Errors
455452
- Authentic Source
456453

457454
Presentation of Electronic Attestations Errors
458-
----------------------------------------------
455+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
459456

460457
.. list-table::
461458
:widths: 80 20
@@ -469,7 +466,7 @@ Presentation of Electronic Attestations Errors
469466
- Wallet Provider, Relying Party
470467

471468
Management of Electronic Attestations Errors
472-
----------------------------------------------
469+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
473470

474471
.. list-table::
475472
:widths: 80 20
@@ -483,7 +480,7 @@ Management of Electronic Attestations Errors
483480
- PID Provider
484481

485482
Deactivation of the Wallet Instance Errors
486-
------------------------------------------
483+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
487484

488485
.. list-table::
489486
:widths: 80 20

0 commit comments

Comments
 (0)