O que Prevenção de Vazamento de Git faz?
Propósito
Evitar que arquivos sensíveis, segredos e artefatos de build sejam enviados ao GitHub. Escaneie, detecte e corrija automaticamente o .gitignore.
Instruções
Passo 1 — Escaneie por arquivos sensíveis
Execute este comando para encontrar arquivos que NÃO deveriam estar no GitHub:
git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"
No PowerShell:
git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"
Verifique também arquivos sensíveis não rastreados:
git status --porcelain
Passo 2 — Verifique padrões comuns de sensibilidade
Procure por estes padrões nos arquivos rastreados:
| Padrão | Risco | Ação |
|---|---|---|
.env / .env.* | Chaves de API, senhas de BD | Remover do git + adicionar ao .gitignore |
node_modules/ | Dependências (enormes, não necessárias) | Remover + .gitignore |
dist/ / build/ | Saída compilada | Remover + .gitignore |
releases/ | Lançamentos binários | Remover + .gitignore |
*.key / *.pem | Chaves privadas | Remover + .gitignore |
*.p12 / *.pfx | Certificados | Remover + .gitignore |
.DS_Store | Metadados macOS | .gitignore |
Thumbs.db | Metadados Windows | .gitignore |
*.log | Arquivos de log | .gitignore |
.cache/ | Pastas de cache | .gitignore |
coverage/ | Cobertura de testes | .gitignore |
.turbo/ / .next/ | Caches de build | .gitignore |
*.sql | Dumps de banco (às vezes com segredos) | Verificar conteúdo |
Passo 3 — Verifique segredos no código
Pesquise por segredos codificados em arquivos rastreados:
rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\"x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code
Procure por padrões como:
API_KEY=sk-...SECRET=...PASSWORD=...PRIVATE_KEY-----BEGINtoken: "eyJ..."
Passo 4 — Corrija automaticamente o .gitignore
Se arquivos sensíveis forem encontrados, atualize automaticamente o .gitignore:
# Verifique o .gitignore atual
cat .gitignore
Adicione as entradas ausentes. .gitignore padrão para projetos web:
# Arquivos de ambiente
.env
.env.local
.env.production
.env.staging
.env.development
# Dependências
node_modules/
# Saída de build
dist/
build/
release/
releases/
# Segredos
*.key
*.pem
*.p12
*.pfx
# IDE
.vscode/settings.json
.idea/
# SO
.DS_Store
Thumbs.db
# Logs
*.log
npm-debug.log*
# Cache
.cache/
.turbo/
.next/
.nuxt/
# Cobertura
coverage/
# Diversos
*.swp
*.swo
Passo 5 — Remova arquivos sensíveis do rastreamento git (se já estiverem rastreados)
Se arquivos sensíveis já estiverem rastreados:
# Remove do rastreamento, mas mantém localmente
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/
# Depois adicione ao .gitignore
AVISO: Se segredos foram enviados ao GitHub, eles estão comprometidos. O usuário deve:
- Rotacionar todas as chaves/segredos expostos imediatamente
- Nunca usar os mesmos segredos novamente
Passo 6 — Mostre o relatório ao usuário
Apresente os resultados de forma clara:
🔍 Relatório de Escaneamento de Segurança
Arquivos em risco:
❌ .env — rastreado (contém segredos)
❌ node_modules/ — rastreado (deveria ser ignorado)
⚠️ dist/ — rastreado (saída de build)
Ações tomadas:
✅ Adicionado .env ao .gitignore
✅ Adicionado node_modules/ ao .gitignore
✅ Adicionado dist/ ao .gitignore
✅ Removido .env do rastreamento git (mantido localmente)
⚠️ Se .env continha segredos reais, ROTACIONE-os agora.
O histórico do GitHub ainda contém a versão antiga.
Passo 7 — Faça o commit da correção
git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"
O que NÃO fazer
- ❌ Nunca mostre valores reais de segredos no relatório (mascare-os:
sk-****...****) - ❌ Nunca faça commit de .env ou segredos, mesmo por motivos "temporários"
- ❌ Nunca ignore o aviso se segredos já foram enviados
- ❌ Nunca pule a verificação de
git ls-files— arquivos não rastreados são ok, rastreados são o risco
Saída Esperada
Um relatório de segurança limpo mostrando:
- O que foi encontrado em risco
- O que foi corrigido automaticamente
- O que o usuário precisa fazer manualmente (rotacionar chaves)