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 dostępny w wersji dla programistów i można go używać na wszystkich urządzeniach z Androidem 9 lub nowszym i Usługami Google Play (GMS) w wersji 242200000 lub nowszej. Zalety funkcji przywracania danych logowania:

  • Łatwa obsługa: użytkownicy mogą przywrócić swoje konto w aplikacji bez konieczności ręcznego logowania 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 Twojej aplikacji, utwórz dla niego certyfikat przywracania. Dane logowania są przechowywane lokalnie i synchronizowane z chmurą, jeśli użytkownik włączył Kopię zapasową Google i dostępne jest pełne szyfrowanie (aplikacje mogą zrezygnować z synchronizacji z chmurą).
  2. Uzyskaj dane logowania do przywracania: gdy użytkownik skonfiguruje nowe urządzenie, Twoja aplikacja może poprosić o przywrócenie danych logowania w Menedżerze danych logowania. Dzięki temu możesz automatycznie logować użytkownika bez konieczności podawania dodatkowych danych.
  3. Wyczyść przywrócone dane logowania: gdy użytkownik wyloguje się z aplikacji, powinieneś usunąć powiązane z nią przywrócone dane logowania.

Funkcja przywracania danych logowania może płynnie integrować się z systemami backendowymi, które mają już zaimplementowane klucze dostępu. Ta zgodność wynika z tego, że zarówno klucze dostępu, jak i klucze do przywracania (typ danych uwierzytelniających używany przez funkcję przywracania danych uwierzytelniających) są zgodne z tymi samymi podstawowymi specyfikacjami technicznymi. Dzięki temu proces przywracania danych logowania może skutecznie pobierać i przywracać dane logowania użytkownika zapisane w systemach obsługujących klucze dostępu, zapewniając spójne i przyjazne dla użytkownika działanie na różnych platformach i przy użyciu różnych metod uwierzytelniania.

Plansza dolna Menedżera danych logowania
Rysunek 1. Diagram przedstawiający przywracanie danych aplikacji na nowym urządzeniu za pomocą danych logowania do przywracania, w tym tworzenie danych logowania, inicjowanie procesu przywracania i automatyczne logowanie użytkownika

Implementacja

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

  1. Dodaj do projektu zależność menedżera danych logowania.

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

    Wygenerowane dane logowania do przywracania to rodzaj klucza dostępu. Nazywa się go też kluczem dostępu do przywracania lub kluczem do przywracania.

  4. Gdy użytkownik konfiguruje nowe urządzenie, wywołaj metodę getCredential() w obiekcie 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 metodę clearCredentialState() obiektu 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 używasz agenta zapasowego, wykonaj część getCredential w ramach wywołania zwrotnego onRestore. Dzięki temu dane logowania aplikacji zostaną przywrócone natychmiast po przywróceniu danych aplikacji.