Documentazione Tecnica IT-Wallet

Queste Specifiche Tecniche definiscono l'architettura tecnica, il framework di implementazione e i requisiti di progettazione da adottare per le Soluzioni Tecniche del Sistema IT-Wallet. Queste Specifiche Tecniche integrano le Linee Guida previste dall'articolo 64-quater del Decreto Legislativo n. 82 del 7 marzo 2005 (CAD) e, una volta formalmente adottate, entrano a far parte del quadro normativo del Sistema IT-Wallet. Queste Specifiche Tecniche sono redatte attraverso un processo aperto e collaborativo. Questa versione delle Specifiche Tecniche consente la notifica del Sistema IT-Wallet alla Commissione Europea, in conformità al Regolamento eIDAS ([EIDAS], come modificato da [EU_2024_1183]) e ai relativi regolamenti di esecuzione.

In Italia, il Decreto-Legge n. 19 del 2 marzo 2024, convertito, con modificazioni, dalla Legge n. 56 del 29 aprile 2024, ha introdotto l'articolo 64-quater del Decreto Legislativo n. 82 del 7 marzo 2005, istituendo il Sistema di Portafoglio Digitale Italiano - Sistema IT-Wallet. Il Sistema IT-Wallet consente a persone fisiche o giuridiche di accedere a servizi pubblici e privati attraverso la presentazione sicura di Attestati Elettronici, attestanti diritti, deleghe, caratteristiche, licenze o qualifiche. L'articolo 64-quater prevede inoltre l'adozione di uno o più decreti attuativi per definire le regole che disciplinano il funzionamento del Sistema IT-Wallet. I decreti comprendono i ruoli delle entità coinvolte, i requisiti tecnici e di sicurezza e i principi di sostenibilità economica.

Indice dei Contenuti

• 1. Introduzione
  • 1.1. Ambito
  • 1.2. Linguaggio Normativo e Convenzioni
  • 1.3. Come leggere le Specifiche
    • 1.3.1. Linguaggio normativo
    • 1.3.2. Panoramica della Struttura delle Specifiche
    • 1.3.3. Percorsi di lettura per ruolo
• 2. Brand Identity
  • 2.1. Naming
  • 2.2. Identità Visiva
    • 2.2.1. Logo
    • 2.2.2. Trust Mark
• 3. Panoramica dell'Architettura
• 4. Design dell'Esperienza Utente
  • 4.1. Principi di Design
  • 4.2. Panoramica delle Funzionalità
  • 4.3. Attivazione dell'Istanza del Wallet
    • 4.3.1. Focus sugli Attestati di Identificazione Personale
  • 4.4. Ottenimento degli Attestati Elettronici di Attributi
    • 4.4.1. Ottenimento dal Catalogo dell'Istanza del Wallet
    • 4.4.2. Ottenimento dal Touchpoint della Fonte Autentica
    • 4.4.3. Focus sugli Attestati Elettronici di Attributi
  • 4.5. Presentazione degli Attestati Elettronici
    • 4.5.1. Presentazione in prossimità
    • 4.5.2. Presentazione da remoto
  • 4.6. Gestione degli Attestati Elettronici
    • 4.6.1. Stato degli Attestati Elettronici
    • 4.6.2. Registrazione delle Transazioni
    • 4.6.3. Archiviazione e ripristino degli Attestati Elettronici di Attributi
  • 4.7. Disattivazione dell'Istanza del Wallet
  • 4.8. Gestione degli errori
    • 4.8.1. Errori di Attivazione dell'Istanza del Wallet
    • 4.8.2. Errori di ottenimento degli Attestati Elettronici di Attributi
    • 4.8.3. Errori di presentazione degli Attestati Elettronici
    • 4.8.4. Errori di gestione degli Attestati Elettronici
    • 4.8.5. Errori di disattivazione dell'Istanza del Wallet
  • 4.9. Assistenza Utente
  • 4.10. Feedback Utente
    • 4.10.1. Raccolta di feedback transazionale
    • 4.10.2. Raccolta di feedback relazionale
• 5. Infrastructure of Trust
  • 5.1. Overview
  • 5.2. PKI Architecture
    • 5.2.1. Certification Hierarchies
    • 5.2.2. Design Principles
  • 5.3. X.509 Certificate Profile
  • 5.4. Common Trust Artifacts
    • 5.4.1. Entity Sign/Seal Certificate Profile
    • 5.4.2. Trust Anchor Certificate Profile
  • 5.5. EUDIW Trust Artifacts
    • 5.5.1. Register of WRPs
    • 5.5.2. Wallet-Relying Party Access Certificate (WRPAC) Profile
    • 5.5.3. Registrar Sign/Seal Certificate Profile
    • 5.5.4. Wallet-Relying Party Registration Certificate (WRPRC) Profile
    • 5.5.5. Trusted List, Lists of Trusted Lists, and Lists of Trusted Entities
    • 5.5.6. Embedded Disclosure Policy (EDP)
  • 5.6. National Trust Artifacts
    • 5.6.1. Federation API Endpoints
    • 5.6.2. Entity Statements
    • 5.6.3. Entity Statement Examples
    • 5.6.4. Trust Marks
  • 5.7. Trust Management and Lifecycle
    • 5.7.1. Trust Artifacts Lifecycle State Machine
    • 5.7.2. Federation Entity Key Rotation
    • 5.7.3. Revocation Mechanisms
• 6. Trust Evaluation Process
  • 6.1. Trust Framework Selection
    • 6.1.1. Selection at Issuance
    • 6.1.2. Selection at Presentation
    • 6.1.3. Failure Handling
  • 6.2. Trust Evaluation in the EUDIW Trust Framework
    • 6.2.1. EUDIW Trust Evaluation Processes by Context
    • 6.2.2. EUDIW Trust Anchor Validation
    • 6.2.3. X509 Certificate Chain Validation Algorithm
    • 6.2.4. EUDIW Attestation Signature Validation
    • 6.2.5. EUDIW Authentication
    • 6.2.6. EUDIW Authorization
    • 6.2.7. EUDIW Metadata Retrieval and Validation
  • 6.3. Trust Evaluation in the National Trust Framework
    • 6.3.1. Trust Evaluation Processes by Context
    • 6.3.2. Federation Trust Anchor Distribution and Validation
    • 6.3.3. Trust Chain Validation
    • 6.3.4. Signing Trust Anchor Distribution and Validation
    • 6.3.5. Wallet Trust Anchor Distribution and Validation
    • 6.3.6. Authentication Trust Anchor Distribution
    • 6.3.7. Authentication
    • 6.3.8. Authorization
    • 6.3.9. Metadata Retrieval and Validation
  • 6.4. Authorization Decision and Override Rules
    • 6.4.1. Principi di Override
• 7. Registry Infrastructure
  • 7.1. Registries and Catalogues of the Ecosystem
  • 7.2. Endpoint di Discovery del Registro
    • 7.2.1. Registry Discovery Endpoint Parameters
    • 7.2.2. Content Negotiation and Signed Representation
  • 7.3. Taxonomy
    • 7.3.1. Taxonomy Objectives
    • 7.3.2. Taxonomy Usage
    • 7.3.3. Digital Credentials Hierarchy
    • 7.3.4. Taxonomy Structure
  • 7.4. Claims Registry
    • 7.4.1. Claims Registry Usage
    • 7.4.2. Claims Registry Structure
  • 7.5. Authentic Source Registry
    • 7.5.1. Authentic Source Registry Usage
    • 7.5.2. Authentic Source Registry Structure
  • 7.6. Schema Registry
    • 7.6.1. Schema Registry Objectives
    • 7.6.2. Utilizzo dello Schema Registry
    • 7.6.3. Catalogo delle Attestazioni
  • 7.7. Catalogo degli Attestati Elettronici
    • 7.7.1. Digital Credentials Catalog Usage
    • 7.7.2. Digital Credentials Catalog Retrieval
    • 7.7.3. Digital Credentials Catalog Structure
    • 7.7.4. Decentralization of Display and Claim Information
  • 7.8. Registry Integration and Cross-References
  • 7.9. Registry Infrastructure Usage Journeys
    • 7.9.1. Catalog Browsing
    • 7.9.2. Credential Issuance
    • 7.9.3. Credential Presentation and Verification
    • 7.9.4. Cross-border Attribute Verification by a QTSP
• 8. Onboarding System and Lifecycle Management
  • 8.1. Overview
    • 8.1.1. System Actors and Roles
    • 8.1.2. System Components and Services
  • 8.2. Registration Model
    • 8.2.1. Registration Data Model
    • 8.2.2. Mapping to the Registry Data Models
    • 8.2.3. Eligibility and Compliance Preconditions
    • 8.2.4. Trust Artifacts Registration Outcomes
    • 8.2.5. Registration Profiles
  • 8.3. Onboarding Processes
    • 8.3.1. Process Dependency Map
    • 8.3.2. Entity Onboarding
    • 8.3.3. Certificate and Trust Artifact Issuance
    • 8.3.4. Attestation Onboarding
  • 8.4. Notification and Publication
    • 8.4.1. Notification and Publication: Input
    • 8.4.2. Notification and Publication: Outcome
    • 8.4.3. Notification and Publication: Process
  • 8.5. Lifecycle Management
    • 8.5.1. Entity Lifecycle State Machine
    • 8.5.2. Registration Events and Their Governance
    • 8.5.3. Entity Updates and Their Effects on Trust Artifacts
    • 8.5.4. Credential Type Lifecycle
    • 8.5.5. Claims and Schemas Lifecycle
    • 8.5.6. Authentic Source Lifecycle and PDND Alignment
    • 8.5.7. Events, Registries and Trust Artifacts
• 9. Entità
  • 9.1. Soluzione Wallet
    • 9.1.1. Requisiti della Soluzione Wallet
    • 9.1.2. Componenti della Soluzione Wallet
    • 9.1.3. Modelli di Interazione della Soluzione Wallet
    • 9.1.4. Istanza del Wallet
    • 9.1.5. Backup e Ripristino
    • 9.1.6. Entity Configuration del Fornitore di Wallet
    • 9.1.7. Metadati della Soluzione Wallet
  • 9.2. Soluzione del Fornitore di Attestati Elettronici
    • 9.2.1. Requisiti del Fornitore di Attestati Elettronici
    • 9.2.2. Dettagli dei Componenti
    • 9.2.3. Modelli di Interazione
    • 9.2.4. Entity Configuration del Fornitore di Attestati Elettronici
    • 9.2.5. Metadata del Fornitore di Attestati Elettronici
  • 9.3. Soluzione di Relying Party
    • 9.3.1. App di Verifica
    • 9.3.2. App di Verifica Mobile
    • 9.3.3. App di Verifica Web
    • 9.3.4. Entity Configuration Relying Party
    • 9.3.5. Metadati della Relying Party
  • 9.4. Fonti Autentiche
• 10. Gestione degli Attestati Elettronici
  • 10.1. Modello di Dati degli Attestati Elettronici
    • 10.1.1. Attributi di Metadati Format-Agnostic dell'Attestato Elettronico
    • 10.1.2. Formato Attestato Elettronico SD-JWT-VC
    • 10.1.3. Formato Attestato Elettronico mdoc-CBOR
    • 10.1.4. Mappatura dei Parametri degli Attestati Elettronici tra i vari Formati
  • 10.2. Modello di Dati del PID
    • 10.2.1. Emissione del PID prima della notifica EUDIW
    • 10.2.2. Attributi del PID
    • 10.2.3. Modello Dati PID in formato SD-JWT-VC
    • 10.2.4. Modello Dati PID in formato mdoc-CBOR
  • 10.3. Modello di Dati dell'IT-Wallet ID
    • 10.3.1. Modello di Dati dell'IT-Wallet ID in formato SD-JWT VC
  • 10.4. Modello di Dati QEAA e PuB-EAA
    • 10.4.1. Ambito
    • 10.4.2. Categoria
    • 10.4.3. Identificazione dell'Issuer
    • 10.4.4. Identità dell'Attestato
    • 10.4.5. Soggetto
    • 10.4.6. Validità Tecnica e Amministrativa
    • 10.4.7. Stato e Attestati a Vita Breve
    • 10.4.8. Componenti Non Utilizzati
    • 10.4.9. Profilo SD-JWT VC
    • 10.4.10. Profilo mdoc-CBOR
    • 10.4.11. Verifica
    • 10.4.12. Esempi Non Normativi
  • 10.5. Ciclo di Vita degli Attestati Elettronici
    • 10.5.1. Transizioni degli Attestati Elettronici
    • 10.5.2. Ciclo di vita degli Attestati Elettronici ottenuti in batch
    • 10.5.3. Gestione del Ciclo di Vita degli Attestati Elettronici
    • 10.5.4. Meccanismi di Verifica della Validità
• 11. Flussi relativi agli Attestati Elettronici
  • 11.1. Emissione di Attestati Elettronici
    • 11.1.1. Flussi ad Alto Livello per l'Emissione di Attestati Elettronici
    • 11.1.2. Flussi Dettagliati per l'Emissione di Attestati Elettronici
    • 11.1.3. Autenticazione eID Substantial con Verifica MRTD per Emissione IT-Wallet ID
  • 11.2. Presentazione dell'Attestato Elettronico
    • 11.2.1. Flusso Remoto
    • 11.2.2. Flusso di Prossimità
    • 11.2.3. Identity Matching e Identity Reconciliation
  • 11.3. Flusso di Recupero dei Wallet Metadata
• 12. Endpoints
  • 12.1. Endpoint del Fornitore di Wallet
    • 12.1.1. Endpoint di Federazione
    • 12.1.2. Endpoint Nonce della Soluzione Wallet
    • 12.1.3. Endpoint di Gestione dell'Istanza di Wallet
    • 12.1.4. Endpoint di Emissione della Wallet Instance Attestation
    • 12.1.5. Endpoint di Emissione della Key Attestation
    • 12.1.6. Token Status List (Profilo dell'Attestato di Wallet Unit)
    • 12.1.7. Catalogo e-Service PDND del Fornitore di Wallet
  • 12.2. Endpoint del Credential Issuer
    • 12.2.1. Endpoint Metadata
    • 12.2.2. Endpoint di Rilascio degli Attestati Elettronici
    • 12.2.3. Catalogo degli e-Service PDND del Credential Issuer
  • 12.3. Endpoint della Relying Party
    • 12.3.1. Endpoint per Flussi Remoti della Relying Party
    • 12.3.2. Endpoint del Backend del Provider di Relying Party
  • 12.4. Endpoint delle Fonti Autentiche
    • 12.4.1. Catalogo degli e-Service PDND delle Fonti Autentiche
  • 12.5. Endpoint di PDND Signal Hub
    • 12.5.1. Prerequisiti
    • 12.5.2. e-Service di Signal Hub
    • 12.5.3. Elaborazione dei Segnali
• 13. Algoritmi Crittografici
• 14. Considerazioni di Sicurezza e Privacy
  • 14.1. Requisiti di Sicurezza
    • 14.1.1. SR-CF-10 e SR-E-10
    • 14.1.2. SR-CF-20
    • 14.1.3. SR-CF-21
    • 14.1.4. SR-E-20
    • 14.1.5. SR-E-30
    • 14.1.6. SR-E-40
    • 14.1.7. SR-I-10
    • 14.1.8. SR-I-20
    • 14.1.9. SR-I-30
    • 14.1.10. SR-I-40
    • 14.1.11. SR-I-50
    • 14.1.12. SR-P-20
    • 14.1.13. SR-P-30
    • 14.1.14. SR-P-40
    • 14.1.15. SR-P-41
    • 14.1.16. SR-P-50
    • 14.1.17. SR-V-10
    • 14.1.18. SR-V-20
    • 14.1.19. SR-W-20
    • 14.1.20. SR-W-30
  • 14.2. Requisiti di Privacy
    • 14.2.1. PR-CF-30
    • 14.2.2. PR-CF-40
    • 14.2.3. PR-E-60
    • 14.2.4. PR-E-70
    • 14.2.5. PR-W-40
    • 14.2.6. PR-W-60
    • 14.2.7. PR-W-70
  • 14.3. Requisiti di Sicurezza e Privacy
    • 14.3.1. SPR-E-50
    • 14.3.2. SPR-P-10
    • 14.3.3. SPR-P-60
    • 14.3.4. SPR-P-70
    • 14.3.5. SPR-P-80
    • 14.3.6. SPR-W-50
• 15. Politiche Generali di Conservazione dei Log
  • 15.1. Requisiti Generali di Logging ISO/IEC 27001
    • 15.1.1. Politica di Conservazione dei Log del Fornitore di Wallet
    • 15.1.2. Politica di Conservazione dei Log del Fornitore di Credenziali
    • 15.1.3. Politica di Conservazione dei Log delle Fonti Autentiche
    • 15.1.4. Politica di Conservazione dei Log della Relying Party
    • 15.1.5. Funzionalità di Logging delle Istanze del Wallet
• 16. Termini Definiti e Riferimenti
  • 16.1. Definizioni e Acronimi
    • 16.1.1. Acronimi
  • 16.2. Riferimenti Normativi
    • 16.2.1. Risorse Ufficiali
  • 16.3. Technical References
    • 16.3.1. Wallet Architecture and Reference Frameworks
    • 16.3.2. EUDI Wallet Standards and Technical Specifications
    • 16.3.3. Infrastructure of Trust
    • 16.3.4. Digital Credential Data Format
    • 16.3.5. Digital Credential Issuance
    • 16.3.6. Digital Credential Presentation
    • 16.3.7. Digital Credential Revocation Check Mechanisms
    • 16.3.8. National Data Interoperability Platform Specifications
    • 16.3.9. National Digital Identity Platform Specifications
    • 16.3.10. Security and Protection Profiles
• 17. Come contribuire
  • 17.1. Ringraziamenti
• 18. Rilasci Open Source
  • 18.1. 1. Principi Generali
  • 18.2. 2. Requisiti Standard
    • 18.2.1. 2.1 Licenze
    • 18.2.2. 2.2 Gestione del Codice e Trasparenza
    • 18.2.3. 2.3 Sicurezza e Qualità
  • 18.3. 3. Fornitori di Wallet
    • 18.3.1. 3.1 Open Source Obbligatorio
  • 18.4. 4. Fornitori di Credenziali e Relying Party
    • 18.4.1. 4.1 Componenti di integrazione
    • 18.4.2. 4.2 Infrastruttura di backend
  • 18.5. 5. Divulgazione Responsabile e Gestione delle Vulnerabilità
• 19. Appendice
  • 19.1. Istanza dell'Applicazione Mobile
    • 19.1.1. Inizializzazione dell'Istanza dell'Applicazione Mobile
  • 19.2. e-Service PDND
    • 19.2.1. Requisiti e Pattern di Sicurezza
    • 19.2.2. Emissione del Voucher PDND
    • 19.2.3. Reperimento delle Chiavi
    • 19.2.4. Utilizzo dell'e-Service
  • 19.3. PDND e-Service Template
    • 19.3.1. Definizione e linee guida dell'e-service template PDND
  • 19.4. Test Plans
    • 19.4.1. Struttura della Matrice di Test