Mit der Funktion Anmeldedaten wiederherstellen des Anmeldedaten-Managers können Nutzer ihre App-Konten wiederherstellen, wenn sie ein neues Gerät einrichten. Diese API befindet sich in der Entwicklervorschau und ist auf allen Geräten mit Android 9 oder höher und der Google Play-Dienste-Kernversion 242200000 oder höher verfügbar. Die Funktion „Anmeldedaten wiederherstellen“ bietet folgende Vorteile:
- Einfache Bedienung: Nutzer können ihr App-Konto wiederherstellen, ohne sich manuell in jeder einzelnen App anmelden zu müssen.
- Mehr Nutzer-Engagement: Es ist wahrscheinlicher, dass Nutzer Ihre , wenn sie ihr Konto beim Einrichten eines neuen Geräts wiederherstellen können.
- Reduzierter Entwicklungsaufwand: Die Funktion „Anmeldedaten wiederherstellen“ ist integriert. mit Credential Manager. So können Entwickler, die bereits Passkeys unterstützen, Funktionen zur Wiederherstellung von Anmeldedaten.
Funktionsweise
Mit „Anmeldedaten wiederherstellen“ können Sie die entsprechenden Anmeldedaten erstellen, abrufen und löschen.
- Anmeldedaten für die Wiederherstellung erstellen: Wenn sich der Nutzer bei Ihrer App anmeldet, erstellen Sie die zum Konto gehörenden Anmeldedaten wiederherstellen. Diese Anmeldedaten werden gespeichert lokal und mit der Cloud synchronisiert, wenn der Nutzer Google Backup aktiviert hat und Verschlüsselung bis zum Ende ist verfügbar (Apps können die Synchronisierung mit der Cloud deaktivieren)
- Anmeldedaten für die Wiederherstellung abrufen: Wenn der Nutzer ein neues Gerät einrichtet, wird Ihre App kann die Wiederherstellung der Anmeldedaten vom Credential Manager anfordern. So können Sie Der Nutzer wird automatisch angemeldet, ohne dass eine zusätzliche Eingabe erforderlich ist.
- Anmeldedaten wiederherstellen: Wenn sich der Nutzer von Ihrer App abmeldet, sollte die zugehörigen Anmeldedaten für die Wiederherstellung löschen.
Die Funktion „Anmeldedaten wiederherstellen“ kann reibungslos in Back-End-Systeme integriert werden. für die bereits Passkeys implementiert wurden. Diese Kompatibilität ergibt sich daraus, dass sowohl Passkeys als auch Wiederherstellungsschlüssel (Anmeldedatentyp, der von der Funktion „Anmeldedaten wiederherstellen“ verwendet wird) denselben zugrunde liegenden technischen Spezifikationen entsprechen. Dieser Abgleich stellt sicher, dass der Prozess Nutzeranmeldedaten, die in Passkeys gespeichert sind, abrufen und reaktivieren und ermöglichen so eine einheitliche und nutzungsfreundliche Umgebung Plattformen und Authentifizierungsmethoden.
Implementierung
Die Restore Credentials API ist über die Credential Manager Jetpack-Bibliothek verfügbar. Die App lässt sich so aktivieren:
Füge deinem Projekt die Abhängigkeit vom Credential Manager hinzu.
// build.gradle.kts implementation("androidx.credentials:credentials:1.5.0-alpha03")
Erstellen Sie ein
CreateRestoreCredentialRequest
-Objekt.Rufen Sie die Methode
createCredential()
für das ObjektCredentialManager
auf.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)
Diese generierten Anmeldedaten zum Wiederherstellen sind eine Art Passkey und werden auch als Wiederherstellungspasskey oder Wiederherstellungsschlüssel bezeichnet.
Wenn der Nutzer ein neues Gerät einrichtet, rufen Sie die Methode
getCredential()
für dasCredentialManager
-Objekt auf.// 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)
Wenn sich der Nutzer von deiner App abmeldet, rufe die
clearCredentialState()
auf. für dasCredentialManager
-Objekt.// Create a ClearCredentialStateRequest object val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL) // On user log-out, clear the restore key val response = credentialManager.clearCredentialState(clearRequest)
Wenn Sie einen Sicherungs-Agent verwenden, führen Sie den Teil getCredential
innerhalb der
onRestore
-Callback. So werden die Anmeldedaten der App sofort nach der Wiederherstellung der App-Daten wiederhergestellt.