Prevención de Filtraciones en Git
Propósito
Evitar que archivos sensibles, secretos y artefactos de compilación se suban a GitHub. Escanea, detecta y corrige automáticamente el .gitignore.
Instrucciones
Paso 1 — Escanear archivos sensibles
Ejecuta este comando para encontrar archivos que NO deberían estar en GitHub:
git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"
En PowerShell:
git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"
También verifica archivos sensibles no rastreados:
git status --porcelain
Paso 2 — Verificar patrones sensibles comunes
Busca estos patrones en archivos rastreados:
| Patrón | Riesgo | Acción |
|---|---|---|
.env / .env.* | Claves API, contraseñas de BD | Eliminar de git + agregar a .gitignore |
node_modules/ | Dependencias (enormes, no necesarias) | Eliminar + .gitignore |
dist/ / build/ | Salida compilada | Eliminar + .gitignore |
releases/ | Versiones binarias | Eliminar + .gitignore |
*.key / *.pem | Claves privadas | Eliminar + .gitignore |
*.p12 / *.pfx | Certificados | Eliminar + .gitignore |
.DS_Store | Metadatos macOS | .gitignore |
Thumbs.db | Metadatos Windows | .gitignore |
*.log | Archivos de registro | .gitignore |
.cache/ | Carpetas de caché | .gitignore |
coverage/ | Cobertura de pruebas | .gitignore |
.turbo/ / .next/ | Cachés de compilación | .gitignore |
*.sql | Volcados de base de datos (a veces secretos) | Revisar contenido |
Paso 3 — Buscar secretos en código
Busca secretos escritos directamente en archivos 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
Busca patrones como:
API_KEY=sk-...SECRET=...PASSWORD=...PRIVATE_KEY-----BEGINtoken: "eyJ..."
Paso 4 — Corregir .gitignore automáticamente
Si se encuentran archivos sensibles, actualiza el .gitignore automáticamente:
# Revisar .gitignore actual
cat .gitignore
Agregar entradas faltantes. .gitignore estándar para proyectos web:
# Archivos de entorno
.env
.env.local
.env.production
.env.staging
.env.development
# Dependencias
node_modules/
# Salida de compilación
dist/
build/
release/
releases/
# Secretos
*.key
*.pem
*.p12
*.pfx
# IDE
.vscode/settings.json
.idea/
# Sistema operativo
.DS_Store
Thumbs.db
# Registros
*.log
npm-debug.log*
# Caché
.cache/
.turbo/
.next/
.nuxt/
# Cobertura
coverage/
# Miscelánea
*.swp
*.swo
Paso 5 — Eliminar archivos sensibles del control de versiones (si ya estaban rastreados)
Si hay archivos sensibles ya rastreados:
# Eliminar del seguimiento pero mantener localmente
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/
# Luego agregar a .gitignore
ADVERTENCIA: Si los secretos ya se subieron a GitHub, están comprometidos. El usuario debe:
- Rotar todas las claves/secretos expuestos inmediatamente
- Nunca volver a usar los mismos secretos
Paso 6 — Mostrar informe al usuario
Presenta los hallazgos de manera clara:
🔍 Informe de Escaneo de Seguridad
Archivos en riesgo:
❌ .env — rastreado (contiene secretos)
❌ node_modules/ — rastreado (debería ignorarse)
⚠️ dist/ — rastreado (salida de compilación)
Acciones realizadas:
✅ Agregado .env a .gitignore
✅ Agregado node_modules/ a .gitignore
✅ Agregado dist/ a .gitignore
✅ Eliminado .env del seguimiento de git (mantenido localmente)
⚠️ Si .env contenía secretos reales, RÓTALOS ahora.
El historial de GitHub aún tiene la versión antigua.
Paso 7 — Hacer commit de la corrección
git add .gitignore
git commit -m "chore(security): actualizar gitignore para prevenir filtraciones de secretos"
Qué NO hacer
- ❌ Nunca mostrar valores reales de secretos en el informe (enmascararlos:
sk-****...****) - ❌ Nunca hacer commit de .env o secretos, ni siquiera por razones "temporales"
- ❌ Nunca ignorar la advertencia si los secretos ya se subieron
- ❌ Nunca omitir verificar
git ls-files— los archivos no rastreados están bien, los rastreados son el riesgo
Salida esperada
Un informe de seguridad limpio que muestre:
- Qué se encontró en riesgo
- Qué se corrigió automáticamente
- Qué debe hacer el usuario manualmente (rotar claves)