La funzionalità Ripristina credenziali di Gestore delle credenziali consente agli utenti di ripristinare le proprie account di app durante la configurazione di un nuovo dispositivo. Questa API è in anteprima per gli sviluppatori e disponibile su tutti i dispositivi con Android 9 o versioni successive e Google Play Services (GMS) Core 242200000 o versioni successive. I vantaggi del ripristino delle credenziali include:
- Esperienza utente perfetta: gli utenti possono ripristinare il proprio account dell'app senza dover accedere manualmente a ogni singola app.
- Maggiore coinvolgimento degli utenti: è più probabile che gli utenti continuino a utilizzare il tuo app se può ripristinare il proprio account durante la configurazione di un nuovo dispositivo.
- Riduzione dello sforzo di sviluppo: la funzionalità di ripristino delle credenziali è integrata con Gestore delle credenziali, pertanto gli sviluppatori che supportano già le passkey possono aggiungere funzionalità di ripristino delle credenziali.
Come funziona
Puoi usare le credenziali di ripristino per creare, ottenere e cancellare i dati e credenziali.
- Crea la credenziale di ripristino: quando l'utente accede all'app, crea una credenziale di ripristino associata al proprio account. Questa credenziale viene memorizzata localmente e sincronizzata con il cloud se l'utente ha attivato il Backup di Google e la crittografia end-to-end è disponibile (le app possono disattivare la sincronizzazione con il cloud).
- Ottieni la credenziale di ripristino: quando l'utente configura un nuovo dispositivo, la tua app può richiedere la credenziale di ripristino da Gestione credenziali. Questo consente di consente all'utente di accedere automaticamente senza richiedere ulteriori input.
- Cancellare la credenziale di ripristino: quando l'utente si disconnette dall'app, Deve eliminare la credenziale di ripristino associata.
La funzionalità Ripristina credenziali può essere integrata senza problemi con i sistemi di backend che hanno già implementato le passkey. Questa compatibilità deriva dal fatto che sia le passkey sia le chiavi di ripristino (tipo di credenziale utilizzato dalla funzionalità Ripristina credenziali) rispettano le stesse specifiche tecniche di base. Questo allineamento assicura che il processo di ripristino delle credenziali possa Recuperare e reintegrare in modo efficace le credenziali utente memorizzate in chiavi abilitate sistemi, offrendo un'esperienza coerente e facile da usare in diversi le piattaforme e i metodi di autenticazione.
Implementazione
L'API Restore Credentials è disponibile tramite la libreria Credential Manager Jetpack. Per iniziare, procedi nel seguente modo:
Aggiungi la dipendenza Gestore delle credenziali al progetto.
// build.gradle.kts implementation("androidx.credentials:credentials:1.5.0-alpha03")
Crea un oggetto
CreateRestoreCredentialRequest
.Chiama il metodo
createCredential()
sull'oggettoCredentialManager
.val credentialManager = CredentialManager.create(context) // On a successful authentication create a Restore Key // Pass in the context and CreateRestoreCredentialRequest object val response = credentialManager.createCredential(context, createRestoreRequest)
Questa credenziale di ripristino generata è un tipo di passkey ed è nota anche come passkey di ripristino o chiave di ripristino.
Quando l'utente configura un nuovo dispositivo, chiama il metodo
getCredential()
sulla OggettoCredentialManager
.// Fetch the Authentication JSON from server val authenticationJson = ... // Create the GetRestoreCredentialRequest object val options = GetRestoreCredentialOption(authenticationJson) val getRequest = GetCredentialRequest(Immutablelist.of(options)) // The restore key can be fetched in two scenarios to // 1. On the first launch of app on the device, fetch the Restore Key // 2. In the onRestore callback (if the app implements the Backup Agent) val response = credentialManager.getCredential(context, getRequest)
Quando l'utente esce dalla tua app, chiama il
clearCredentialState()
sull'oggettoCredentialManager
.// Create a ClearCredentialStateRequest object val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL) // On user log-out, clear the restore key val response = credentialManager.clearCredentialState(clearRequest)
Se utilizzi un agente di backup, esegui la parte getCredential
all'interno del callback onRestore
. In questo modo ti assicuri che le credenziali dell'app vengano ripristinate
subito dopo il ripristino dei dati dell'app.