KappS Base de conhecimento · Perguntas frequentes

Google Play Integrity API — boas práticas para verificação de integridade do dispositivo e do app

Perguntas frequentes Segurança e integridade

1. A Play Integrity API (sucessora da SafetyNet Attestation) ajuda a verificar se o seu app está rodando em um dispositivo Android genuíno, com estado de inicialização verificado e sem adulterações; 2. Use os veredictos de integridade padrão: DEVICE_INTEGRITY (o dispositivo passa no perfil CTS), MEETS_DEVICE_INTEGRITY (verificação mais rigorosa com inicialização verificada), MEETS_BASIC_INTEGRITY (integridade básica do sistema) e MEETS_STRONG_INTEGRITY (exige atestação com suporte de hardware); 3. Sempre valide o token de integridade no seu próprio servidor de backend — nunca confie apenas nos veredictos do lado do cliente; 4. Use a Play Integrity API para detectar dispositivos com root, emuladores e ROMs personalizadas em apps com requisitos antifraude ou anticheat; 5. Implemente lógica de fallback: se a API estiver temporariamente indisponível (por exemplo, por problemas de rede), use um modo degradado em vez de bloquear todos os usuários; 6. A API retorna um token JWT — valide a assinatura do token com as chaves públicas do Google, confira se o timestamp de 'requestDetails' está dentro de 5 minutos e valide os campos de 'appIntegrity'; 7. Para apps que exigem alta segurança (finanças, games, corporativo), combine o Play Integrity com o App Check e pontuação de risco no servidor; 8. Teste sua implementação de integridade em vários tipos de dispositivo (Pixel, Samsung, Xiaomi) — alguns fabricantes têm configurações de inicialização verificada diferentes que podem gerar veredictos inesperados.