Przywracanie danych logowania

Funkcja Przywracanie danych logowania w Menedżerze danych logowania umożliwia użytkownikom przywracanie kont aplikacji podczas konfigurowania nowego urządzenia. Ten interfejs API jest w wersji dla programistów. dostępne na wszystkich urządzeniach z Androidem 9 lub nowszym i Usługami Google Play (GMS) Core w wersji 242200000 lub nowszej. Zalety przywracania danych logowania obejmuje:

• Bezproblemowe korzystanie z aplikacji: użytkownicy mogą przywrócić swoje konto w aplikacji bez i konieczne jest ręczne logowanie się w poszczególnych aplikacjach.
• Wzrost zaangażowania użytkowników: użytkownicy chętniej będą korzystać z aplikacji, jeśli będą mogli przywrócić swoje konto podczas konfigurowania nowego urządzenia.
• Mniejsze nakłady na rozwój: funkcja przywracania danych logowania jest zintegrowana z Menedżerem danych logowania, więc deweloperzy, którzy obsługują już klucze dostępu, mogą dodać funkcje przywracania danych logowania.

Jak to działa

Za pomocą funkcji przywracania danych logowania możesz tworzyć, pobierać i usuwać odpowiednie dane logowania.

1. Utwórz dane logowania do przywracania: gdy użytkownik zaloguje się w aplikacji, utwórz dane logowania do przywracania powiązane z jego kontem. Te dane są przechowywane lokalnie i synchronizowane z chmurą, jeśli użytkownik ma włączoną usługę Kopia zapasowa Google i jest dostępny szyfrowanie end-to-end (aplikacje mogą zrezygnować z synchronizacji z chmurą).
2. Pobierz dane logowania do przywracania: gdy użytkownik skonfiguruje nowe urządzenie, Twoja aplikacja może poprosić Menedżera poświadczeń o dane logowania do przywracania. Dzięki temu możesz: automatycznego logowania użytkownika bez konieczności wprowadzania dodatkowych danych.
3. Wyczyść dane logowania do przywracania: gdy użytkownik wyloguje się z aplikacji, należy usunąć powiązane dane logowania do przywracania.

Funkcja przywracania danych logowania może płynnie integrować się z systemami backendu na których są już zaimplementowane klucze dostępu. Wynika to z faktu, że że zarówno klucze dostępu, jak i klucze do przywracania (typ danych logowania używany przez funkcji przywracania danych logowania) muszą spełniać te same podstawowe wymagania techniczne. specyfikacji. Dzięki temu procesowi procesu przywracania danych logowania skutecznie pobierać i przywracać dane logowania użytkowników przechowywane w systemów uczących się, zapewniając spójną i przyjazną dla użytkownika obsługę platform i metod uwierzytelniania.

Implementacja

Interfejs API przywracania danych logowania jest dostępny w bibliotece Jetpacka Menedżera poświadczeń. Aby zacząć go używać, wykonaj te czynności:

1. Dodaj do projektu zależność Credential Manager.

   // build.gradle.kts
   implementation("androidx.credentials:credentials:1.5.0-alpha03")
   

2. Utwórz obiekt CreateRestoreCredentialRequest.

3. Wywołaj metodę createCredential() obiektu CredentialManager.

   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)
   

   Te wygenerowane dane logowania do przywrócenia są typem klucza dostępu i są również znane jako klucza przywracania lub klucza przywracania.

4. Gdy użytkownik skonfiguruje nowe urządzenie, wywołaj metodę getCredential() obiektu CredentialManager.

   // 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)
   

5. Gdy użytkownik wyloguje się z aplikacji, wywołaj clearCredentialState() na obiekcie CredentialManager.

   // Create a ClearCredentialStateRequest object
   val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL)
   
   // On user log-out, clear the restore key
   val response = credentialManager.clearCredentialState(clearRequest)
   

Jeśli korzystasz z agenta zapasowego, wykonaj część getCredential w onRestore oddzwonienie. Dzięki temu dane logowania aplikacji zostaną przywrócone natychmiast po przywróceniu danych aplikacji.