KappS Base de conhecimento · Perguntas frequentes

Implementação e migração da Google Play Integrity API no Google Play

Perguntas frequentes Conformidade técnica

1. A migração não é opcional — o SafetyNet está totalmente desligado. O Google afirma em sua linha do tempo de descontinuação: "A API SafetyNet Attestation foi descontinuada em 2022 e totalmente encerrada em janeiro de 2025. Os desenvolvedores devem migrar para a API Play Integrity, que consolida várias ofertas de integridade (incluindo o veredito de integridade do SafetyNet Attestation) em uma única API." Qualquer chamada remanescente agora falha: "Se você tentar chamar a API SafetyNet Attestation, receberá um erro. A API attest retorna uma tarefa que sempre invoca o listener onFailure com uma ApiException e um código de status 7 (NETWORK_ERROR)." Se você ainda distribui uma versão que chama o SafetyNet, oriente seus usuários a atualizar. (https://developer.android.com/privacy-and-security/safetynet/deprecation-timeline)

2. O que a API realmente verifica. "A API Play Integrity ajuda você a verificar se as ações do usuário e as solicitações ao servidor vêm do seu app genuíno, instalado pela Google Play, rodando em um dispositivo Android genuíno e certificado." Ela retorna três veredictos principais: accountDetails (acesso não autorizado — se o usuário instalou ou pagou pelo app na Google Play), appIntegrity (adulteração de código — se o binário é o não modificado que a Google Play reconhece) e deviceIntegrity (dispositivos de risco e ambientes emulados — um dispositivo Android genuíno e certificado ou uma instância genuína do Google Play Games para PC). Veredictos opcionais acrescentam MEETS_STRONG_INTEGRITY (atualizações de segurança recentes, Android 13+), appAccessRiskVerdict (captura de tela, sobreposições e abuso de acessibilidade por outros apps), playProtectVerdict (Play Protect ativado e sem apps perigosos), recentDeviceActivity (volume de solicitações anormalmente alto) e deviceRecall (beta). (https://developer.android.com/google/play/integrity/overview)

3. Crie e vincule um projeto do Google Cloud. "Para integrar a API, você precisa ter um projeto do Google Cloud... Você pode então vincular seu projeto do Google Cloud no Google Play Console (para apps) ou no Google Play SDK Console (para SDKs). Vincular seu projeto é obrigatório" para desbloquear os recursos avançados e os aumentos de cota. Você pode ativar a Play Integrity API no Google Cloud Console, ou vincular primeiro e ela é ativada automaticamente. Atenção à armadilha: "Projetos ativados no Google Cloud Console mas não vinculados no Play Console ou no Play SDK Console não são elegíveis a recursos adicionais." (https://developer.android.com/google/play/integrity/setup)

4. Escolha entre solicitações padrão ou clássicas - elas diferem em latência e cache. As solicitações padrão têm a menor latência ("algumas centenas de milissegundos em média") e alta confiabilidade de obter um veredito utilizável, usam cache inteligente no dispositivo e delegam ao Google Play a proteção contra certos ataques; você prepara ("aquece") o provedor de tokens uma vez - uma instância "só consegue preparar o token de integridade até 5 vezes por minuto" - e depois solicita um token sob demanda. As solicitações clássicas, o caminho original, têm maior latência ("alguns segundos em média"), iniciam uma avaliação nova que usa mais dados e bateria do usuário e deixam certas mitigações por sua conta, então devem ser feitas "com pouca frequência, como algo pontual" para uma ação altamente sensível ou valiosa. Ambas exigem Android 6.0 (nível de API 23) ou superior. Regra explícita: "Se você está pensando em fazer uma solicitação clássica e armazená-la em cache para usar depois, então deve fazer uma solicitação padrão para reduzir o risco de ataques." (https://developer.android.com/google/play/integrity/overview, https://developer.android.com/google/play/integrity/standard)

5. Verifique no seu servidor, nunca no cliente. O fluxo é: o app prepara o provedor de tokens com o número do seu projeto Google Cloud; ele solicita um token de integridade, passando um hash de solicitação; ele recebe um token assinado e criptografado e o envia ao seu backend; então "o backend do seu app envia o token para um servidor Google Play. O servidor Google Play descriptografa e verifica o veredito, retornando os resultados ao backend do seu app." Aplique o veredito somente no backend — uma verificação no lado do cliente pode ser removida por patch. (https://developer.android.com/google/play/integrity/standard)

6. Vincule os tokens à solicitação específica. As solicitações padrão são vinculadas a um hash de solicitação que você fornece ao solicitar o token; as solicitações clássicas usam o campo nonce com vinculação de conteúdo baseada nos dados da solicitação ou em lógica do lado do servidor. Não armazene em cache nem reutilize veredictos: "Armazenar um veredicto em cache aumenta o risco de ataques como exfiltração e replay." Se você estava prestes a armazenar em cache um veredicto clássico para usar depois, mude para uma solicitação padrão. (https://developer.android.com/google/play/integrity/classic)

7. Respeite a cota. "Por padrão, seu app pode fazer até 10.000 solicitações totais por dia em todas as instalações" - você pode solicitar um máximo diário maior, mas dimensione em torno disso e prepare o provedor de tokens com pouca frequência (até 5 vezes por minuto por instância). (https://developer.android.com/google/play/integrity/overview)

8. Aplique os vereditos sem prejudicar usuários legítimos. Recomendação explícita do Google: "implemente a API sem aplicar restrições" primeiro, "colete telemetria e entenda seu público antes de tomar qualquer medida", depois estime o impacto de qualquer aplicação de políticas que você planeja e ajuste sua estratégia antiaabuso. Trate a API como um sinal, não como a estratégia inteira: "A Play Integrity API funciona melhor quando usada junto com outros sinais, como parte da sua estratégia antiaabuso geral, e não como seu único mecanismo antiaabuso". A API está disponível em celulares, tablets, dobráveis, Android Auto, Android TV, Android XR, ChromeOS, Wear OS e Google Play Games no PC. (https://developer.android.com/google/play/integrity/overview)

Limites de versão e cota (verificados nas páginas da Google em 13/10/2026):

Versões da biblioteca. As versões atuais (a linha 1.5.x) exigem Android nível de API 23 (Android 6.0) ou superior para solicitações padrão e clássicas; a linha 1.4.0 suportava nível de API 21 (Android 5.0) ou superior. Confirme o mínimo para a versão exata que você distribui nas notas da versão da biblioteca, não em um tutorial.

Tipos de cota. O limite padrão é de 10.000 solicitações por dia vinculado ao número do projeto do Cloud associado, e o Google contabiliza solicitações de token (no lado do cliente) e descriptografias de token (no lado do servidor) como ações de cota separadas — solicitações pesadas no lado do cliente não consomem, por si só, a cota de descriptografia do lado do servidor. Volumes maiores exigem um aumento de cota solicitado ao Google.

Vínculo com projeto. A API exige um projeto do Google Cloud vinculado ao seu app no Play Console (ou ao seu SDK no Play SDK Console). A cota está atrelada a esse número de projeto, então apps que compartilham um mesmo projeto do Cloud compartilham um mesmo limite.