KappS Base de conhecimento · Perguntas frequentes

Ofuscação de código e proteção contra engenharia reversa no Google Play

FAQ Segurança

1. O que o Google realmente exige. A orientação do Google não é "ofuscar para esconder segredos" — é "minificar e ofuscar para encarecer a engenharia reversa, e manter as verificações de segurança reais no seu servidor". A documentação de build do Android (https://developer.android.com/build/shrink-code) descreve o R8 como o redutor de código padrão no plugin Gradle do Android: ele faz tree shaking, redução de recursos, otimização e renomeação de identificadores (ofuscação) em uma única passagem, e o Google é explícito ao afirmar que "a ofuscação não é, por si só, um recurso de segurança" — ela encarece a engenharia reversa casual, mas não torna um cliente confiável. O guia de segurança para desenvolvedores (https://developer.android.com/privacy-and-security/security-best-practices) diz o mesmo por outro ângulo: nunca inclua segredos, chaves de API ou lógica de servidor no APK, porque tudo o que está no dispositivo pode ser lido.

2. Ative o R8 para builds de release. No build.gradle(.kts) do módulo do seu app, o tipo de build release deve definir minifyEnabled true (este é o R8, compatível com ProGuard) e shrinkResources true, e referenciar proguard-rules.pro. A redução de recursos remove recursos não utilizados e só funciona quando minifyEnabled também está ativado. O R8 usa o arquivo de regras padrão otimizado (proguard-android-optimize.txt), então, além da redução, ele também aplica otimizações como inlining de métodos, fusão de classes e remoção de argumentos não utilizados. Verifique o efeito comparando o tamanho do artefato de debug com o de release e lendo build/outputs/mapping/release/mapping.txt.

3. As regras keep são a origem da maioria das falhas em versões de lançamento. O R8 renomeia e exclui tudo o que considera inalcançável — inclusive tipos que ele não consegue ver que são usados por reflexão. Os suspeitos de sempre são parsers JSON (classes de dados Gson/Moshi/Jackson), interfaces Retrofit e seus modelos com @SerializedName, entidades Room, kotlinx.serialization, ViewBinding/DataBinding, Parcelable, views personalizadas infladas por XML e qualquer coisa carregada pelo nome da classe (Class.forName, JNI, service loaders). Os sintomas em produção são NoSuchMethodException, ClassNotFoundException, campos JSON vazios ou renomeados, ou uma falha que só acontece na versão de lançamento e nunca no debug. Adicione regras -keep específicas (por exemplo, -keep class com.example.model.** { *; } para DTOs, -keepclassmembers para campos @SerializedName) em vez de -keep para tudo, e sempre teste a compilação de lançamento, não apenas a de debug. Kotlin muitas vezes exige -keepclassmembers class **$WhenMappings além de regras de metadados; o AndroidX traz suas próprias regras de consumidor que o R8 mescla automaticamente.

4. Envie o mapping.txt para que os relatórios de falhas continuem legíveis. O R8 gera build/app/outputs/mapping/release/mapping.txt (além de configuration.txt e seeds.txt). Envie esse arquivo junto com a versão ao Play Console, ou faça seu pipeline de lançamento enviá-lo, para que o Play Console desofusque os stack traces e os ANRs para você. Sem isso, toda falha em produção aparece como a.a.a.b(Unknown Source) e você perde a capacidade de fazer a triagem. Guarde o mapping de cada versão publicada - uma versão recompilada precisa de um novo arquivo de mapping.

5. Nunca coloque a decisão de segurança no lado do cliente. Este é o erro de projeto mais comum: enviar uma flag isPremium / LicenseValid / IsTampered que o app avalia localmente. Tudo o que o cliente decide, o cliente pode burlar — uma alteração de um byte com apktool ou um hook do Frida inverte a flag. Leve a decisão para o seu backend: o app deve enviar evidências (um token, um token de compra, um veredito de integridade) e o servidor deve decidir. Na prática, valide as compras do Google Play Billing no lado do servidor com a Play Developer API (purchases.subscriptionsv2 / purchases.products) em vez de confiar na confirmação feita no dispositivo, e trate qualquer "verificação de licença" que nunca sai do dispositivo como decoração, não como proteção.

6. A Play Integrity API é a forma suportada de obter esse veredito do lado do servidor. A Play Integrity API (https://developer.android.com/google/play/integrity) substitui a API SafetyNet Attestation, que foi descontinuada. Seu app a chama e recebe um veredito de integridade criptografado, assinado e de curta duração, que precisa ser descriptografado e verificado pelos servidores do Google (ou pelo seu backend chamando a Play Integrity API) — não no dispositivo. O veredito traz sinais de integridade do dispositivo (MEETS_BASIC_INTEGRITY / MEETS_DEVICE_INTEGRITY / MEETS_STRONG_INTEGRITY), um sinal de integridade do app (o binário corresponde ao que você enviou, o que detecta APKs reempacotados ou modificados) e sinais de conta/licenciamento (PLAY_RECOGNITION / LICENSED). Use requisições Standard (recomendado) em vez das Classic, que são o fluxo legado. Você configura a API para o seu app no Play Console em Integridade do app e pode acompanhar as taxas de falha do veredito por lá. Um veredito com falha é um sinal, não uma prova — o Google alerta contra deixar um único dispositivo com falha decidir, então procure padrões e anomalias de taxa e não bloqueie usuários honestos. A cota diária de requisições cresce com a base de instalações (10.000/dia por padrão), e limites maiores são solicitados pelo formulário vinculado em https://support.google.com/googleplay/android-developer/answer/11395166.

7. Assinatura, detecção de adulteração e a proteção em um clique do Play. Duas camadas. (a) Assinatura do app: apps modernos usam o APK Signature Scheme v2/v3 (v4 para instalação rápida). Com o Play App Signing, o Google guarda a chave de assinatura do app enquanto você mantém a chave de upload, então um keystore roubado não significa mais um app sequestrado, e a chave de upload pode ser rotacionada. Você pode comparar o certificado do app em tempo de execução com o esperado, mas lembre-se de que essa verificação também pode ser contornada — use-a como um sinal do lado do servidor. (b) A proteção automática do Google Play ('Protected with Play', https://support.google.com/googleplay/android-developer/answer/13857328) é um interruptor de um clique no Play Console que adiciona detecção de antiadulteração e antipirataria em tempo de execução ao app e informa quando um binário instalado não corresponde à versão da loja; não exige integração de backend da sua parte. Combine-a com o veredito de integridade do app do Play Integrity em vez de confiar em apenas um dos dois.

8. Reforce o cliente, mas assuma que ele será lido. Além da ofuscação: mantenha debuggable como false e remova android:debuggable; remova logs na versão de produção (o R8 pode remover Log.d via -assumenosideeffects, ou aumente o nível de log); não codifique chaves de API, tokens ou endpoints diretamente no código — busque e rotacione-os em tempo de execução; armazene chaves no dispositivo no Keystore do Android (https://developer.android.com/privacy-and-security/keystore) em vez de embuti-las; adicione pinning de certificado/chave pública para que um servidor falso ou um proxy MITM não consiga controlar seu app; trate a detecção de root/emulador/debugger apenas como sinal fraco (facilmente contornável, mas eleva o custo e barra o script médio); ofusque ou criptografe constantes de string de alto valor (endpoints, feature flags) com ofuscação de strings do R8 ou uma ferramenta comercial de hardening quando o ativo justificar; e mova lógica sensível para NDK/código nativo apenas se você aceitar a complexidade de build — o nativo é mais difícil, não impossível, de reverter.

9. A dimensão de política: clones, reempacotamento e os limites da ofuscação. Ofuscar o seu próprio app é legítimo e recomendado; usar a ofuscação para esconder comportamentos que violam políticas da revisão do Google não é. A Política do Programa de Desenvolvedores do Google (https://support.google.com/googleplay/android-developer/answer/17190352) e suas políticas de Malware (https://support.google.com/googleplay/android-developer/answer/9888380), Software Móvel Indesejado (https://support.google.com/googleplay/android-developer/answer/9970222) e Comportamento Enganoso (https://support.google.com/googleplay/android-developer/answer/16680223) proíbem apps enganosos, que ocultam coleta de dados ou funcionalidades, ou que fazem uso indevido de dados do dispositivo, da rede ou pessoais; um app que só funciona porque seu comportamento está oculto é reprovado na revisão e, se descoberto após o lançamento, é removido. Por outro lado, proteção fraca no cliente é exatamente o que permite que outros reempacotem seu app, removam seu sistema de cobrança ou o clonem — as mesmas páginas de política são o que você cita ao registrar uma denúncia de PI ou de malware contra uma cópia, e as regras de personificação/cópia do Play cobrem imitações que copiam sua identidade. Denuncie clones infratores ou maliciosos pelo formulário de reclamação de PI do Play Console e pelos canais de denúncia de políticas.

10. Autoauditoria de descompilação antes do lançamento (faça uma vez por versão). (1) Gere o AAB/APK de release. (2) Aponte o apktool/JADX para o artefato de release - não o de debug - e leia a saída descompilada: confirme que nenhum nome legível de classe/método expõe a lógica de negócio e que nenhum segredo em texto puro permanece. (3) Faça grep no APK pelos seus API keys, endpoints, 'Bearer ', 'password', 'secret', 'http://' e flags de debug (por exemplo strings assets/* | grep -i key). (4) Rode o Frida em um dispositivo de teste com root e tente os ataques de dois minutos - altere sua flag de licença/premium, faça hook na chamada de integridade, leia o armazenamento local; tudo o que funcionar precisa ir para o servidor. (5) Confirme que o mapping.txt foi gerado e enviado para esta versão. (6) Confirme que o Play Integrity e/ou o Protected with Play estão ativados e que seu backend realmente rejeita um veredito de falha. Se a ofuscação é seu único controle, trate os dados e a lógica premium do app como públicos.