Fluxo de integração do Android

Para integrar o Smart Lock para senhas ao seu app Android, adicione chamadas à API Credentials ao fluxo de inicialização e login do app. O diagrama a seguir mostra o fluxo de um app Android típico que usa o Smart Lock para senhas.

Embora existam muitas maneiras de integrar o Smart Lock para senhas e as especificidades de uma integração dependem da estrutura e da experiência do usuário do app, o fluxo a seguir é recomendado para a maioria dos apps. Os apps que usam esse fluxo têm estas vantagens na experiência do usuário:

• Os usuários existentes do serviço que têm uma única credencial salva são conectados imediatamente e vão diretamente para a visualização de login quando abrem o app.
• Os usuários que têm várias credenciais salvas ou que desativaram o login automático precisam responder a apenas uma caixa de diálogo antes de acessar a visualização de login do app.
• Os usuários que não têm credenciais salvas ou ainda não se inscreveram podem escolher o nome e o e-mail com um único toque e ser enviados de forma inteligente para a visualização de login ou inscrição, com essas informações já preenchidas.
• Quando os usuários saem, o app garante que eles não façam login automaticamente novamente.

Recuperar credenciais

1. Quando o app for iniciado, se nenhum usuário já tiver feito login, chame CredentialsClient.request().
2. Se o Task for bem-sucedido, consiga as credenciais do usuário com getResult().getCredential() e use-as para fazer login.
3. Se o Task falhar e a exceção for uma instância de ResolvableApiException, e getStatusCode() retornar RESOLUTION_REQUIRED, a entrada do usuário será necessária para escolher uma credencial. Chame startResolutionForResult() para solicitar que o usuário selecione uma conta salva e, em seguida, chame getParcelableExtra(Credential.EXTRA_KEY) para receber as credenciais dele e usá-las para fazer login.

Salvar credenciais

4. Se o Task falhar com um ApiException e getStatusCode() retornar SIGN_IN_REQUIRED, o usuário não tem credenciais salvas e precisa fazer login ou se inscrever manualmente usando seu fluxo de login ou inscrição atual. Depois que o usuário concluir o login, ofereça a ele uma oportunidade de salvar as credenciais para recuperação futura (etapa 5).

   Você pode ajudar o usuário a fazer login ou se inscrever com mais rapidez e facilidade recuperando dicas de login, como o endereço de e-mail do usuário. O usuário pode selecionar a dica e pular a etapa de digitar as credenciais. Se o app exige que os usuários façam login, você pode optar por recuperar dicas imediatamente após a solicitação de credenciais inicial falhar. Caso contrário, é possível esperar até que o usuário inicie o fluxo de login ou inscrição.

   1. Chame CredentialsClient.getHintPickerIntent() e inicie a intent para solicitar que o usuário selecione uma conta. Em seguida, chame getParcelableExtra(Credential.EXTRA_KEY) para receber a dica de login.
   2. Se o ID do usuário da dica corresponder a um usuário atual, preencha automaticamente o formulário de login e permita que o usuário digite a senha para fazer login.
   3. Se o ID do usuário da dica não corresponder a um usuário atual, preencha automaticamente o formulário de inscrição com o ID e o nome do usuário e permita que ele crie uma nova conta.

5. Depois que o usuário fizer login ou criar uma conta, salve o ID e a senha com CredentialsClient.save().

   Se o usuário fez login com um provedor de identidade federado, como o Login do Google, crie o objeto Credential com o endereço de e-mail do usuário como o ID e especifique o provedor de identidade com setAccountType.

Sair

6. Quando o usuário sair, chame CredentialsClient.disableAutoSignIn() para evitar que o usuário faça login de novo imediatamente. Desativar o login automático também permite que os usuários alternem entre contas com facilidade, por exemplo, entre contas de trabalho e pessoais, ou entre contas em dispositivos compartilhados, sem precisar reinserir as informações de login.

Tudo pronto para integrar o Smart Lock para senhas ao seu app? Comece a usar o serviço.