Data di pubblicazione: 26 novembre 2025
Puoi partecipare alla prova dell'origine per l'emissione dell'API Digital Credentials a partire da Chrome 143. Questa nuova API consente ai siti web di eseguire più facilmente il provisioning delle credenziali digitali nel wallet preferito dell'utente.
Informazioni di base
Nell'ecosistema di identità digitale di emittenti, verificatori (parti che fanno affidamento) e titolari (wallet), è comune che un utente fornisca un documento di identità digitale nel proprio wallet tramite il provisioning push. Durante la procedura, l'utente avvia la procedura di emissione del documento di identità direttamente dal sito web o dall'app dell'emittente. Ad esempio, un utente che visita il sito web della motorizzazione (emittente) di uno stato può avviare la procedura per salvare la patente digitale nell'app del portafoglio preferita (titolare) sul proprio dispositivo.
Affinché questo modello abbia successo, l'emittente ha bisogno di un modo sicuro e affidabile per connettersi all'app del portafoglio per emettere la carta di identità. Questo processo è stato frammentato, in quanto ogni emittente doveva creare le proprie connessioni per ogni app per il portafoglio con cui collaborava, in genere basandosi su schemi URI personalizzati. Questo approccio ha creato notevoli difficoltà di implementazione, costringendo gli emittenti a creare e mantenere il supporto per un ecosistema frammentato di diverse integrazioni di portafogli.
Emissione dell'API Digital Credentials
Per semplificare questo processo, Chrome sta ampliando il supporto dell'API W3C Digital Credentials,
aggiungendo le funzionalità di presentazione rilasciate di recente.
Il metodo navigator.credentials.create() consente ai siti web degli emittenti di richiamare in modo sicuro le app per il portafoglio per l'emissione di credenziali. Quando il sito web di un emittente chiama
navigator.credentials.create() con un membro di digital, il browser
delega il flusso alla piattaforma, che è limitata ad Android a partire da Chrome 143.
La piattaforma mostra un elenco di portafogli compatibili installati sul dispositivo.
L'utente può quindi selezionare un portafoglio e dare il consenso per aggiungere la credenziale.
L'emissione dell'API Digital Credentials funziona sia per scenari sullo stesso dispositivo (su dispositivo mobile) sia cross-device (avviati da computer). In uno scenario cross-device, il browser desktop mostra un codice QR. Quando l'utente esegue la scansione del codice sul proprio dispositivo mobile, viene avviato il flusso mediato dalla piattaforma, se entrambi i dispositivi si trovano nelle vicinanze.
Come utilizzare l'API
L'API è indipendente dal protocollo e progettata per funzionare con standard aperti, ad esempio lo standard OpenID for Verifiable Credential Issuance (OpenID4VCI).
Per avviare il flusso di emissione, il sito web dell'emittente deve chiamare
navigator.credentials.create() e passare le richieste di emissione all'interno di un
oggetto digital, ad esempio:
// Check if the browser supports Digital Credentials issuance and the protocol.
if (window.DigitalCredential && DigitalCredential.userAgentAllowsProtocol('openid4vci-v1')) {
// Construct a credential offer according to the OpenID4VCI specification.
// Note: The API is in an active development stage. Always consult the
// specification and documentation for the most recent implementation details
const credentialOffer = {
credential_issuer: 'https://digital-credentials.dev',
credential_configuration_ids: [
'org.iso.18013.5.1.mDL'
],
authorization_server_metadata: {
issuer: 'https://digital-credentials.dev',
token_endpoint: 'https://digital-credentials.dev/openid4vci/token',
authorization_endpoint: 'https://digital-credentials.dev/openid4vci/auth',
grant_types_supported: [
'authorization_code',
'urn:ietf:params:oauth:grant-type:pre-authorized_code'
],
response_types_supported: ['code','token']
},
// Metadata details to help the wallet display the credential correctly.
credential_issuer_metadata: {
credential_endpoint: 'https://digital-credentials.dev/openid4vci/credential',
credential_configurations_supported: {
'org.iso.18013.5.1.mDL': {
format: 'mso_mdoc',
display: [{
name: 'Driving License',
locale: 'en-US',
description: 'Mobile Driving License'
}],
// The claims that this document contains.
// For a full list of standard mDL claims, see the ISO/IEC 18013-5 specification.
claims: [{
path: ['org.iso.18013.5.1', 'family_name'],
display: [{ name: 'Family Name', locale: 'en-US' }]
}
// ... Add any other claims for your document here.
]
}
}
}
};
// This call is made from the issuer's frontend, likely inside a button's click handler.
try {
await navigator.credentials.create({
digital: {
requests: [{
// The protocol identifier for this version of OpenID4VCI.
protocol: 'openid4vci-v1',
data: credentialOffer
}
}]
}
});
console.log('Credential issuance handoff to OS was successful.');
} catch (e) {
console.error('Error starting the credential issuance flow:', e);
}
} else {
// The API is not supported. Provide an alternative issuance method.
console.log('Digital Credential Issuance API is not supported in this browser.');
}
Prova
Prima di testare l'API Digital Credentials nel browser e sul dispositivo Android:
- Aggiorna Chrome alla versione 143 o successive sul computer e Google Play Services alla versione 24.0 o successive sul tuo dispositivo Android.
- Attiva il flag all'indirizzo
chrome://flags/#web-identity-digital-credentials-creationnel browser. - Installa un'app per il portafoglio supportata sul tuo dispositivo Android, ad esempio la demo CMWallet.
Per testare il flusso cross-device per l'emissione di credenziali digitali:
- Vai alla pagina https://digital-credentials.dev/dmv su computer.
- Premi il pulsante Aggiungi per avviare il flusso di emissione.
- Scansiona il codice QR con il tuo dispositivo Android e segui le istruzioni.
Dopo aver seguito questi passaggi, avrai una nuova credenziale emessa per il wallet sul tuo dispositivo Android.
Per abilitare questa funzionalità sul tuo sito web per gli utenti, partecipa alla prova dell'origine dell'API Digital Credentials per l'emissione. Per ulteriori informazioni, consulta l'articolo Guida introduttiva alle prove di origine.
Condividi il tuo feedback
Il tuo feedback è fondamentale per continuare a migliorare la piattaforma. Segnala eventuali bug o richieste di funzionalità in Chromium Bug Tracker.