Volver al blog

Subiste una clave a Git: la forma correcta de limpiarla

Serie: Git sin miedo

Has subido un .env con una API key. Lo borras, haces commit y respiras. Error: la clave sigue en el historial, cualquiera con acceso al repo puede verla con git log -p, y si el repo es público ya puede estar en manos de bots que rastrean GitHub buscando claves.

1. Rota el secreto. Ya.

Antes de tocar Git: revoca la clave y genera una nueva en el proveedor (AWS, Stripe, la base de datos…). Da igual lo bien que limpies el historial: si alguien la copió, sigue funcionando hasta que la revoques.

Este paso no es opcional y va primero.

2. Saca el secreto del código

Mueve la clave a una variable de entorno y asegúrate de que el archivo no vuelve a entrar:

echo ".env" >> .gitignore
git rm --cached .env
git commit -m "Deja de versionar .env"

3. Limpia el historial

Para reescribir el historial, la herramienta recomendada hoy es git filter-repo (el propio manual de Git desaconseja git filter-branch). Trabaja sobre un clon nuevo:

git clone --mirror git@github.com:tu-usuario/tu-repo.git
cd tu-repo.git
git filter-repo --invert-paths --path .env

Si la clave aparece dentro de otros archivos, puedes reemplazar el texto en todo el historial:

echo 'sk_live_LACLAVEFILTRADA==>***ELIMINADA***' > reemplazos.txt
git filter-repo --replace-text reemplazos.txt

Después sube el historial reescrito:

git push --force --mirror

4. Avisa al equipo

Reescribir el historial cambia los hashes. Cada persona del equipo debe volver a clonar (o hacer git fetch y git reset --hard sobre la rama limpia). Si alguien hace push desde un clon antiguo, el secreto vuelve.

En GitHub, además, las copias en forks y las pull requests antiguas pueden seguir conteniendo el commit: por eso el paso 1 es el que de verdad te protege.

Para que no vuelva a pasar

  • .env en el .gitignore desde el primer commit.
  • Un escáner de secretos en un hook de pre-commit (por ejemplo, gitleaks) y otro en la CI.