Bloquear tienda

Muchos usuarios siguen administrando sus propias credenciales cuando configuran un nuevo dispositivo Android. Este proceso manual puede ser difícil y, a menudo, da como resultado una experiencia del usuario deficiente. Para resolver este problema, la API de Block Store, una biblioteca con la tecnología de los Servicios de Google Play, proporciona a las apps una forma de guardar las credenciales de los usuarios sin la complejidad o el riesgo de seguridad asociados con su guardado.

La API de Block Store permite que tu app almacene datos que luego puede recuperar para volver a autenticar a los usuarios en un dispositivo nuevo. Esto ayuda a proporcionar una experiencia más fluida al usuario, ya que no necesita ver una pantalla de acceso cuando inicias tu app por primera vez en el dispositivo nuevo.

Los beneficios de usar Block Store son los siguientes:

• Solución de almacenamiento de credenciales encriptadas para desarrolladores. Las credenciales se encriptan de extremo a extremo siempre que sea posible.
• Guarda los tokens en lugar de nombres de usuario y contraseñas.
• Elimina las complicaciones de los flujos de acceso.
• Evite a los usuarios de la carga de administrar contraseñas complejas.
• Google verifica la identidad del usuario.

Nota: El uso de Block Store no limita el usuario al tipo de credenciales que se pueden usar. Los usuarios pueden acceder con su nombre de usuario y contraseña, su Cuenta de Google o cualquier otro proveedor de identidad federada, y Block Store aún funciona.

Antes de comenzar

Para preparar tu app, completa los pasos que se indican en las siguientes secciones.

Cómo configurar tu app

En el archivo build.gradle a nivel de proyecto, incluye el repositorio Maven de Google en las secciones buildscript y allprojects:

buildscript {
  repositories {
    google()
    mavenCentral()
  }
}

allprojects {
  repositories {
    google()
    mavenCentral()
  }
}

Agrega la dependencia de los Servicios de Google Play para la API de Block Store al archivo de compilación de Gradle de tu módulo, que suele ser app/build.gradle:

dependencies {
  implementation 'com.google.android.gms:play-services-auth-blockstore:16.2.0'
}

Cómo funciona

Block Store permite a los desarrolladores guardar y restaurar hasta 16 arrays de bytes. Esto te permite guardar información importante sobre la sesión de usuario actual y te ofrece la flexibilidad de guardarla como desees. Estos datos se pueden encriptar de extremo a extremo, y la infraestructura compatible con Block Store se basa en la infraestructura de copias de seguridad y restablecimientos.

En esta guía, se explica el caso práctico de guardar el token de un usuario en Block Store. En los siguientes pasos, se describe cómo funciona una app que usa Block Store:

1. Durante el flujo de autenticación de tu app, o en cualquier momento posterior, puedes almacenar el token de autenticación del usuario en Block Store para su posterior recuperación.
2. El token se almacenará de forma local y también se podrá crear una copia de seguridad en la nube, que se encriptará de extremo a extremo siempre que sea posible.
3. Los datos se transfieren cuando el usuario inicia un flujo de restablecimiento en un dispositivo nuevo.
4. Si el usuario restablece tu app durante el flujo de restablecimiento, tu app puede recuperar el token guardado de Block Store en el dispositivo nuevo.

Guarda el token

Cuando un usuario accede a tu app, puedes guardar el token de autenticación que generas para ese usuario en Block Store. Puedes almacenar este token con un valor de par de claves único que tenga un máximo de 4 KB por entrada. Para almacenar el token, llama a setBytes() y 'setKey(/android/reference/com/google/android/gms/auth/blockstore/StoreBytesData.Builder.html#setKey(java.lang.String)' en una instancia de StoreBytesData.Builder para almacenar las credenciales del usuario en el dispositivo de origen. Después de guardar el token con Block Store, este se encripta y se almacena de forma local en el dispositivo.

En el siguiente ejemplo, se muestra cómo guardar el token de autenticación en el dispositivo local:

Java

  BlockstoreClient client = Blockstore.getClient(this);
  byte[] bytes1 = new byte[] { 1, 2, 3, 4 };  // Store one data block.
  String key1 = "com.example.app.key1";
  StoreBytesData storeRequest1 = StoreBytesData.Builder()
          .setBytes(bytes1)
          // Call this method to set the key value pair the data should be associated with.
          .setKeys(Arrays.asList(key1))
          .build();
  client.storeBytes(storeRequest1)
    .addOnSuccessListener(result -> Log.d(TAG, "stored " + result + " bytes"))
    .addOnFailureListener(e -> Log.e(TAG, "Failed to store bytes", e));

Kotlin

  val client = Blockstore.getClient(this)

  val bytes1 = byteArrayOf(1, 2, 3, 4) // Store one data block.
  val key1 = "com.example.app.key1"
  val storeRequest1 = StoreBytesData.Builder()
    .setBytes(bytes1) // Call this method to set the key value with which the data should be associated with.
    .setKeys(Arrays.asList(key1))
    .build()
  client.storeBytes(storeRequest1)
    .addOnSuccessListener { result: Int ->
      Log.d(TAG,
            "Stored $result bytes")
    }
    .addOnFailureListener { e ->
      Log.e(TAG, "Failed to store bytes", e)
    }

¿Bytes previamente almacenados sin una clave?

Si ya usaste la API de StoreBytes() para guardar tus datos, te recomendamos que comiences a guardar tus tokens con una clave. Los datos guardados anteriormente con StoreBytes ahora se guardan con la clave BlockstoreClient.DEFAULT_BYTES_DATA_KEY.

Usar token predeterminado

Los datos guardados con StoreBytes sin una clave usan la clave predeterminada BlockstoreClient.DEFAULT_BYTES_DATA_KEY.

Java

  BlockstoreClient client = Blockstore.getClient(this);
  // The default key BlockstoreClient.DEFAULT_BYTES_DATA_KEY.
  byte[] bytes = new byte[] { 9, 10 };
  StoreBytesData storeRequest = StoreBytesData.Builder()
          .setBytes(bytes)
          .build();
  client.storeBytes(storeRequest)
    .addOnSuccessListener(result -> Log.d(TAG, "stored " + result + " bytes"))
    .addOnFailureListener(e -> Log.e(TAG, "Failed to store bytes", e));

Kotlin

  val client = Blockstore.getClient(this);
  // the default key BlockstoreClient.DEFAULT_BYTES_DATA_KEY.
  val bytes = byteArrayOf(1, 2, 3, 4)
  val storeRequest = StoreBytesData.Builder()
    .setBytes(bytes)
    .build();
  client.storeBytes(storeRequest)
    .addOnSuccessListener { result: Int ->
      Log.d(TAG,
            "stored $result bytes")
    }
    .addOnFailureListener { e ->
      Log.e(TAG, "Failed to store bytes", e)
    }

¿Cómo se almacenan los datos en el dispositivo y quién puede acceder a ellos?

En el dispositivo, los datos de BlockStore se almacenan en el directorio de datos privados locales de los Servicios de Google Play. Ninguna otra app puede acceder directamente al archivo de datos. Solo pueden acceder a datos de BlockStore mediante la API de retrieveBytes(), y una app solo puede recuperar datos almacenados por sí misma. Servicios de Google Play verifica el nombre y la firma del paquete.

Recupera el token

Más adelante, cuando un usuario realiza el proceso de restablecimiento en un dispositivo nuevo, los Servicios de Google Play verifican primero el usuario y, luego, recuperan los datos de Block Store. El usuario ya aceptó restablecer los datos de la app como parte del flujo de restablecimiento, por lo que no se requieren consentimientos adicionales. Cuando el usuario abre tu app, puedes solicitar tu token desde Block Store llamando a retrieveBytes(). El token recuperado se puede usar para mantener el usuario conectado en el dispositivo nuevo.

En el siguiente ejemplo, se muestra cómo recuperar varios tokens según claves específicas.

Java

BlockstoreClient client = Blockstore.getClient(this);

// Retrieve data associated with certain keys.
String key1 = "com.example.app.key1";
String key2 = "com.example.app.key2";
String key3 = BlockstoreClient.DEFAULT_BYTES_DATA_KEY; // Used to retrieve data stored without a key

List requestedKeys = Arrays.asList(key1, key2, key3); // Add keys to array
RetrieveBytesRequest retrieveRequest = new RetrieveBytesRequest.Builder()
    .setKeys(requestedKeys)
    .build();

client.retrieveBytes(retrieveRequest)
    .addOnSuccessListener(
        result -> {
          Map blockstoreDataMap = result.getBlockstoreDataMap();
          for (Map.Entry entry : blockstoreDataMap.entrySet()) {
            Log.d(TAG, String.format(
                "Retrieved bytes %s associated with key %s.",
                new String(entry.getValue().getBytes()), entry.getKey()));
          }
        })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to store bytes", e));

Kotlin

val client = Blockstore.getClient(this)

// Retrieve data associated with certain keys.
val key1 = "com.example.app.key1"
val key2 = "com.example.app.key2"
val key3 = BlockstoreClient.DEFAULT_BYTES_DATA_KEY // Used to retrieve data stored without a key

val requestedKeys = Arrays.asList(key1, key2, key3) // Add keys to array

val retrieveRequest = RetrieveBytesRequest.Builder()
  .setKeys(requestedKeys)
  .build()

client.retrieveBytes(retrieveRequest)
  .addOnSuccessListener { result: RetrieveBytesResponse ->
    val blockstoreDataMap =
      result.blockstoreDataMap
    for ((key, value) in blockstoreDataMap) {
      Log.d(ContentValues.TAG, String.format(
        "Retrieved bytes %s associated with key %s.",
        String(value.bytes), key))
    }
  }
  .addOnFailureListener { e: Exception? ->
    Log.e(ContentValues.TAG,
          "Failed to store bytes",
          e)
  }

Recuperando todos los tokens

A continuación, se muestra un ejemplo de cómo recuperar todos los tokens guardados en BlockStore.

Java

BlockstoreClient client = Blockstore.getClient(this)

// Retrieve all data.
RetrieveBytesRequest retrieveRequest = new RetrieveBytesRequest.Builder()
    .setRetrieveAll(true)
    .build();

client.retrieveBytes(retrieveRequest)
    .addOnSuccessListener(
        result -> {
          Map blockstoreDataMap = result.getBlockstoreDataMap();
          for (Map.Entry entry : blockstoreDataMap.entrySet()) {
            Log.d(TAG, String.format(
                "Retrieved bytes %s associated with key %s.",
                new String(entry.getValue().getBytes()), entry.getKey()));
          }
        })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to store bytes", e));

Kotlin

val client = Blockstore.getClient(this)

val retrieveRequest = RetrieveBytesRequest.Builder()
  .setRetrieveAll(true)
  .build()

client.retrieveBytes(retrieveRequest)
  .addOnSuccessListener { result: RetrieveBytesResponse ->
    val blockstoreDataMap =
      result.blockstoreDataMap
    for ((key, value) in blockstoreDataMap) {
      Log.d(ContentValues.TAG, String.format(
        "Retrieved bytes %s associated with key %s.",
        String(value.bytes), key))
    }
  }
  .addOnFailureListener { e: Exception? ->
    Log.e(ContentValues.TAG,
          "Failed to store bytes",
          e)
  }

Baja de bytesBytes.

Se dio de baja retrieveBytes(). Para recuperar bytes, la clave BlockstoreClient.DEFAULT_BYTES_DATA_KEY se puede usar en la instancia de RetrieveBytesRequest para obtener los datos guardados.

A continuación, se muestra un ejemplo de cómo recuperar la clave predeterminada.

Java

BlockStoreClient client = Blockstore.getClient(this);
RetrieveBytesRequest retrieveRequest = new RetrieveBytesRequest.Builder()
    .setKeys(Arrays.asList(BlockstoreClient.DEFAULT_BYTES_DATA_KEY))
    .build();
client.retrieveBytes(retrieveRequest);

Kotlin

val client = Blockstore.getClient(this)

val retrieveRequest = RetrieveBytesRequest.Builder()
  .setKeys(Arrays.asList(BlockstoreClient.DEFAULT_BYTES_DATA_KEY))
  .build()
client.retrieveBytes(retrieveRequest)

Borra tokens

Es posible que se requiera borrar tokens de BlockStore por los siguientes motivos:

• El usuario sale del flujo de usuarios.
• El token se revocó o no es válido.

Al igual que con la recuperación de tokens, puedes especificar qué tokens deben borrarse configurando un arreglo de claves que requieran eliminación.

A continuación, se muestra un ejemplo de cómo borrar ciertas claves.

Java

BlockstoreClient client = Blockstore.getClient(this);

// Delete data associated with certain keys.
String key1 = "com.example.app.key1";
String key2 = "com.example.app.key2";
String key3 = BlockstoreClient.DEFAULT_BYTES_DATA_KEY; // Used to delete data stored without key

List requestedKeys = Arrays.asList(key1, key2, key3) // Add keys to array
DeleteBytesRequest deleteRequest = new DeleteBytesRequest.Builder()
      .setKeys(requestedKeys)
      .build();
client.deleteBytes(deleteRequest)

Kotlin

val client = Blockstore.getClient(this)

// Retrieve data associated with certain keys.
val key1 = "com.example.app.key1"
val key2 = "com.example.app.key2"
val key3 = BlockstoreClient.DEFAULT_BYTES_DATA_KEY // Used to retrieve data stored without a key

val requestedKeys = Arrays.asList(key1, key2, key3) // Add keys to array

val retrieveRequest = DeleteBytesRequest.Builder()
      .setKeys(requestedKeys)
      .build()

client.deleteBytes(retrieveRequest)

Borrar todos los tokens

En el siguiente ejemplo, se borran todos los tokens guardados actualmente en BlockStore:

Java

// Delete all data.
DeleteBytesRequest deleteAllRequest = new DeleteBytesRequest.Builder()
      .setDeleteAll(true)
      .build();
client.deleteBytes(deleteAllRequest)
.addOnSuccessListener(result -> Log.d(TAG, "Any data found and deleted? " + result));

Kotlin

  val deleteAllRequest = DeleteBytesRequest.Builder()
  .setDeleteAll(true)
  .build()
client.deleteBytes(deleteAllRequest)
  .addOnSuccessListener { result: Boolean ->
    Log.d(TAG,
          "Any data found and deleted? $result")
  }

Encriptación de extremo a extremo

Para que la encriptación de extremo a extremo esté disponible, el dispositivo debe ejecutar Android 9 o una versión posterior, y el usuario debe haber configurado un bloqueo de pantalla (PIN, patrón o contraseña) para su dispositivo. Puedes llamar a isEndToEndEncryptionAvailable() para verificar si la encriptación estará disponible en el dispositivo.

En el siguiente ejemplo, se muestra cómo verificar si la encriptación estará disponible durante la copia de seguridad en la nube:

client.isEndToEndEncryptionAvailable()
        .addOnSuccessListener { result ->
          Log.d(TAG, "Will Block Store cloud backup be end-to-end encrypted? $result")
        }

Nota: Se recomienda verificar que la encriptación de extremo a extremo esté disponible antes de habilitar la copia de seguridad en la nube.

Habilitar la copia de seguridad en la nube

Para habilitar la copia de seguridad en la nube, agrega el método setShouldBackupToCloud() a tu objeto StoreBytesData. Se bloqueará la copia de seguridad de forma periódica en la nube para almacenar los bytes almacenados cuando setShouldBackupToCloud() se configure como verdadero.

En el siguiente ejemplo, se muestra cómo habilitar la copia de seguridad en la nube solo cuando esta se encripta de extremo a extremo:

val client = Blockstore.getClient(this)
val storeBytesDataBuilder = StoreBytesData.Builder()
        .setBytes(/* BYTE_ARRAY */)

client.isEndToEndEncryptionAvailable()
        .addOnSuccessListener { isE2EEAvailable ->
          if (isE2EEAvailable) {
            storeBytesDataBuilder.setShouldBackupToCloud(true)
            Log.d(TAG, "E2EE is available, enable backing up bytes to the cloud.")

            client.storeBytes(storeBytesDataBuilder.build())
                .addOnSuccessListener { result ->
                  Log.d(TAG, "stored: ${result.getBytesStored()}")
                }.addOnFailureListener { e ->
                  Log.e(TAG, “Failed to store bytes”, e)
                }
          } else {
            Log.d(TAG, "E2EE is not available, only store bytes for D2D restore.")
          }
        }

Nota: Si se llama a storeBytes con shouldBackupToCloud sin configurar o se establece como false, los bytes de este dispositivo que se crearon antes en la nube se borrarán de la nube en la siguiente sincronización periódica.

Cómo realizar pruebas

Usa los siguientes métodos durante el desarrollo para probar los flujos de restablecimiento.

Desinstalación o reinstalación del mismo dispositivo

Si el usuario habilita los servicios de copia de seguridad (puedes verificarlo en Configuración > Google > Copia de seguridad), los datos de Block Store permanecerán en la desinstalación o reinstalación de la app.

Puedes seguir estos pasos para realizar la prueba:

1. Integra la API de BlockStore a tu app de prueba.
2. Usa la app de prueba para invocar la API de BlockStore a fin de almacenar tus datos.
3. Desinstala tu app de prueba y vuelve a instalarla en el mismo dispositivo.
4. Usa la app de prueba para invocar la API de BlockStore a fin de recuperar tus datos.
5. Verifica que los bytes recuperados sean los mismos que se almacenaron antes de la desinstalación.

Nota: Dado que se requieren más pasos para probar el restablecimiento en varios dispositivos, se recomienda verificar primero la integración de la app con la API de BlockStore. Para ello, usa el caso de desinstalación y reinstalación.

Dispositivo a dispositivo

En la mayoría de los casos, se requerirá el restablecimiento de la configuración de fábrica del dispositivo de destino. Luego, puedes ingresar al flujo de restablecimiento inalámbrico de Android o al restablecimiento del cable de Google (para dispositivos compatibles).

Nota: Si el dispositivo de destino es un Samsung Galaxy, puedes iniciar el flujo de restablecimiento iniciando Smart Switch fuera de la configuración.

Restablecimiento en la nube

1. Integra la API de Blockstore a tu app de prueba. La app de prueba debe enviarse a Play Store.
2. En el dispositivo de origen, usa la app de prueba para invocar la API de Blockstore a fin de almacenar tus datos y configura trueBackUpToCloud como verdadero.
3. Para dispositivos con Android O y versiones superiores, puedes activar una copia de seguridad en la nube de Store Store de forma manual: ve a Settings > Google > Backup y haz clic en el botón "Backup Now".
   1. Para verificar que la copia de seguridad en la nube de Store Store se haya realizado correctamente, puedes hacer lo siguiente:
      1. Cuando finalice la copia de seguridad, busca líneas de registro con la etiqueta “CloudSyncBpTkSvc”.
      2. Deberías ver líneas como esta: “......, CloudSyncBpTkSvc: sync result: SUCCESS, ..., upload size: XXX bytes ...”
   2. Después de una copia de seguridad en la nube de Block Store, hay un período de "refrigeración" de 5 minutos. Después de ese plazo, hacer clic en el botón "Crear copia de seguridad ahora" no activará otra copia de seguridad en la nube de Store Store.
4. Restablece la configuración de fábrica del dispositivo de destino y pasa por un flujo de restablecimiento en la nube. Selecciona para restablecer tu app de prueba durante el flujo de restablecimiento. Para obtener más información sobre los flujos de restablecimiento de la nube, consulta Flujos de restablecimiento de la nube compatibles.
5. En el dispositivo de destino, usa la app de prueba para invocar la API de Blockstore a fin de recuperar tus datos.
6. Verifica que los bytes recuperados sean los mismos que se almacenaron en el dispositivo de origen.

Requisitos del dispositivo

Encriptación de extremo a extremo

• La encriptación de extremo a extremo es compatible con dispositivos que ejecutan Android 9 (API 29) y versiones posteriores.
• Para que se habilite la encriptación de extremo a extremo, el dispositivo debe tener configurado un bloqueo de pantalla con un PIN, un patrón o una contraseña y encriptar los datos del usuario correctamente.

Nota: isEndtoEndEncryptionAvailable() mostrará el valor falso si no se cumple alguna de estas condiciones.

Flujo de restablecimiento de un dispositivo a otro

Para la restauración de un dispositivo a otro, deberás tener un dispositivo de origen y un dispositivo de destino. Estos serán los dos dispositivos que transfieren datos.

Para crear copias de seguridad, los dispositivos fuente deben ejecutar Android 6 (nivel de API 23) y versiones posteriores.

Dispositivos orientados que ejecutan Android 9 (API 29) y versiones posteriores a fin de tener la capacidad de restablecerse.

Obtén más información sobre el flujo de restablecimiento de dispositivos a dispositivos aquí.

Flujo de copia de seguridad y restablecimiento de Cloud

La copia de seguridad y el restablecimiento de Cloud requerirán un dispositivo de origen y un dispositivo de destino.

Para crear copias de seguridad, los dispositivos fuente deben ejecutar Android 6 (nivel de API 23) y versiones posteriores.

Los dispositivos de destino son compatibles según sus proveedores. Los dispositivos Pixel pueden usar esta función a partir de Android 9 (API 29), y el resto de los dispositivos deben ejecutar Android 12 (nivel de API 31) o versiones posteriores.