Risolvere gli errori comuni di Gestore delle credenziali

android.os.TransactionTooLargeException

Ciò è dovuto a un problema noto in cui l'API credentialManager.getCredential() su Android 14 e versioni successive non mostra la finestra di dialogo di accesso quando sul dispositivo sono presenti più Account Google. Questo problema si verifica in modo specifico con GetGoogleIdOption e non con GetSignInWithGoogleOption. Questo problema è stato risolto in Google Play Services versione 24.40.XX e successive.

CreateCredentialCancellationException

La registrazione o il recupero della passkey è stato annullato dall'utente.

L'utente ha scelto di non creare o utilizzare una credenziale. Ora puoi modificare la tua UI per offrire un metodo di accesso alternativo o passare ai passaggi successivi della procedura.

GetCredentialCancellationException

La procedura di recupero delle credenziali è stata interrotta perché non è stata ottenuta l'autorizzazione utente necessaria. Sebbene ciò si verifichi più comunemente quando un utente annulla manualmente il flusso di accesso, può anche indicare che la richiesta non è stata autorizzata a causa di limitazioni tecniche. Poiché questo errore indica una mancanza di consenso, non riprovare automaticamente la richiesta, in quanto ciò crea un'esperienza utente negativa. Tuttavia, gli sviluppatori devono monitorare la frequenza di questa eccezione. Un volume elevato di "annullamenti" potrebbe in realtà indicare una configurazione errata, ad esempio un ambito mancante o errato, che impedisce il completamento corretto dell'interfaccia utente di autorizzazione. Se noti tendenze inattese, rivedi i parametri della richiesta e la configurazione della [relying party][2].

Nota: il messaggio di errore può variare in base al tipo di credenziale:

• Per le passkey, il messaggio di errore può essere "La registrazione o il recupero della passkey è stato annullato dall'utente".
• Per Accedi con Google, il messaggio di errore può essere "L'attività è stata annullata dall'utente".

CreateCredentialCustomException o GetCredentialCustomException

Quando utilizzi un SDK di terze parti per effettuare chiamate API con un oggetto richiesta che esegue la sottoclasse CreateCustomCredentialRequest o GetCustomCredentialOption, potresti riscontrare errori. In questo caso, controlla l'SDK per le costanti di tipo di eccezione personalizzate che corrispondono a e.type. Se non viene trovata alcuna corrispondenza, è sicuro eliminare o registrare l'eccezione.

CreateCredentialInterruptedException o GetCredentialInterruptedException

L'operazione potrebbe essere stata interrotta perché l'utente ha navigato nelle impostazioni per riconfigurare i gestori delle password. Anche altri motivi potrebbero aver contribuito all'interruzione. Riprova a chiamare.

CreateCredentialUnknownException

Durante il salvataggio della password, è stata rilevata una risposta di errore della password da One Tap 16: [28431] Il salvataggio della password viene ignorato perché è probabile che all'utente venga chiesto di utilizzare la compilazione automatica di Android.

Questo errore riguarda solo Android 13 e versioni precedenti quando Google è il provider di compilazione automatica designato. In questi casi, gli utenti riceveranno un prompt di salvataggio dalla compilazione automatica e la password verrà memorizzata in Gestore delle password di Google. È importante sottolineare che le credenziali salvate utilizzando la Compilazione automatica Google vengono sincronizzate in modo bidirezionale con l'API Credential Manager. Pertanto, questo errore può essere ignorato.

CreatePublicKeyCredentialDomException e GetPublicKeyCredentialDomException

È probabile che l'eccezione DOM contenga un domError più specifico. Puoi mappare questo valore a un DomException WebAuthn per ulteriori dettagli.

CreatePublicKeyCredentialDomException e GetPublicKeyCredentialDomException

La richiesta in entrata non può essere convalidata.

Il server del gestore delle password non riconosce l'ID pacchetto dell'app. Ciò indica un potenziale problema con l'integrazione lato server, in particolare con la configurazione del link alle risorse digitali. Verifica l'accuratezza dell'ID pacchetto e dell'SHA nel file Digital Asset Links.

CreatePublicKeyCredentialDomException:

Impossibile creare la chiave durante la registrazione

Questo problema può verificarsi quando un utente chiude la finestra di dialogo di blocco schermo durante la registrazione.

CreateCredentialNoCreateOptionException

Questa eccezione specifica indica che l'utente non ha configurato un gestore delle password valido. Questo errore non è un flusso di annullamento manuale avviato dall'utente, ma un errore separato.

CreatePublicKeyDomException e GetPublicKeyCredentialDomException

La registrazione della passkey è stata annullata dall'utente.

Il recupero della passkey è stato annullato dall'utente.

Questo problema può verificarsi quando un utente chiude la finestra di dialogo dell'impronta durante la registrazione / il recupero di una passkey.

GetCredentialProviderConfigurationException & CreateCredentialProviderConfigurationException

getCredentialAsync non sono state trovate dipendenze del provider

createCredentialAsync: nessuna dipendenza del fornitore trovata

Manca la dipendenza androidx.credentials:credentials-play-services-auth:<latest-version>.

GetCredentialUnsupportedException o CreateCredentialUnsupportedException

Il tuo dispositivo non supporta Gestore delle credenziali

Assicurati che la libreria delle credenziali sia aggiornata alla versione 1.2.1 o successive.

GetPublicKeyCredentialException

Impossibile decriptare le credenziali

Questo problema si verifica quando si tenta di utilizzare una passkey dopo aver eseguito l'accesso e l'uscita dagli Account Google. Chiedi all'utente di accedere di nuovo al proprio Account Google sul dispositivo.

NoCreateOptionException

Questa eccezione è il comportamento previsto quando un utente non ha configurato credenziali passkey sul proprio dispositivo o se non ha configurato un gestore delle password.

NoCredentialException

Nessuna credenziale corrispondente trovata

Questa eccezione si verifica nelle seguenti situazioni:

• setFilterByAuthorizedAccounts è impostato su true senza account autorizzati sul dispositivo.
• Non sono presenti account con accesso eseguito sul dispositivo (non sono stati aggiunti account o è necessaria la riautenticazione).
• L'interfaccia utente del foglio inferiore non viene visualizzata se i prompt di accesso sono disattivati per qualsiasi account sul dispositivo. Questa impostazione globale, disponibile in Impostazioni dell'Account Google > Accedi con Google, deve essere attivata per visualizzare l'interfaccia utente del foglio inferiore per qualsiasi account. Ciò non influisce sul flusso dei pulsanti.

Impossibile creare una passkey perché i dati criptati sono bloccati

L'utente deve reimpostare i dati lato server di Chrome. Questi dati includono i preferiti e le impostazioni di Chrome, oltre alle password e alle passkey salvate. Per maggiori informazioni sui dati memorizzati da Chrome, vai a Dati di Chrome nel tuo account.

1. Vai all'indirizzo chrome.google.com/sync.
2. In basso, seleziona Cancella dati.
3. Sul dispositivo, attiva la sincronizzazione in Chrome.

On Begin Sign In Failure: 8: errore interno sconosciuto.

Il dispositivo potrebbe non essere configurato correttamente con l'Account Google. Potrebbe esserci un problema con la modalità di creazione del file JSON della passkey. Verifica l'accuratezza dell'implementazione.

Impossibile recuperare l'account di sincronizzazione

Google Play Services versione 24.40.XX e successive forniranno codici di errore più informativi. Ad esempio, invece di "Impossibile ottenere l'account di sincronizzazione", i chiamanti ora riceveranno un messaggio di errore di annullamento.