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ê já 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 a 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.
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 conectam os dispositivos antigos e novos com um cabo USB, a chave de restauração é transferida do dispositivo antigo para o novo pelo cabo USB.
Depois que a chave de restauração estiver disponível no novo dispositivo, você poderá usá-la para fazer login do usuário.
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.
Gerenciar vários perfis do sistema e contas de apps
Ao implementar o recurso Restaurar Credenciais, 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 de sistema
Em dispositivos configurados com perfis de sistema separados (como um dispositivo corporativo com um perfil de trabalho e um perfil pessoal), a chave de restauração só está disponível para o perfil que foi configurado primeiro no dispositivo.
Limitações
A API Restore Credentials funciona em dispositivos móveis e não funciona em formatos.