9.1.2. Componenti della Soluzione Wallet¶
Nota
I test relativi ai componenti della Wallet Solution (Backend del Wallet e Unità di Wallet) sono riassunti in WP_012 e in WP_013, rispettivamente.
9.1.2.1. Backend del Wallet¶
9.1.2.1.1. Componente Frontend¶
Il Componente Frontend DEVE fornire un'interfaccia Utente basata sul web per la gestione dell'Istanza del Wallet, offrendo funzionalità per:
Visualizzare e verificare le Istanze del Wallet e il loro stato.
Gestire il ciclo di vita dell'Istanza del Wallet (ad esempio, revoca).
Fornire supporto e documentazione all'Utente.
9.1.2.1.2. Interfaccia API¶
Questo componente DEVE:
inoltrare la richiesta dal Componente Frontend o dall'Istanza del Wallet al componente di Gestione del Ciclo di Vita dell'Istanza del Wallet.
utilizzare PDND secondo le regole nella Sezione e-Service PDND per essere notificato dal Provider di PID/IT-Wallet ID della necessità di revocare l'Istanza del Wallet e cancellare l'account dell'Utente a causa del decesso dell'Utente.
9.1.2.1.3. Gestione del Ciclo di Vita dell'Istanza del Wallet¶
Questo componente DEVE gestire:
Registrazione dell'Istanza del Wallet (dettagliata in Inizializzazione e Registrazione dell'Istanza del Wallet).
Emissione della Wallet Instance Attestation (dettagliata in Emissione della Wallet Instance Attestation).
Emissione della Key Attestation (dettagliata in Emissione della Key Attestation).
Gestione dello stato (mantenimento e aggiornamento della validità).
Processi di revoca (implementazione di meccanismi per revocare le Istanze del Wallet), secondo la Sezione Revoca dell'Istanza del Wallet.
9.1.2.1.4. Componente Trust & Security¶
Questo componente DEVE garantire la sicurezza attraverso:
Gestione di chiavi e certificati.
Registrazione degli audit.
Monitoraggio della sicurezza e risposta agli incidenti.
Conformità ai requisiti di sicurezza della Federazione IT-Wallet.
9.1.2.2. Unità di Wallet¶
9.1.2.2.1. Interfaccia Utente¶
L'Interfaccia Utente è il punto di interazione e comunicazione tra l'Utente e l'Istanza del Wallet.
9.1.2.2.2. Componente di Gestione del Ciclo di Vita dell'Istanza del Wallet¶
Interagendo con il Backend del Wallet, questo componente DEVE gestire:
Registrazione dell'Istanza del Wallet (dettagliata in Inizializzazione e Registrazione dell'Istanza del Wallet).
Emissione della Wallet Instance Attestation (dettagliata in Emissione della Wallet Instance Attestation).
Emissione della Key Attestation (dettagliata in Emissione della Key Attestation).
Gestione dello stato (mantenimento e aggiornamento della validità).
Processi di revoca (implementazione di meccanismi per revocare le Istanze del Wallet), secondo la Sezione Revoca dell'Istanza del Wallet.
In base allo stato dell'Istanza del Wallet e alla richiesta dell'Utente, questo componente interagisce con gli altri componenti dell'Istanza del Wallet.
9.1.2.2.3. Componente Issuer¶
Seguendo la specifica OpenID4VCI e il profilo di implementazione nella Sezione Emissione di Attestati Elettronici, questo componente DEVE implementare i protocolli e i flussi di emissione delle Credenziali Elettroniche per richiedere Credenziali Elettroniche ai Credential Issuer.
9.1.2.2.4. Componente di Presentazione¶
Seguendo il profilo di implementazione nella Sezione Presentazione dell'Attestato Elettronico, questo componente DEVE essere conforme ai flussi remoti basati su OpenID4VP e ai flussi di prossimità basati su ISO18013-5.
9.1.2.2.5. Componente di Backup e Ripristino¶
Per ogni Credenziale Elettronica con associazione al dispositivo diversa dal PID e dall'IT-Wallet ID, questo componente DEVE aggiungere al file di backup i dati necessari per richiedere l'emissione di quella Credenziale Elettronica durante il ripristino. I dati sono specificati nella Sezione Flusso di Backup.
Questo componente DEVE mantenere l'oggetto di migrazione specificato in Migrazione verso una Soluzione Wallet diversa.
Nota
Il ripristino del file di backup non richiede l'emissione del PID o dell'IT-Wallet ID. L'oggetto di migrazione elenca entrambi, e l'Istanza del Wallet ricevente ne richiede l'emissione a partire da tale elenco.
9.1.2.2.6. Dashboard e Registro delle Transazioni¶
Questo componente DEVE fornire le funzionalità di dashboard e di registro delle transazioni della Wallet Unit. In particolare, questo componente DEVE:
fornire un’interfaccia accessibile all’Utente che consenta all’Utente di accedere alle informazioni di trasparenza delle transazioni.
mantenere un registro delle transazioni eseguite tramite la Wallet Unit, incluse le transazioni non completate.
supportare l’interazione dell’Utente con i record di transazione, inclusa la visualizzazione, l’esportazione e la cancellazione.
9.1.2.2.7. Keystore¶
L'Istanza del Wallet DEVE utilizzare questo componente per generare, archiviare e utilizzare in modo sicuro le chiavi crittografiche per tutte le Credenziali Digitali. Il Keystore si basa sull'ambiente crittografico hardware-backed fornito dall'OEM del dispositivo (Strongbox o TEE su Android, e Secure Enclave su iOS). Il Keystore è attestato tramite le OEM Key Attestation APIs. Il Keystore è il meccanismo di archiviazione sicura di default per tutte le operazioni della Wallet Instance e per tutte le Credenziali Digitali.
9.1.2.2.8. WSCA/WSCD Interface¶
Per l'emissione e la gestione del PID a Livello di Garanzia Alto, l'Istanza del Wallet DEVE interagire con un WSCA operante in un Remote WSCD implementato come Hardware Security Module (HSM) remoto operato lato server. Questo componente fornisce l'interfaccia verso il WSCA e il Remote WSCD. Questo componente garantisce che le chiavi private del PID siano generate e gestite in un ambiente hardware remoto antimanomissione conforme ai requisiti per il Livello di Garanzia Alto. La WSCA/WSCD Interface è utilizzata esclusivamente per il PID.
L'attestazione delle chiavi nel contesto del Remote WSCD è eseguita dal Wallet Provider. Dopo che il WSCA genera la coppia di chiavi del PID all'interno del Remote WSCD (HSM remoto), il Wallet Provider attesta le proprietà del WSCA e del Remote WSCD. Il Wallet Provider emette un Key Attestation (KA) che viene presentato al PID Provider durante l'emissione del PID. Il KA per il Remote WSCD descrive le proprietà di sicurezza dell'HSM remoto (anziché dell'hardware OEM del dispositivo). Tale descrizione fornisce il livello di certificazione superiore richiesto per il Livello di Garanzia Alto.
9.1.3. Modelli di Interazione della Soluzione Wallet¶
La Soluzione Wallet supporta questi modelli di interazione:
Utente verso Frontend del Backend del Wallet: Interazioni basate sul web per la gestione dell'Istanza del Wallet.
Istanza del Wallet verso API del Backend del Wallet: per la registrazione dell'Istanza del Wallet e l'emissione della Wallet Instance e key Attestation.
Provider di PID/IT-Wallet ID verso API del Backend del Wallet: Chiamate API sicure per richiedere la revoca dell'Istanza del Wallet.
Utente verso Interfaccia Utente dell'Istanza del Wallet: per la gestione delle Credenziali Elettroniche (emissione, presentazione, backup, ripristino, eliminazione).
Istanza del Wallet verso Relying Party: per la presentazione delle Credenziali Elettroniche.