O recurso "Restaurar credenciais" do Gerenciador de credenciais 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 fazer backup em um provedor de nuvem e usada para provisionar acesso no novo dispositivo do usuário.
Este guia pressupõe que você já conhece os seguintes conceitos:
Benefícios
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.
- Engajamento imediato: você pode envolver os usuários com notificações ou outros avisos assim que eles começarem a usar o novo dispositivo.
- Suporte a vários mecanismos de autenticação: funciona com todos os mecanismos de autenticação com suporte do Credential Manager, 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.
- Ter o backup de dados do Android ativado. 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, o recurso "Restaurar credenciais" funciona silenciosamente em segundo plano durante o processo de configuração do dispositivo. Os usuários podem escolher restaurar dados de uma das 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 é movida 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.
Processar vários perfis do sistema e contas de apps
Ao implementar o recurso "Restaurar credenciais", considere as seguintes restrições relacionadas a apps de várias contas e perfis no nível do sistema.
Apps com várias contas conectadas
Alguns apps permitem que os usuários alternem entre várias contas ativas (por exemplo, uma conta de e-mail pessoal e uma conta de e-mail de trabalho no mesmo app). O recurso "Restaurar credenciais" oferece suporte a apenas uma conta por app. Se um usuário estiver conectado a várias contas, selecione apenas uma para criar a chave de restauração. Normalmente, essa deve ser a conta principal ou usada mais 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 e um perfil pessoal), a chave de restauração só está disponível para o perfil que foi configurado primeiro no dispositivo.
Limitações
O recurso "Restaurar credenciais" funciona em dispositivos móveis e não funciona em diferentes form factors.