Flujo de integración de Android

Obsoleto: Smart Lock para contraseñas está obsoleto. Todas las funciones de Smart Lock para contraseñas migraron al acceso con One Tap. En su lugar, usa One Tap.

Para integrar Smart Lock para contraseñas en tu app para Android, debes agregar llamadas a la API de credenciales en el flujo de inicio y acceso de tu app. En el siguiente diagrama, se muestra el flujo de una app para Android típica que usa Smart Lock para contraseñas.

Si bien existen muchas formas de integrar correctamente Smart Lock para contraseñas y los detalles de una integración dependen de la estructura y la experiencia del usuario de la app, se recomienda el siguiente flujo para la mayoría de las apps. Las apps que usan este flujo tienen las siguientes ventajas en la experiencia del usuario:

• Los usuarios existentes de tu servicio que tengan una sola credencial guardada accederán de inmediato y irán directamente a la vista de acceso cuando abran la app.
• Los usuarios que tienen varias credenciales guardadas o que inhabilitaron el acceso automático deben responder a un solo diálogo antes de acceder a la vista de acceso de la app.
• Los usuarios que no tengan credenciales guardadas o que aún no se hayan registrado pueden seleccionar su nombre y correo electrónico con solo presionar una vez y enviarse de forma inteligente a la vista de acceso o de registro, con esta información ya completada.
• Cuando los usuarios cierran sesión, la app se asegura de que no vuelvan a acceder automáticamente.

Recuperar credenciales

1. Cuando se inicie la app, si aún no accedió ningún usuario, llama a CredentialsClient.request().
2. Si Task es correcto, obtén las credenciales del usuario con getResult().getCredential() y úsalas para acceder.
3. Si Task falla y la excepción es una instancia de ResolvableApiException y getStatusCode() muestra RESOLUTION_REQUIRED, se requiere la entrada del usuario para elegir una credencial. Llama a startResolutionForResult() para solicitarle al usuario que seleccione una cuenta guardada; luego, llama a getParcelableExtra(Credential.EXTRA_KEY) a fin de obtener las credenciales del usuario y úsalo para acceder.
   Si no puedes acceder con las credenciales recuperadas porque la contraseña es incorrecta o la cuenta no existe, borra las credenciales de Smart Lock con CredentialsClient.delete().

Guardar credenciales

4. Si Task falla con un ApiException y getStatusCode() muestra SIGN_IN_REQUIRED, el usuario no tiene credenciales guardadas y debe acceder o registrarse de forma manual con el flujo de acceso o de registro actual. Una vez que el usuario completa el acceso con éxito, puedes darle la oportunidad de guardar sus credenciales para recuperarlos en el futuro (paso 5).

   Puedes ayudar al usuario a acceder o registrarse de manera más rápida y fácil recuperando sugerencias de acceso, como la dirección de correo electrónico del usuario. El usuario puede seleccionar la sugerencia y omitir el ingreso de sus credenciales. Si tu app requiere que los usuarios accedan, puedes optar por recuperar sugerencias inmediatamente después de que falle la solicitud de credenciales inicial (de lo contrario, puedes esperar hasta que el usuario inicie el flujo de acceso o registro).

   1. Llama a CredentialsClient.getHintPickerIntent(), inicia el intent para pedirle al usuario que seleccione una cuenta y, luego, llama a getParcelableExtra(Credential.EXTRA_KEY) para obtener la sugerencia de acceso.
   2. Si el ID de usuario de la sugerencia coincide con un usuario existente, completa previamente el formulario de acceso y deja que el usuario ingrese la contraseña para acceder.
   3. Si el ID de usuario de la sugerencia no coincide con un usuario existente, completa previamente el formulario de registro con el ID y el nombre del usuario y permite que el usuario cree una cuenta nueva.

5. Después de que el usuario acceda correctamente o cree una cuenta, guarda el ID y la contraseña del usuario con CredentialsClient.save().

   Si el usuario accedió con un proveedor de identidad federada, como Acceso con Google, crea el objeto Credential con la dirección de correo electrónico del usuario como ID y especifica el proveedor de identidad con setAccountType.

Cómo salir de tu cuenta

6. Cuando el usuario salga de su cuenta, llama a CredentialsClient.disableAutoSignIn() para evitar que vuelva a acceder de inmediato. Inhabilitar el acceso automático también permite a los usuarios cambiar de cuenta fácilmente (por ejemplo, entre cuentas personales y de trabajo, o entre cuentas en dispositivos compartidos) sin tener que volver a ingresar su información de acceso.

¿Estás listo para integrar Smart Lock para contraseñas en tu aplicación? Comienza.