GuiaSegurança na prática

Como encontrar senhas e chaves de API vazadas no seu repositório GitHub

Um .env commitado ou uma chave de API esquecida no código é suficiente para alguém usar sua conta na nuvem ou acessar seu banco. Veja onde os segredos costumam vazar, como encontrá-los e o que fazer depois.

Por Equipe de Segurança Protez · Atualizado em · 4 min de leitura

Robôs varrem o GitHub o tempo todo atrás de chaves de API recém-publicadas. Uma chave da AWS commitada em um repositório público costuma ser usada por terceiros em poucos minutos, por exemplo para minerar criptomoedas na sua conta. E repositórios privados também vazam: por um colaborador, uma integração de CI ou um token comprometido.

Este guia mostra onde os segredos costumam se esconder no código, como encontrá-los e o que fazer quando aparecer um — além de como automatizar a verificação com a varredura de repositórios GitHub da Protez.

Onde os segredos costumam vazar

Arquivo .env versionadoCommitado antes de entrar no .gitignore, ele leva junto senha do banco, chaves de API e o segredo da aplicação.
Chaves direto no códigoA chave “só para testar” que ficou no arquivo de configuração ou no script de deploy.
Strings de conexãoEndereços como mysql://usuario:senha@host em arquivos de configuração e exemplos.
Chaves privadasArquivos id_rsa, certificados e chaves de assinatura incluídos por engano.

Apagar o arquivo não resolve

Tudo o que foi commitado continua no histórico do Git, em forks e em clones. Se um segredo foi publicado, considere-o comprometido: troque a credencial primeiro e só depois limpe o código.

Verificação manual rápida

Antes de qualquer ferramenta, rode no seu clone local uma busca pelos padrões mais comuns:

git log --all --name-only --pretty=format: | grep -E '(^|/)\.env' | sort -u
git grep -nE 'AKIA[0-9A-Z]{16}|sk_live_|ghp_[A-Za-z0-9]{36}|BEGIN .*PRIVATE KEY' $(git rev-list --all)

O primeiro comando lista todo arquivo .env que já passou pelo histórico; o segundo procura chaves da AWS, do Stripe, tokens do GitHub e chaves privadas em todos os commits. É um bom começo, mas fácil de esquecer — por isso vale automatizar.

Como escanear o repositório na Protez

  1. No painel, clique em Nova varredura e escolha o modo GitHub.
  2. Cole o endereço do repositório, como https://github.com/sua-empresa/api.
  3. Para repositórios privados, crie um fine-grained token (GitHub → Settings → Developer settings) com acesso só a esse repositório e Contents: Read. Com Dependabot alerts: Read, os alertas abertos do GitHub também entram no relatório.
  4. Escolha a branch, se não for a padrão, e mantenha marcada a opção de apagar o token ao final.

O código é baixado apenas para a análise e apagado logo depois. A varredura do GitHub faz parte do scan avançado dos planos pagos.

O que é verificado

  • Segredos: .env versionado, chaves da AWS, do Google, do Stripe, do Mercado Pago, da OpenAI e da Anthropic, tokens do GitHub e do Slack, chaves privadas, strings de conexão com senha e a chave service_role do Supabase. No relatório, o valor encontrado aparece mascarado.
  • Dependências: manifestos como package-lock.json, composer.lock, requirements.txt, go.sum e Gemfile.lock são cruzados com as bases OSV e NVD.
  • Código: análise estática em busca de padrões inseguros, como eval, SQL montado por concatenação e TLS sem verificação.
  • Repositório: branch principal sem proteção e, quando visível para o token, secret scanning e atualizações do Dependabot desativados.

O que fazer quando um segredo aparece

  1. Revogue e gere outra credencial no provedor (AWS, Stripe, banco de dados…). Esse é o passo que realmente encerra o risco.
  2. Verifique o uso indevido: faturas, logs de acesso e atividade recente da conta afetada.
  3. Remova o segredo do código e passe a lê-lo de variáveis de ambiente ou de um cofre de segredos.
  4. Adicione o arquivo ao .gitignore e, se necessário, limpe o histórico com git filter-repo.
  5. Previna a recaída: ative Secret scanning e Push protection no GitHub, que bloqueiam o push quando detectam uma chave.

E se o código não estiver no GitHub?

Em Código-fonte (SAST), no painel, você envia um arquivo .zip do projeto (até 20 MB) para análise estática. Já para apps criados no Lovable, veja o guia específico: como verificar se o código do Lovable está seguro.

Perguntas frequentes

Apaguei o .env do repositório. Estou seguro?

Não totalmente. O arquivo continua no histórico de commits e em clones e forks já feitos. Troque todas as credenciais que estavam nele e só depois limpe o histórico, se necessário.

Repositório privado também precisa de verificação?

Sim. Repositórios privados são acessados por colaboradores, integrações e ferramentas de CI; um token vazado de qualquer um deles expõe o código e os segredos commitados.

Quais permissões o token precisa para a Protez?

Um fine-grained token com acesso apenas ao repositório escolhido e permissão Contents: Read. Se quiser incluir os alertas do Dependabot no relatório, adicione Dependabot alerts: Read.

Faça esta verificação agora

Crie sua conta e rode a primeira varredura em minutos. O scan avançado está nos planos pagos.

Começar grátis
Compartilhar: WhatsApp X LinkedIn Facebook