Risolvere gli errori comuni di Gestore delle credenziali

Questa guida elenca i codici di errore e le descrizioni comuni relativi a Gestore delle credenziali e fornisce alcune informazioni sulle relative cause.

Codice e descrizione dell'errore Causa

android.os.TransactionTooLargeEccezione

Il problema è causato da un problema noto per cui l'API credentialManager.getCredential() su Android 14 e versioni superiori non riesce a visualizzare 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 nella versione 24.40.XX e successive di Google Play Services.

CreateCredentialCancellationException o GetCredentialCancellationException

La registrazione o il recupero della passkey è stata annullata dall'utente.

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

CreateCredentialCustomException o GetCredentialCustomException

Quando utilizzi un SDK di terze parti per effettuare chiamate API con un oggetto di richiesta che ha come sottoclassi CreateCustomCredentialRequest o GetCustomCredentialOption, potresti riscontrare errori. Se si verifica questo problema, controlla nell'SDK le costanti di tipo di eccezione personalizzate che corrispondono a e.type. Se non viene trovata alcuna corrispondenza, puoi ignorare o registrare l'eccezione in sicurezza.

CreateCredentialInterruptedException o GetCredentialInterruptedException

L'operazione potrebbe essere stata interrotta perché l'utente è andato alle impostazioni per ricollegare i gestori delle password. Anche altri motivi potrebbero aver contribuito all'interruzione. Riprova a chiamare.

CreateCredentialUnknownException

Durante il salvataggio della password, è stata trovata una risposta di errore della password da un tocco 16: [28431] Viene ignorato il salvataggio della password perché è probabile che all'utente venga richiesto di utilizzare la compilazione automatica di Android.

Questo errore interessa solo Android 13 e le versioni precedenti quando Google è il provider di compilazione automatica designato. In questi casi, gli utenti riceveranno una richiesta di salvataggio da Compilazione automatica e la password verrà memorizzata in Gestore delle password di Google. È importante sottolineare che le credenziali salvate utilizzando la compilazione automatica con 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 mapparlo a un WebAuthn DomException 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 dei link ai asset digitali. Verifica l'accuratezza dell'ID pacchetto e dell'SHA all'interno del file dei link agli asset.

CreatePublicKeyCredentialDomEccezione:

Impossibile creare la chiave durante la registrazione

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

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 per le impronte digitali durante la registrazione / il recupero di una passkey.

GetCredentialProviderConfigurationException e CreateCredentialProviderConfigurationException

getCredentialAsync nessuna dipendenza dal provider trovata

createCredentialAsync nessuna dipendenza dal provider 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 la disconnessione e l'accesso nuovamente agli Account Google. Chiedi all'utente di accedere nuovamente al suo Account Google sul dispositivo.

NoCredentialException

Nessuna credenziale corrispondente trovata

Sul dispositivo non sono state trovate credenziali corrispondenti. Questo accade se l'utente non ha precedentemente salvato alcuna credenziale.

Impossibile creare una passkey a causa del blocco dei dati criptati

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 alla pagina chrome.google.com/sync.
  2. In basso, seleziona Cancella dati.
  3. Sul dispositivo, attiva la sincronizzazione in Chrome.

All'inizio dell'accesso non riuscito: 8: errore interno sconosciuto.

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

Impossibile recuperare l'account di sincronizzazione

Google Play Services 24.40.XX e versioni successive forniranno codici di errore più chiari. Ad esempio, anziché "Impossibile recuperare l'account di sincronizzazione", ora gli utenti che chiamano riceveranno un messaggio di errore di annullamento.