Configuración

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se explica cómo configurar tu app o juego para que use la API de Play Integrity. Debes habilitar las respuestas de la API y, luego, integrar la API a tu app y al servidor de backend de tu app. Las opciones de configuración, las funciones de prueba y los informes adicionales estarán disponibles una vez que vincules el proyecto de Google Cloud que usas para la API de Play Integrity en Google Play Console.

Cómo habilitar las respuestas de la API de Play Integrity

Cada app o SDK que llame a la API de Play Integrity debe usar un proyecto de Google Cloud para supervisar el uso de la API. Las apps de Google Play pueden vincular un proyecto de Cloud en Google Play Console para habilitar las respuestas de la API de Play Integrity. Si quieres crear un proyecto nuevo de Cloud o tu app se distribuye de forma exclusiva fuera de Google Play, puedes habilitar las respuestas de la API de Play Integrity desde la consola de Google Cloud.

Configuración en Google Play Console (recomendado)

Si habilitas las respuestas de la API de Play Integrity en Google Play Console, obtendrás acceso a opciones de configuración adicionales, informes de API y funciones de prueba. Esta opción solo está disponible para las apps que se distribuyen en Google Play. Navega a Versión > Integridad de la app. En la API de Play Integrity, selecciona la opción para vincular un proyecto de Cloud. Elige el proyecto de Cloud que desees vincular a tu app para habilitar las respuestas de la API de Play Integrity. Ahora puedes integrar la API de Play Integrity en tu app.

Configuración en Google Cloud Console

En la consola de Google Cloud, crea un proyecto de Cloud nuevo o elige uno existente que desees usar con la API de Play Integrity. Navega a APIs y servicios. Selecciona la opción para habilitar APIs y servicios. Busca la API de Play Integrity y, luego, habilítala. Ahora puedes integrar la API de Play Integrity en tu app.

Instrucciones de configuración para proveedores de SDK

Los proveedores de SDKs deben usar su propio proyecto de Google Cloud para llamar a la API de Play Integrity para que el uso de la API se atribuya al SDK y no a apps individuales que usan el SDK. Esto significa que las apps que usan tu SDK no tienen que configurar la API de Play Integrity de forma individual. Tus solicitudes a la API de Play Integrity se tienen en cuenta automáticamente para el uso de la API de tu SDK y no para la app.

Los desarrolladores de SDKs tienen dos opciones para configurar la API de Play Integrity: Google Play SDK Console o la consola de Google Cloud.

Usa Google Play SDK Console (recomendado)

Si habilitas las respuestas de la API de Play Integrity en Google Play SDK Console, obtienes acceso a opciones de configuración adicionales. Navega a Integridad del SDK y haz clic en Configuración. En Configuración del proyecto, selecciona Vincular un proyecto de Cloud. Elige el proyecto de Cloud que desees vincular a tu SDK para habilitar las respuestas de la API de Play Integrity. Ahora puedes integrar la API de Play Integrity en tu SDK. Ten en cuenta que el acceso a Google Play SDK Console está sujeto a criterios de elegibilidad.

Usa la consola de Google Cloud

Puedes habilitar las respuestas de la API de Play Integrity desde la consola de Google Cloud. En la consola de Google Cloud, crea un proyecto de Cloud nuevo o elige uno existente que desees usar con la API de Play Integrity. Navega a APIs y servicios. Selecciona la opción para habilitar APIs y servicios. Busca la API de Play Integrity y, luego, habilítala. Ahora puedes integrar la API de Play Integrity en tu SDK.

Cómo aumentar las solicitudes diarias de tu SDK a la API de Play Integrity

Los proveedores de SDKs que deseen aumentar su cantidad máxima de solicitudes diarias deben completar el formulario de solicitud de cuota. En la sección de comentarios abierta, especifica que realizas una solicitud al SDK y, luego, incluye tus coordenadas de Maven (groupId:artifactId) o una URL a tu SDK.

Cómo aumentar tus solicitudes diarias a la API de Play Integrity

Tu app estará sujeta a un máximo de 10,000 solicitudes totales por día. Puedes solicitar que se aumente este máximo diario si tu app necesita controlar una mayor cantidad de usuarios. Para ello, sigue las instrucciones que se indican a continuación.

Cómo aumentar la cantidad máxima diaria de solicitudes

Para poder recibir un aumento en la cantidad máxima diaria de solicitudes, la app debe estar disponible en Google Play, además de cualquier otro canal de distribución. Incluso con un máximo diario máximo superior, debes seguir limitando las solicitudes clásicas por usuario a acciones poco frecuentes y de alto valor para preservar los datos del usuario y la batería.

Para solicitar un aumento en la cantidad máxima diaria de solicitudes, haz lo siguiente:

1. Vincula el proyecto de Google Cloud que usas para la API de Play Integrity en Play Console.
2. Asegúrate de implementar de forma correcta la lógica de API, incluida la estrategia de reintento recomendada.
3. Solicita un aumento de la cuota con este formulario.

El aumento de la cuota de la API de Play Integrity puede tardar hasta una semana, por lo que te recomendamos que supervises el uso de la API de Play Integrity en Google Play Console o en la consola de Google Cloud, donde también puedes establecer alertas de cuota para evitar interrupciones del servicio.

Los aumentos de cuota se aplican automáticamente a la llamada del cliente para generar tokens de integridad y a la llamada del servidor para desencriptar y verificar los tokens de integridad.

Cómo integrar la API de Play Integrity a tu app

Para integrar la API de Play Integrity a tu app o SDK, según el entorno de desarrollo, realiza una de las siguientes acciones:

Kotlin o Java

La biblioteca de Android más reciente para la API de Play Integrity está disponible en el repositorio de Maven de Google. Agrega la siguiente dependencia al archivo build.gradle de tu app:

implementation 'com.google.android.play:integrity:1.4.0'

Unity

En las siguientes secciones, se describe cómo integrar y configurar la API de Google Play Integrity para proyectos de Unity, lo que abarca las versiones de Unity compatibles, los métodos de instalación y la configuración del entorno.

Versiones de Unity compatibles

• Se admiten todas las versiones de 2019.x, 2020.x y posteriores.
• Si usas Unity 2018.x, se admiten las versiones 2018.4 o posteriores.
• No se admiten Unity 2017.x ni versiones anteriores.

Cómo configurar tu entorno de desarrollo

openupm add com.google.play.integrity

Unreal Engine

En las siguientes secciones, se describe cómo integrar y configurar la API de Google Play Integrity para proyectos de Unreal Engine.

Versiones de Unreal Engine compatibles

El complemento es compatible con Unreal Engine 5.0 y todas las versiones posteriores.

Cómo configurar tu entorno de desarrollo

1. Descarga el complemento de Unreal Engine para Play desde el repositorio de GitHub.

2. Copia la carpeta GooglePlay dentro de la carpeta Plugins de tu proyecto de Unreal Engine.

3. Abre tu proyecto de Unreal Engine y haz clic en Editar → Plugins.

4. Busca Google Play y marca la casilla de verificación Habilitada.

5. Reinicia el proyecto del juego y activa una compilación.

6. Abre el archivo Build.cs de tu proyecto y agrega el módulo PlayIntegrity a PublicDependencyModuleNames:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayIntegrity");
   
       // ...
     }
   }
   

Nativo

Instala el SDK nativo de Play Core 1.13.0 o una versión posterior. Para obtener instrucciones, consulta la guía de configuración del entorno de desarrollo del SDK nativo de Play Core.

Cómo configurar respuestas de la API (opcional)

La respuesta de la API incluye los veredictos predeterminados que se muestran en cada solicitud. Si configuras la integración de la API de Play Integrity en Play Console, podrás personalizar la respuesta de la API.

Respuestas predeterminadas

Los siguientes veredictos de integridad se muestran en la respuesta de la API de Play Integrity de forma predeterminada:

Respuestas condicionales

Si distribuyes tu app en Google Play Juegos para PC, se te habilitará automáticamente para recibir una etiqueta adicional en el veredicto de integridad del dispositivo:

Respuestas opcionales

Si configuras la integración de la API de Play Integrity en Play Console o en Play SDK Console, podrás habilitar la opción para recibir información en la respuesta de la API.

Para realizar cambios en las respuestas de tu API, visita Play Console y navega a Versión > Integridad de la app. En Respuestas, edita y guarda los cambios.

Información opcional del dispositivo

Las apps y los SDKs pueden habilitar etiquetas de dispositivos adicionales en el veredicto de integridad del dispositivo. Si habilitas la opción para recibir etiquetas adicionales, la respuesta de integridad incluirá varias etiquetas para el mismo dispositivo si se cumplen cada uno de los criterios de esas etiquetas. Puedes preparar tu servidor de backend para que se comporte de manera diferente según el rango de respuestas posibles. Por ejemplo, un dispositivo que muestra tres etiquetas (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY y MEETS_BASIC_INTEGRITY) puede ser más confiable que un dispositivo que muestra solo una etiqueta (MEETS_BASIC_INTEGRITY).

También puedes habilitar la actividad reciente del dispositivo. La actividad reciente del dispositivo muestra un nivel que va de LEVEL_1 (baja cantidad de solicitudes) a LEVEL_4 (gran cantidad de solicitudes). Por ejemplo, un dispositivo que muestra un nivel de actividad significativamente más alto que el típico para tu app podría estar intentando generar una gran cantidad de tokens de integridad para su distribución a dispositivos que no son de confianza.

También puedes habilitar los atributos del dispositivo, que te indican la versión del SDK de Android del SO Android que se ejecuta en el dispositivo. En el futuro, es posible que se extienda con otros atributos de dispositivos.

Detalles opcionales del entorno

Las apps pueden aceptar recibir veredictos adicionales sobre el entorno. El riesgo de acceso a la app te permite saber si se están ejecutando otras apps que podrían capturar la pantalla, mostrar superposiciones o controlar el dispositivo. El veredicto de Play Protect te indica si Play Protect está habilitado en el dispositivo y si se encontró software malicioso conocido.

Después de aceptar recibir estos veredictos, la respuesta de la API incluirá el campo de detalles del entorno con el veredicto:

Cómo definir la configuración de solicitud clásica (opcional)

Omite esta sección si solo tienes previsto realizar solicitudes a la API estándar.

Cuando realizas solicitudes clásicas, de forma predeterminada, los servidores de Google Play administran la encriptación de las respuestas que usa tu app cuando interactúas con la API de Play Integrity. Si bien te recomendamos que uses esta opción predeterminada, puedes seguir las instrucciones que se indican a continuación para administrar y descargar tus claves de encriptación de respuestas.

Cómo permitir que Google administre tu encriptación de respuestas (opción predeterminada y recomendada)

Para proteger la seguridad de tu app, te recomendamos que permitas que Google genere y administre tus claves de encriptación de respuesta. Tu servidor de backend llamará al servidor de Google Play para desencriptar las respuestas.

Administra y descarga claves de encriptación de respuestas

Si deseas desencriptar el veredicto de integridad de forma local dentro de tu propio entorno de servidor seguro, puedes administrar y descargar tus claves de encriptación de respuesta. Para administrar y descargar tus claves de encriptación de respuestas, debes usar Play Console, y tu app debe estar disponible en Google Play, además de cualquier otro canal de distribución. Sigue las instrucciones a continuación para cambiar las claves de encriptación de respuestas administradas por Google a las autoadministradas.

Recuerda no desencriptar ni verificar el token que se recibió desde tu app cliente y nunca expongas ninguna clave de desencriptación en ella.

Antes de cambiar la estrategia de administración de encriptación de respuestas en Play Console, asegúrate de que tu servidor esté configurado correctamente para desencriptar y verificar los tokens de integridad en los servidores de Google Play para evitar interrupciones.

Cómo cambiar entre las claves de encriptación de respuestas administradas por Google y las autoadministradas

Si Google administra tu encriptación de respuestas y deseas cambiar para administrar y descargar las claves de encriptación de respuesta por tu cuenta, sigue estos pasos:

1. Accede a Play Console.
2. Selecciona una app que use la API de Play Integrity.
3. En la sección Versión del menú de la izquierda, ve a Integridad de la app.
4. Junto a la API de Play Integrity, haz clic en Configuración.
5. En la sección Solicitudes clásicas de la página, junto a Encriptación de respuestas, haz clic en Editar.
6. En la ventana que aparece, haz clic en Administrar y descargar mis claves de encriptación de respuestas.
7. Sigue las instrucciones para subir una clave pública.
8. Cuando en la ventana se muestre que la carga se realizó de forma correcta, haz clic en Guardar de modo que las claves encriptadas se descarguen automáticamente.
9. Cambia la lógica del servidor para desencriptar y verificar los tokens de integridad de forma local en tu propio entorno de servidor seguro mediante tus claves de encriptación de respuesta.
10. Cuando administras tus claves de encriptación de respuesta, la app puede recurrir al servidor de Google Play para desencriptar y verificar la respuesta (opcional).

Si administras tus claves de encriptación de respuesta y ahora deseas que Google lo haga, sigue estos pasos:

1. Cambia la lógica del servidor de modo que solo desencriptes y verifiques en los servidores de Google.
2. Accede a Play Console.
3. Selecciona una app que use la API de Play Integrity.
4. En la sección Versión del menú de la izquierda, ve a Integridad de la app.
5. Junto a la API de Play Integrity, haz clic en Configuración.
6. En la sección Solicitudes clásicas de la página, junto a Encriptación de respuestas, haz clic en Editar.
7. En la ventana que aparece, haz clic en Permitir que Google administre mi encriptación de respuestas (opción recomendada).
8. Haz clic en Guardar cambios.