Restablecer credenciales

La función Restablecer credenciales del Administrador de credenciales permite a los usuarios restablecer sus cuentas de apps cuando configuran un dispositivo nuevo. Esta API está en versión preliminar para desarrolladores y está disponible en todos los dispositivos que tengan Android 9 o versiones posteriores, y la versión principal 242200000 o posterior de los Servicios de Google Play (GMS). Entre los beneficios de la función Restablecer credenciales, se incluyen los siguientes:

• Experiencia del usuario optimizada: Los usuarios pueden restablecer su cuenta de la app sin necesidad de acceder manualmente a cada app individual.
• Mayor participación de los usuarios: Es más probable que los usuarios sigan usando tu app si pueden restablecer su cuenta cuando configuran un dispositivo nuevo.
• Menos esfuerzo de desarrollo: La función para restablecer credenciales está integrada en el Administrador de credenciales, por lo que los desarrolladores que ya admiten llaves de acceso pueden agregar capacidades de restablecimiento de credenciales.

Cómo funciona

Puedes usar la opción para restablecer credenciales para crear, obtener y borrar las credenciales relevantes.

1. Crea la credencial de restablecimiento: Cuando el usuario acceda a tu app, crea una credencial de restablecimiento asociada con su cuenta. Esta credencial se almacena de forma local y se sincroniza en la nube si el usuario habilitó la Copia de seguridad de Google y la encriptación de extremo a extremo está disponible (las apps pueden inhabilitar la sincronización con la nube).
2. Obtén la credencial de restablecimiento: Cuando el usuario configura un dispositivo nuevo, tu app puede solicitar la credencial de restablecimiento al Administrador de credenciales. Esto te permite que el usuario acceda automáticamente sin necesidad de ninguna entrada adicional.
3. Borra la credencial de restablecimiento: Cuando el usuario salga de tu app, debes borrar la credencial de restablecimiento asociada.

La función Restablecer credenciales puede integrarse sin problemas con los sistemas de backend que ya implementaron llaves de acceso. Esta compatibilidad se debe al hecho de que tanto las llaves de acceso como las claves de restablecimiento (tipo de credencial que usa la función Restablecer credenciales) cumplen con las mismas especificaciones técnicas subyacentes. Esta alineación garantiza que el proceso de restablecimiento de credenciales pueda recuperar y restablecer de manera eficaz las credenciales del usuario almacenadas en sistemas habilitados para llaves de acceso, lo que proporciona una experiencia coherente y fácil de usar en diferentes plataformas y métodos de autenticación.

Figura 1: Diagrama que muestra el restablecimiento de los datos de una app en un dispositivo nuevo con una credencial de restablecimiento, incluida la creación de la credencial, el inicio de un flujo de restablecimiento y el acceso automático del usuario

Nota: Las claves de restablecimiento son el único tipo de credencial compatible con esta función. Otros tipos de credenciales, como contraseñas, tokens de seguridad o datos biométricos, no son compatibles.

Implementación

La API de Restore Credentials está disponible a través de la biblioteca de Jetpack del Administrador de credenciales. Para comenzar, sigue estos pasos:

1. Agrega la dependencia del Administrador de credenciales a tu proyecto.

   // build.gradle.kts
   implementation("androidx.credentials:credentials:1.5.0-alpha03")
   

2. Crearás un objeto CreateRestoreCredentialRequest.

   Nota: Establece la marca isCloudBackupEnabled como true para habilitar la copia de seguridad automática de restoreKey (si el usuario tiene habilitada la Copia de seguridad de Google y la encriptación de extremo a extremo está disponible). Establece el valor en false si deseas que restoreKey se almacene de forma local y no en la nube.

3. Llama al método createCredential() en el objeto CredentialManager.

   val credentialManager = CredentialManager.create(context)
   
   // On a successful authentication create a Restore Key
   // Pass in the context and CreateRestoreCredentialRequest object
   val response = credentialManager.createCredential(context, createRestoreRequest)
   

   Esta credencial de restablecimiento generada es un tipo de llave de acceso y también se conoce como llave de acceso de restablecimiento o llave de restablecimiento.

4. Cuando el usuario configure un dispositivo nuevo, llama al método getCredential() en el objeto CredentialManager.

   // Fetch the Authentication JSON from server
   val authenticationJson = ...
   
   // Create the GetRestoreCredentialRequest object
   val options = GetRestoreCredentialOption(authenticationJson)
   val getRequest = GetCredentialRequest(Immutablelist.of(options))
   
   // The restore key can be fetched in two scenarios to
   // 1. On the first launch of app on the device, fetch the Restore Key
   // 2. In the onRestore callback (if the app implements the Backup Agent)
   val response = credentialManager.getCredential(context, getRequest)
   

5. Cuando el usuario salga de tu app, llama al método clearCredentialState() en el objeto CredentialManager.

   // Create a ClearCredentialStateRequest object
   val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL)
   
   // On user log-out, clear the restore key
   val response = credentialManager.clearCredentialState(clearRequest)
   

Si usas un agente de copia de seguridad, realiza la parte getCredential dentro de la devolución de llamada onRestore. Esto garantiza que las credenciales de la app se restablezcan inmediatamente después de que se restablezcan los datos de la app.

Nota: La función Restablecer credenciales no controla la situación en la que se reinstala una app en el mismo dispositivo. La desinstalación de una app se interpreta como un intento de borrar la clave de restablecimiento correspondiente de ese dispositivo.