Sobre a restauração de credenciais

O recurso Restaurador de Credenciais do Credential Manager permite que os usuários restaurem automaticamente as contas de apps e façam login ao abrir um app pela primeira vez após configurar um novo dispositivo. Uma credencial de restauração, também conhecida como chave de restauração, é um tipo de credencial que pode ser salva localmente ou armazenada em backup em um provedor de nuvem e usada para provisionar o acesso no novo dispositivo do usuário.

Este guia pressupõe que você conhece os seguintes conceitos:

Vantagens

Os benefícios do recurso Restaurar Credenciais incluem:

  • Experiência do usuário integrada: os usuários podem começar a usar o app imediatamente no novo dispositivo sem precisar fazer login manualmente.
  • Maior retenção de usuários e custos de suporte reduzidos: o login automático durante upgrades de dispositivos evita que os usuários desistam e reduz significativamente os custos de suporte associados a contas abandonadas e fluxos de recuperação de senha.
  • Segurança aprimorada: a restauração silenciosa de credenciais elimina telas de login extras e solicitações manuais de recuperação de conta, reduzindo a vulnerabilidade a ataques de phishing e roubo de credenciais.
  • Engajamento imediato: você pode engajar os usuários com notificações ou outras solicitações assim que eles começarem a usar o novo dispositivo.
  • Suporte para vários mecanismos de autenticação: funciona com vários mecanismos de autenticação, incluindo:

Visão geral do processo

As seções a seguir descrevem o processo necessário em cada dispositivo:

No dispositivo anterior

Gere a chave de restauração depois que o usuário se autenticar no app, imediatamente após o login e durante uma inicialização subsequente do app, se ele já estiver conectado. O serviço de backup do Android armazena automaticamente a chave de restauração gerada no dispositivo e, com base nas configurações de backup do usuário, também a salva na nuvem.

Para que um usuário possa fazer backup na nuvem, ele precisa atender aos seguintes requisitos:

  • Ter feito login na própria Conta do Google.
  • Ativar o backup de dados do Android. Para mais informações, consulte Backup de dados.
  • Ter um mecanismo de desbloqueio de tela configurado, como padrão, PIN, senha ou biometria.

Se essas condições não forem atendidas, uma E2eeUnavailableException será gerada. Quando isso acontecer, capture a exceção e chame createCredential() novamente com isCloudBackupEnabled = false para que a chave de restauração ainda seja salva localmente para transferências de dispositivo para dispositivo (D2D).

No dispositivo novo

Quando o usuário configura o novo dispositivo, as credenciais de restauração funcionam silenciosamente em segundo plano durante o processo de configuração. Os usuários podem restaurar dados com as seguintes opções:

  • De um backup na nuvem: se um backup na nuvem for usado, a chave de restauração será baixada com os dados do app para o novo dispositivo.
  • Usando uma transferência de dispositivo para dispositivo: quando os usuários transferem dados diretamente entre os dispositivos antigos e novos durante a configuração, a chave de restauração é movida do dispositivo antigo para o novo por um cabo USB ou uma transferência sem fio de dispositivo para dispositivo (D2D, na sigla em inglês) por Wi-Fi.

Depois que a chave de restauração estiver disponível no novo dispositivo, você poderá usá-la para fazer login do usuário.

O fluxo para restaurar credenciais de um dispositivo antigo para um novo não requer interação do usuário.
Figura 1: visão geral do processo para restaurar credenciais

Parear o Restaurador de Credenciais com o backup de dados do app

Além de fazer login, o app precisa transferir as configurações locais, os rascunhos off-line e as preferências de tema escuro do usuário para oferecer uma transição de dispositivo completa e sem atrito:

  • Restaurar identidade: use as credenciais de restauração para autenticar novamente o acesso à conta de forma silenciosa.
  • Restaurar estado e preferências: configure o Backup Automático (dataExtractionRules) para preservar as preferências do usuário, os bancos de dados locais e o estado do app em transferências de dispositivos por cabo e na nuvem. Exclua tokens de autenticação brutos, texto criptografado do Android Keystore vinculado ao hardware e o marcador local has_synced_restore_credential para que o estado de sessão desatualizado não seja copiado para o novo dispositivo.

Gerenciar vários perfis do sistema e contas de apps

Ao implementar o recurso de credenciais de restauração, considere as seguintes restrições relacionadas a apps com várias contas e perfis no nível do sistema.

Apps com login múltiplo

Alguns apps permitem que os usuários alternem entre várias contas ativas (por exemplo, uma conta de e-mail pessoal e uma de trabalho no mesmo app). A API Restore Credentials oferece suporte a apenas uma conta por app. Se um usuário tiver feito login em várias contas, você precisará selecionar apenas uma para criar a chave de restauração. Normalmente, essa deve ser a conta principal ou a mais usada recentemente.

Dispositivos com vários perfis do sistema

Em dispositivos configurados com perfis de sistema separados (como um dispositivo corporativo com um perfil de trabalho gerenciado e um perfil pessoal), a chave de restauração está disponível para o perfil principal configurado durante a integração inicial do dispositivo. Se uma política de TI empresarial desativar o backup entre dispositivos ou a transferência de credenciais em um perfil de trabalho gerenciado, createCredential() ou getCredential() poderá não retornar nenhuma credencial, e o app precisará usar o login padrão.

Limitações

A Restore Credentials pode ser usada em smartphones, dobráveis e tablets Android com o Android 9 (nível 28 da API) ou mais recente e o Google Play Services versão 242200000 ou mais recente. A restauração entre categorias de dispositivos (como restaurar de um smartphone para o Wear OS, Android TV, Android Auto, Android XR ou ChromeOS) não é compatível. Consulte Autenticar em vários formatos.

Próximas etapas