KappS Base de conocimiento · Preguntas frecuentes

Implementación y migración de la API Google Play Integrity en Google Play

Preguntas frecuentes Cumplimiento técnico

1. La migración no es opcional: SafetyNet está completamente desactivado. Google indica en su cronograma de obsolescencia: «La API de atestación de SafetyNet quedó obsoleta en 2022 y se desactivó por completo en enero de 2025. Los desarrolladores deben migrar a la API de Play Integrity, que consolida varias ofertas de integridad (incluido el veredicto de integridad de la atestación de SafetyNet) en una sola API». Cualquier llamada que sobreviva ahora falla: «Si intentas llamar a la API de atestación de SafetyNet, recibirás un error. La API de atestación devuelve una tarea que siempre invoca el listener onFailure con una ApiException y un código de estado 7 (NETWORK_ERROR)». Si todavía publicas una versión que llama a SafetyNet, indica a tus usuarios que actualicen. (https://developer.android.com/privacy-and-security/safetynet/deprecation-timeline)

2. Qué verifica realmente la API. "La API de Play Integrity te ayuda a comprobar que las acciones de los usuarios y las solicitudes al servidor provienen de tu app genuina, instalada por Google Play y ejecutándose en un dispositivo Android genuino y certificado". Devuelve tres veredictos principales: accountDetails (acceso no autorizado: si el usuario instaló o pagó la app en Google Play), appIntegrity (manipulación del código: si el binario es el no modificado que Google Play reconoce) y deviceIntegrity (dispositivos de riesgo y entornos emulados: un dispositivo Android genuino y certificado o una instancia genuina de Google Play Games para PC). Los veredictos opcionales añaden MEETS_STRONG_INTEGRITY (actualizaciones de seguridad recientes, Android 13 o superior), appAccessRiskVerdict (captura de pantalla, superposiciones y abuso de accesibilidad por otras apps), playProtectVerdict (Play Protect activado y sin apps peligrosas), recentDeviceActivity (volumen de solicitudes anómalamente alto) y deviceRecall (beta). (https://developer.android.com/google/play/integrity/overview)

3. Crea y vincula un proyecto de Google Cloud. "Para integrar la API, debes tener un proyecto de Google Cloud... Después puedes vincular tu proyecto de Google Cloud en la Google Play Console (para apps) o en la Consola del SDK de Google Play (para SDKs). Vincular tu proyecto es obligatorio" para desbloquear las funciones avanzadas y los aumentos de cuota. Puedes habilitar la API de Play Integrity en la Consola de Google Cloud, o vincular primero y se habilita automáticamente. Ojo con la trampa: "Los proyectos que están habilitados en la Consola de Google Cloud pero no vinculados en Play Console o en la Consola del SDK de Play no son elegibles para funciones adicionales". (https://developer.android.com/google/play/integrity/setup)

4. Elige solicitudes estándar o clásicas: difieren en latencia y almacenamiento en caché. Las solicitudes estándar tienen la latencia más baja («unos cientos de milisegundos de media») y una alta fiabilidad de obtener un veredicto utilizable, usan almacenamiento en caché inteligente en el dispositivo y delegan en Google Play la protección frente a ciertos ataques; preparas («calientas») el proveedor de tokens una vez —una instancia «solo puede preparar el token de integridad hasta 5 veces por minuto»— y luego solicitas un token cuando lo necesites. Las solicitudes clásicas, la ruta original, tienen mayor latencia («unos segundos de media»), inician una evaluación nueva que consume más datos y batería del usuario y dejan ciertas mitigaciones en tus manos, por lo que deben hacerse «con poca frecuencia, como algo puntual» para una acción muy sensible o valiosa. Ambas requieren Android 6.0 (nivel de API 23) o superior. Regla explícita: «Si estás pensando en hacer una solicitud clásica y guardarla en caché para usarla más tarde, entonces deberías hacer una solicitud estándar para reducir el riesgo de ataques». (https://developer.android.com/google/play/integrity/overview, https://developer.android.com/google/play/integrity/standard)

5. Verifica en tu servidor, nunca en el cliente. El flujo es: la app prepara el proveedor de tokens con el número de proyecto de Google Cloud; solicita un token de integridad pasando un hash de solicitud; recibe un token firmado y cifrado y lo envía a tu backend; después, "el backend de tu app envía el token a un servidor de Google Play. El servidor de Google Play descifra y verifica el veredicto y devuelve los resultados al backend de tu app". Aplica el veredicto solo en el backend: una comprobación en el cliente se puede parchear. (https://developer.android.com/google/play/integrity/standard)

6. Vincula los tokens a la solicitud específica. Las solicitudes estándar se vinculan a un hash de solicitud que proporcionas al solicitar el token; las solicitudes clásicas usan el campo nonce con vinculación de contenido basada en los datos de la solicitud o en la lógica del servidor. No almacenes en caché ni reutilices veredictos: "Almacenar un veredicto en caché aumenta el riesgo de ataques como la exfiltración y la repetición". Si estabas a punto de guardar en caché un veredicto clásico para usarlo después, cambia a una solicitud estándar. (https://developer.android.com/google/play/integrity/classic)

7. Respeta la cuota. «De forma predeterminada, tu app puede realizar hasta 10.000 solicitudes totales al día entre todas las instalaciones»: puedes solicitar un máximo diario mayor, pero planifica en torno a él y prepara el proveedor de tokens con poca frecuencia (hasta 5 veces por minuto por instancia). (https://developer.android.com/google/play/integrity/overview)

8. Implementa los veredictos sin perjudicar a los usuarios legítimos. La recomendación explícita de Google: "implementa la API sin aplicar políticas" primero, "recopila telemetría y entiende a tu audiencia antes de tomar medidas", luego calcula el impacto de cualquier aplicación de políticas que tengas prevista y ajusta tu estrategia antiaabuso. Trata la API como una señal, no como toda la estrategia: "La Play Integrity API funciona mejor cuando se usa junto con otras señales como parte de tu estrategia antiaabuso general y no como tu único mecanismo antiaabuso". La API está disponible en teléfonos, tablets, plegables, Android Auto, Android TV, Android XR, ChromeOS, Wear OS y Google Play Games en PC. (https://developer.android.com/google/play/integrity/overview)

Límites de versión y cuota (verificados en las páginas de Google el 2026-10-13):

Versiones de la biblioteca. Las versiones actuales (la línea 1.5.x) requieren Android nivel de API 23 (Android 6.0) o superior para las solicitudes estándar y clásicas; la línea 1.4.0 admitía nivel de API 21 (Android 5.0) o superior. Confirma el mínimo de la versión exacta con la que compilas en las notas de la versión de la biblioteca, no en un tutorial.

Tipos de cuota. El límite predeterminado es de 10.000 solicitudes al día vinculado al número de proyecto de Cloud asociado, y Google contabiliza las solicitudes de token (del lado del cliente) y los descifrados de token (del lado del servidor) como acciones de cuota independientes: un volumen alto de solicitudes desde el cliente no consume por sí solo la cuota de descifrado del servidor. Para volúmenes mayores hay que solicitar un aumento de cuota a Google.

Vinculación del proyecto. La API requiere un proyecto de Google Cloud vinculado a tu app en Play Console (o a tu SDK en Play SDK Console). La cuota está ligada a ese número de proyecto, así que las apps que comparten un mismo proyecto de Cloud comparten un mismo límite.