Vereditos aprimorados em dispositivos Android 13 e mais recentes

Recentemente, anunciamos que reforçamos os vereditos da API Play Integrity para que sejam mais rápidos, mais resistentes a ataques e mais privados para os usuários, além de outras melhorias de segurança.

Resumo das mudanças

Confira um resumo detalhado das mudanças e as perguntas frequentes mais adiante neste documento. As mudanças no veredito em maio de 2025 foram as seguintes:

O quê	O que mudou	Impacto estimado*	Quais dispositivos
Mudanças que afetam todos os desenvolvedores que fazem solicitações de API Play Integrity
Resposta do veredito do dispositivo: meets-device-integrity	É necessário ter um veredito positivo de inicialização verificada com suporte de hardware.	Impacto mínimo, porque a API Play Integrity já usa indicadores seguros com suporte de hardware em dispositivos com Android 13 ou versões mais recentes (~0,4%)	Android 13 e versões mais recentes
Resposta de integridade do app: veredito de reconhecimento do app	Sem alterações	Impacto mínimo, que vai refletir a mudança no veredito do dispositivo (~0,4%)	Android 13 e versões mais recentes
Resposta de detalhes da conta: veredito da licença do Google Play	O app solicitante precisa ser instalado ou atualizado pelo Google Play	Pequena redução nas respostas licenciadas (~2,5%)	Android 6 e versões mais recentes
Mudanças que afetam apenas os desenvolvedores do Play Console e do Play SDK Console que usam recursos opcionais
Resposta do veredito do dispositivo: meets-basic-integrity	É necessário ter o atestado de chave da plataforma Android, mas o estado de inicialização pode ser verificado ou não.	Pequena redução nas respostas básicas (~0,4%)	Android 13 e versões mais recentes
Resposta do veredito do dispositivo: meets-strong-integrity	É necessário ter uma atualização de segurança no último ano	Diminuição nas respostas fortes (~14,5%)	Android 13 e versões mais recentes
Todos os indicadores opcionais (exceto atributos do dispositivo)**	O app solicitante precisa ser instalado ou atualizado pelo Google Play	Diminuição na porcentagem de respostas que incluem indicadores opcionais (~7%)	Android 13 e versões mais recentes

*Todas as porcentagens de impacto estimado mencionadas anteriormente foram baseadas em médias, e apps diferentes podem ter tido mudanças menores ou maiores dependendo da base instalada.

**Os indicadores opcionais (exceto os atributos do dispositivo) são: meets-basic-integrity, meets-strong-integrity, atividade recente do dispositivo, reconhecimento do dispositivo (Beta), status do Play Protect e risco de acesso ao app.

Perguntas frequentes

Visão geral

O que é a API Play Integrity?

A API Play Integrity ajuda a avaliar a confiabilidade do ambiente do app do usuário recebendo informações sobre o dispositivo, o app e o usuário para que você possa detectar e responder a possíveis abusos e ataques.

Quais indicadores a API Play Integrity fornece?

A API Play Integrity inclui a identidade do app solicitante, se ele foi instalado pelo Google Play e se o dispositivo é um dispositivo Android certificado e genuíno. Esses indicadores são fornecidos por padrão. Você pode ler esses indicadores no servidor de back-end do app e decidir se e como o app deve responder. Os desenvolvedores do Google Play podem ativar o recebimento de outros indicadores nas instalações do Google Play para ver ainda mais informações.

O que é o atestado de chave da plataforma Android?

O atestado de chave da plataforma Android permite que os apps verifiquem o estado do dispositivo e recebam um sinal forte de integridade da inicialização protegida por hardware. Ela depende de uma chave provisionada pelo Google no keystore do dispositivo, com suporte de hardware. A API Play Integrity já usa o atestado de chave para receber indicadores de segurança protegidos por hardware em alguns dispositivos e agora vai integrá-los de forma mais profunda em todos os dispositivos com Android 13 ou versões mais recentes.

Mudanças de veredito

Quais mudanças foram feitas nos vereditos da API Play Integrity em dispositivos Android 13 ou versões mais recentes?

A API Play Integrity agora exige indicadores de segurança protegidos por hardware para todos os vereditos de integridade:

• O veredito de reconhecimento de dispositivo meets-device-integrity é uma indicação de que o dispositivo em que o app está sendo executado é um dispositivo Android original e certificado. Esse veredito exige que o carregador de inicialização do dispositivo esteja bloqueado e que o SO Android carregado seja uma imagem certificada do fabricante do dispositivo.
• O veredito de reconhecimento de dispositivo meets-strong-integrity é uma indicação de um dispositivo Android original e certificado com uma atualização de segurança recente. Essa decisão vai exigir atualizações de segurança e do meets-device-integrity no último ano para todas as partições do dispositivo, incluindo um patch de partição do SO Android e um patch de partição do fornecedor. Essa condição pode mudar no futuro.
• O veredito de reconhecimento de dispositivo meets-basic-integrity é uma indicação de que a verificação ocorreu em um dispositivo físico com tecnologia Android. O carregador de inicialização do dispositivo pode estar bloqueado ou desbloqueado, e o estado de inicialização pode ser verificado ou não. Ele pode não ser certificado. Nesse caso, o Google não pode fornecer garantias de segurança, privacidade ou compatibilidade de apps, nem garantir que o dispositivo não esteja agindo como um proxy, como para uma instância virtual do Android. Isso também significa que os dispositivos com acesso root são qualificados para retornar meets-basic-integrity, desde que o atestado de chave esteja presente.

Essas mudanças não afetam a API Play Integrity no Play Games para PC, que vai continuar retornando meets-virtual-integrity.

Por que os vereditos da API Play Integrity foram alterados em dispositivos com Android 13 ou versões mais recentes?

A API Play Integrity usava parcialmente indicadores de segurança com suporte de hardware no Android 12 e versões anteriores. Ao exigir segurança com suporte de hardware no Android 13 e versões mais recentes, os vereditos da API Play Integrity são mais resistentes contra invasores, mais eficientes para apps e mais privados para os usuários. Os desenvolvedores podem esperar as seguintes melhorias em dispositivos com o Android 13 ou versões mais recentes:

• Redução de cerca de 90% nos indicadores do dispositivo que precisam ser coletados e avaliados para gerar o veredito padrão nos servidores do Google. Os indicadores opcionais vão continuar exigindo que outros indicadores sejam coletados.
• Melhoria na latência do veredito em até 80% para solicitações padrão de pior caso e em até 80% para todas as solicitações clássicas para receber o veredito padrão. Os indicadores opcionais podem aumentar a latência.
• Nível consistente de confiabilidade e suporte para todos os formatos do Android com atestado de chave, incluindo dispositivos móveis, tablets, dobráveis, TV, Auto, Wear OS e ChromeOS.
• Uma maior diferenciação entre cada rótulo de dispositivo no veredito de reconhecimento de dispositivo: meets-strong-integrity, meets-device-integrity e meets-basic-integrity.

Observação: após o lançamento dos novos vereditos para todos os desenvolvedores em maio de 2025, esperamos melhorias graduais no desempenho, enquanto removemos ou fazemos a transição das dependências legadas para todos os indicadores padrão e opcionais.

O veredito da API Play Integrity no Play Games para PC não vai mudar e será o mesmo no Android 12 e versões anteriores, assim como no Android 13 e versões mais recentes.

Como posso atualizar a lógica de back-end do meu app para que as decisões de integridade considerem a versão do SDK do Android?

Se você quiser usar uma lógica diferente no servidor de back-end do app com base na versão do SDK do Android, use o novo campo de atributos do dispositivo no veredito. Veja um exemplo de como fazer isso:

Kotlin

val deviceIntegrity =
  JSONObject(payload).getJSONObject("deviceIntegrity")
val sdkVersion =
  if (deviceIntegrity.has("deviceAttributes")) {
    deviceIntegrity.getJSONObject("deviceAttributes").getInt("sdkVersion")
  } else {
    0
  }

if (sdkVersion >= 30) {
  // Provide Android R+ specific experience to the user.
}

Java

JSONObject deviceIntegrity =
  new JSONObject(payload).getJSONObject("deviceIntegrity");
int sdkVersion =
  deviceIntegrity.has("deviceAttributes")
    ? deviceIntegrity.getJSONArray("deviceAttributes").getInt("sdkVersion")
    : 0;

if (sdkVersion >= 30) {
  // Provide Android R+ specific experience to the user.
}

Como posso usar a definição de rótulo meets-strong-integrity antiga em todas as versões do SDK do Android?

Para isso, atualize a lógica de back-end do app para usar meets-strong-integrity quando for um dispositivo anterior ao Android 13 e meets-device-integrity quando for um dispositivo com o Android 13 ou mais recente usando o novo campo de atributos do dispositivo no veredito que contém a versão do SDK do Android. Veja um exemplo de como fazer isso:

Kotlin

val deviceRecognitionVerdict =
  if (deviceIntegrity.has("deviceRecognitionVerdict")) {
    deviceIntegrity.getJSONArray("deviceRecognitionVerdict").toString()
  } else {
    ""
  }

val deviceIntegrityToCheckFor =
  sdkVersion < 33 ? "MEETS_STRONG_INTEGRITY" : "MEETS_DEVICE_INTEGRITY";

if (deviceRecognitionVerdict.contains(deviceIntegrityToCheckFor)) {
  // Looks good!
}

Java

JSONObject deviceIntegrity =
  new JSONObject(payload).getJSONObject("deviceIntegrity");
String deviceRecognitionVerdict =
  deviceIntegrity.has("deviceRecognitionVerdict")
    ? deviceIntegrity.getJSONArray("deviceRecognitionVerdict").toString()
    : "";

String deviceIntegrityToCheckFor =
  sdkVersion < 33 ? "MEETS_STRONG_INTEGRITY" : "MEETS_DEVICE_INTEGRITY";

if (deviceRecognitionVerdict.contains(deviceIntegrityToCheckFor)) {
  // Looks good!
}

Como também é um indicador com suporte de hardware, o campo de atributos do dispositivo é mais confiável em dispositivos com o Android 13 e versões mais recentes.

Quais outras mudanças foram feitas no veredito?

Investimos continuamente para tornar os indicadores atuais da API Play Integrity mais confiáveis e lançamos periodicamente novos recursos para ajudar os desenvolvedores a lidar com ameaças emergentes e novos casos de uso. Outras melhorias que fizemos no veredito incluem:

• Resposta licenciada do Google Play: para retornar uma resposta licenciada do Google Play, a API Play Integrity agora sempre exige que o app solicitante seja instalado ou atualizado pelo Google Play. Isso corrige alguns casos extremos e facilita a interpretação da resposta para os desenvolvedores.
• Disponibilidade de indicadores opcionais: todos os indicadores opcionais disponíveis para desenvolvedores que usam o Google Play Console ou o SDK Console do Google Play (exceto atributos de dispositivo) agora exigem que o app solicitante seja instalado ou atualizado pelo Google Play no Android 13 ou versões mais recentes. Isso inclui meets-strong-integrity, meets-basic-integrity, atividade recente do dispositivo, reconhecimento do dispositivo (Beta), o veredito de risco de acesso ao app e o veredito do Play Protect. Padronizamos todas as outras solicitações de API Play Integrity para receber a verificação do dispositivo (apenas com o marcador meets-device-integrity), do instalador, da integridade do app e dos atributos do dispositivo (se ativados).
• Mudanças de veredito para dispositivos específicos: a API Play Integrity está mudando automaticamente os vereditos de dispositivos em mais cenários para proteger os apps com antecedência em todas as versões do SDK do Android, como quando há evidências de atividade excessiva ou comprometimento de chaves. Isso inclui a capacidade do Google Play de usar outros indicadores para gerar vereditos temporários de dispositivos para os usuários quando os indicadores protegidos por hardware não estão disponíveis. Recomendamos que os desenvolvedores usem as caixas de diálogo de correção do Google Play no app ou direcionem os usuários ao app Google Play Store para corrigir problemas de veredito de integridade. Com o tempo, essas caixas de diálogo vão lidar com mais cenários e incluir orientações específicas para os usuários, informando o que eles precisam corrigir com base no dispositivo ou na conta específica.

Como faço para informar problemas com vereditos de integridade?

Para informar problemas com respostas da API Play Integrity, sejam eles com os vereditos históricos ou os novos, siga as instruções na página de suporte.

Disponibilidade

O que a API Play Integrity precisa para funcionar?

A API Play Integrity exige que a Google Play Store e o Google Play Services estejam instalados em um dispositivo, incluindo dispositivos Android e o Google Play Games para PC. As solicitações clássicas exigem o Android 4.4 (nível 19 da API) ou versões mais recentes, e as solicitações padrão exigem o Android 5.0 (nível 21 da API) ou versões mais recentes. Em dispositivos com o Android 13 (nível 33 da API) e versões mais recentes, a API Play Integrity agora terá o mesmo nível de confiabilidade e suporte em todos os formatos do Android com atestado de chave, incluindo dispositivos móveis, tablets, dobráveis, TVs, carros, Wear OS e ChromeOS.

Por que a API Play Integrity tem vereditos diferentes para dispositivos diferentes?

A API Play Integrity oferece vários vereditos de dispositivo para acomodar desenvolvedores com diferentes casos de uso e tolerâncias de risco, além de possibilitar uma estratégia de aplicação em níveis. Por exemplo, quando o app e o dispositivo são mais confiáveis, um desenvolvedor pode simplificar as etapas de verificação do usuário. Já quando um dispositivo é desconhecido, o desenvolvedor pode exigir uma verificação adicional do usuário antes de realizar ações protegidas ou sensíveis. Essa pode ser uma maneira eficaz de reduzir abusos e ataques.

O que é um dispositivo Android certificado?

Um dispositivo Android certificado (também conhecido como dispositivo Android certificado pelo Play Protect) é um dispositivo que executa um software previsível que passou por centenas de testes de compatibilidade do Google, segue o modelo de segurança e permissões do Android e foi enviado com o pacote de recursos antimalware do Google Play Protect. Quando a API Play Integrity consegue verificar que um dispositivo é um dispositivo Android genuíno e certificado, ela retorna a resposta meets-device-integrity no veredito de reconhecimento do dispositivo.

O que é um dispositivo meets-basic-integrity?

A API Play Integrity também retorna uma resposta opcional no veredito do dispositivo, meets-basic-integrity. Se um dispositivo retornar apenas o veredito meets-basic-integrity sem meets-device-integrity ou meets-strong-integrity, isso significa que o SO Android não pode ser verificado, mas o atestado de chave está presente. Isso indica que a verificação ocorreu em um dispositivo físico com Android, mas o Google não pode garantir a segurança, a privacidade ou a compatibilidade de apps do dispositivo nem que ele não esteja agindo como um proxy, como em uma instância virtual do Android. Dependendo dos casos de uso e das tolerâncias de risco, os desenvolvedores podem decidir como querem que o app seja executado nesses dispositivos.

Qualquer desenvolvedor pode usar a API Play Integrity?

Sim, qualquer desenvolvedor Android pode fazer solicitações à API Play Integrity para receber os vereditos de integridade padrão. O uso é limitado a 10 mil solicitações por dia, seja qual for o canal de distribuição. Os desenvolvedores que publicam apps no Google Play, além de outros canais de distribuição, também podem solicitar um aumento na cota diária.

Qualquer desenvolvedor pode usar o atestado de chave da plataforma Android?

Sim, qualquer desenvolvedor Android pode usar o atestado de chave da plataforma Android para receber um registro de atestado de chave, que pode ser verificado com o certificado público da chave raiz de atestado do Google. A API Play Integrity oferece aos desenvolvedores os benefícios do atestado de chave e recursos adicionais sem toda a complexidade de ter que fazer a integração com o atestado de chave.

Aplicação

Como os desenvolvedores usam os vereditos da API Play Integrity?

Cabe aos desenvolvedores decidir se e como usar os vereditos da API Play Integrity. Alguns desenvolvedores coletam os indicadores para análise interna antiabuso, enquanto outros tomam decisões sobre como o app se comporta com base no veredito. Por exemplo, os desenvolvedores podem decidir exigir que dispositivos menos confiáveis realizem etapas adicionais de verificação do usuário ao criar uma conta ou que dispositivos menos confiáveis joguem juntos no mesmo servidor multijogador.

A API Play Integrity bloqueia usuários ou dispositivos?

Não, a API Play Integrity não bloqueia o acesso a nenhuma funcionalidade. É um serviço opcional para desenvolvedores que fornece indicadores, e os desenvolvedores escolhem como agir com base neles.

O que os usuários precisam fazer se o dispositivo não passar nas verificações da API Play Integrity?

Os usuários podem acessar o app Google Play Store no dispositivo, abrir o menu Configurações, selecionar Sobre e procurar em Certificação do Play Protect. Se houver algo errado com a certificação do Play Protect do dispositivo, vai aparecer um botão que os usuários podem pressionar para tentar corrigir o problema. Isso vai atualizar o status de certificação do dispositivo e fornecer orientações específicas sobre o que precisa ser corrigido.