KappS Base de conhecimento · Perguntas frequentes

Gestão de segredos e proteção de chave de API em apps móveis: por que uma chave de API dentro de um APK é

FAQ Segurança

1. A única pergunta que realmente importa é quais chaves podem estar no binário. A própria orientação de segurança do Google no Android é explícita de que não se trata de ofuscação: "Quando seu app é compilado e o código-fonte do seu app inclui chaves de API, é possível que um invasor descompile o app e encontre esses recursos." Trate cada string no APK, e cada recurso ou ativo empacotado nele, como publicado. Chaves no lado do cliente, portanto, só podem ter baixo privilégio, cota limitada e escopo restrito: mapas, clima, feeds de conteúdo somente leitura, busca pública. Qualquer coisa que possa movimentar dinheiro, ler registros de outro usuário, emitir reembolsos, enviar e-mails ou alterar o estado do servidor nunca vai no cliente — fica por trás do seu próprio endpoint que autentica o usuário. (§https://developer.android.com/privacy-and-security/security-tips)

2. A política de Dados do usuário do Play nunca menciona as palavras "chave de API" — ela regula resultados, e é por isso que uma chave vazada é um problema de política e não apenas de engenharia. A política exige que os desenvolvedores "tratem todos os dados pessoais e sensíveis do usuário com segurança, incluindo a transmissão usando criptografia moderna (por exemplo, via HTTPS)" e "protejam todos os dados do usuário com medidas de segurança adequadas, incluindo criptografia moderna para dados em trânsito". Uma chave embutida no código não é, por si só, uma violação; uma chave embutida que permite a um atacante ler, gravar ou exfiltrar dados do usuário é uma violação da política de Dados do usuário, com risco de remoção somado à conta e à notificação de violação. §https://support.google.com/googleplay/android-developer/answer/10144311

3. Uma chave de API não é autenticação, e a documentação do Google Cloud diz isso sem rodeios: "Uma chave de API padrão não autentica um principal" — ela associa uma requisição a um projeto para fins de cobrança e cota. Restrições de aplicativo (sites, endereços IP, apps Android, apps iOS — um tipo por vez) e restrições de API são limitação de danos, não sigilo, e a restrição de app Android vem com uma ressalva documentada: "Contornar essa restrição é simples. Se você usar essa restrição, também deve adicionar restrições de API e monitorar o uso." A recomendação no mesmo documento é definir tanto restrições de API quanto restrições de aplicativo e depois observar o que a chave realmente chama. §https://cloud.google.com/docs/authentication/api-keys

4. A lista de higiene que realmente importa. Nunca faça commit de chaves no repositório — a orientação do Android aponta para plugins do Gradle como o secrets-gradle-plugin em vez de arquivos versionados. Use chaves separadas para desenvolvimento, teste e produção, e chaves separadas por app, para que uma chave comprometida possa ser desativada sem derrubar a produção. Quando o chamador for um servidor, restrinja por IP. Quando você precisar manter um segredo no dispositivo (tokens, material de refresh), guarde-o no Android Keystore e criptografe-o com uma biblioteca auditada como o Tink, em vez de uma constante de string, um arquivo de asset ou SharedPreferences puro. Sempre HTTPS, e considere o certificate pinning como uma camada extra, não como substituto. §https://developer.android.com/privacy-and-security/security-tips

5. A rotação é um item de calendário, não um reflexo que só acontece em incidentes. A orientação do Android cita a ISO 27001 e afirma que "na maioria dos casos, um período de rotação de chaves entre 90 dias e 6 meses deve ser adequado"; a operação de rotação do Google Cloud cria uma nova chave com as mesmas restrições, e a chave antiga continua funcionando até você excluí-la. Essa janela de sobreposição é justamente o ponto: as instalações em campo se atualizam ao longo de semanas, então você precisa de uma janela de migração com as duas chaves válidas, depois desativar e depois excluir. Mantenha um inventário com ID da chave, responsável, pacote, escopos e data de rotação — um projeto comporta até 300 chaves, o que é corda suficiente para perder o controle. §https://cloud.google.com/docs/authentication/api-keys

6. A detecção decide se um vazamento é um dia comum ou um trimestre inteiro. Ative o registro de uso por chave e os alertas de cota/cobrança, e fique atento às três formas que importam: um pico de volume vindo de um referenciador ou IP inesperado, cota esgotada em horários em que seus usuários estão dormindo e chamadas a endpoints que o app nunca chama. Em uma exposição confirmada, trate como incidente com uma ordem fixa: crie a chave substituta com restrições idênticas, publique a atualização do cliente, acompanhe a queda do tráfego da chave antiga, revogue a chave antiga e então revise os logs de acesso e a fatura durante toda a janela de exposição. Verifique também se a declaração de Segurança dos dados no Play Console ainda corresponde à realidade — "criptografado em trânsito" é uma declaração sobre o comportamento real em tempo de execução, e uma chave vazada que rebaixou um caminho para texto simples torna essa declaração falsa. §https://cloud.google.com/docs/authentication/api-keys