5.1.4.2.2. Emissione della Wallet Attestation

Questa sezione descrive come il Fornitore di Wallet emette una Wallet Attestation.

Fig. 5.4 Diagramma di Sequenza per l'acquisizione della Wallet Attestation.

Passo 1: L'Utente avvia una nuova operazione che richiede l'acquisizione di una Wallet Attestation.

Passi 2-3: L'Istanza del Wallet DEVE:

1. Verificare l'esistenza delle Cryptographic Hardware Keys. Se non esistono, è necessaria la reinizializzazione dell'Istanza del Wallet.

2. Generare una coppia di chiavi asimmetriche effimere per la Wallet Attestation (ephemeral_key_pub, ephemeral_key_priv), collegando la chiave pubblica all'attestato.

3. Verificare l'appartenenza del Fornitore di Wallet alla federazione e recuperare i suoi metadati.

Passi 4-6 (Recupero del Nonce): L'Istanza del Wallet richiede un nonce all'endpoint Endpoint Nonce della Soluzione Wallet del Backend del Fornitore del Wallet. Questo nonce deve essere imprevedibile e serve come principale difesa contro gli attacchi di replay.

Il nonce DEVE essere prodotto in modo da garantire il suo utilizzo singolo entro un periodo di tempo predeterminato.

In caso di richiesta riuscita, il Fornitore di Wallet genera e restituisce il valore del nonce all'Istanza del Wallet.

Passo 7: L'Istanza del Wallet esegue le seguenti azioni:

• Crea client_data, un oggetto JSON che include il nonce e l'impronta digitale della JWK ephemeral_key_pub.

• Calcola client_data_hash applicando l'algoritmo SHA256 al client_data.

Di seguito è riportato un esempio non normativo dell'oggetto JSON client_data.

{
  "nonce": "i4ThI2Jhbu81i8mqyWEuDG5t",
  "jwk_thumbprint": "vbeXJksM45xphtANnCiG6mCyuU4jfGNzopGuKvogg9c"
}

Passi 8-10: L'Istanza del Wallet:

• produce un valore hardware_signature firmando il client_data_hash con la chiave privata dell'Hardware del Wallet, servendo come prova di possesso delle Cryptographic Hardware Keys.

• richiede al Servizio di Integrità del Dispositivo di creare un valore integrity_assertion collegato al client_data_hash.

• riceve un valore firmato integrity_assertion dal Servizio di Integrità del Dispositivo, autenticato dall'OEM.

Nota

integrity_assertion è un payload personalizzato generato dal Servizio di Integrità del Dispositivo, firmato dall'OEM del dispositivo e codificato in base64 per avere uniformità tra diversi dispositivi.

Passi 11-12 (Richiesta di Emissione della Wallet Attestation): L'Istanza del Wallet:

• Costruisce la Richiesta di Wallet Attestation sotto forma di JWT. Questo JWT include integrity_assertion, hardware_signature, nonce, hardware_key_tag, cnf e altri parametri relativi alla configurazione (vedi Tabella del Corpo della Richiesta di Wallet Attestation) ed è firmato utilizzando la chiave privata della coppia di chiavi effimere generata inizialmente.

• Invia la Richiesta di Wallet Attestation all'endpoint Endpoint di Emissione della Wallet Attestation del Backend del Fornitore del Wallet.

L'Istanza del Wallet DEVE inviare il JWT firmato della Richiesta di Wallet Attestation come parametro assertion nel corpo di una richiesta HTTP all'endpoint Endpoint di Emissione della Wallet Attestation del Fornitore di Wallet.

Passi 13-17: Il Backend del Fornitore del Wallet valuta la Richiesta di Wallet Attestation e DEVE eseguire i seguenti controlli:

1. La richiesta DEVE includere tutti i parametri dell'intestazione HTTP richiesti come definito in Richiesta di Emissione della Wallet Attestation.

2. La firma della Richiesta di Wallet Attestation DEVE essere valida e verificabile utilizzando la jwk fornita.

3. Il valore nonce DEVE essere stato generato dal Fornitore di Wallet e non essere stato utilizzato in precedenza.

4. DEVE esistere un'Istanza del Wallet valida e attualmente registrata associata a quella fornita.

5. Il client_data DEVE essere ricostruito utilizzando il nonce e la chiave pubblica jwk. Il valore del parametro hardware_signature viene quindi convalidato utilizzando la chiave pubblica della Cryptographic Hardware Key registrata associata all'Istanza del Wallet.

6. L'integrity_assertion DEVE essere convalidato secondo le linee guida del produttore del dispositivo. I controlli specifici eseguiti dal Fornitore di Wallet sono dettagliati nella documentazione del produttore del sistema operativo.

7. Il dispositivo in uso DEVE essere privo di difetti di sicurezza noti e soddisfare i requisiti minimi di sicurezza definiti dal Fornitore di Wallet.

8. L'URL nel parametro iss DEVE corrispondere all'identificatore URL del Fornitore di Wallet.

Dopo il completamento con successo di tutti i controlli, il Fornitore di Wallet emette una Wallet Attestation valido per un massimo di 24 ore.

Passo 18 (Risposta di Emissione della Wallet Attestation): Al completamento con successo, il Fornitore di Wallet DEVE restituire una risposta di conferma utilizzando il codice di stato 200 e Content-Type application/json, contenente gli Attestati di Wallet firmati dal Fornitore di Wallet. Il Fornitore di Wallet DEVE restituire la Wallet Attestation in almeno tre formati: JWT, SD-JWT e mdoc. L'Istanza del Wallet eseguirà quindi la verifica di sicurezza e integrità degli Attestati di Wallet ricevuti oltre alla verifica di fiducia del suo Fornitore di Credenziali.

Di seguito è riportato un esempio non normativo della risposta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "wallet_attestations": [
    {
      "format": "jwt",
      "wallet_attestation": "ey..."
    },
    {
      "format": "dc+sd-jwt",
      "wallet_attestation": "ey..."
    },
    {
      "format": "mso_mdoc",
      "wallet_attestation": "omppc3N1ZXJBdXRohEOhASahG...ArQwggKwMIICVqADAgEC"
    }
  ]
}