Qué son los secretos, cómo se guardan fuera del código con un archivo .env y qué hacer si uno acaba en el repositorio.
Una clave subida a un repositorio debe considerarse comprometida, aunque el repositorio sea privado y aunque la borres después.
Qué es un secreto
- Claves de API de servicios: pagos, correo, mapas, IA.
- Contraseñas de bases de datos.
- Tokens de acceso.
- Claves privadas SSH.
Cómo se guardan: el archivo .env
Los secretos van en un archivo llamado .env, en la raíz del proyecto, que no se sube. El código los lee de ahí.
DATABASE_URL=postgres://usuario:contraseña@localhost:5432/reservas
STRIPE_SECRET_KEY=sk_test_xxxxxxxxxxxx
EMAIL_API_KEY=xxxxxxxxxxxx
Junto a él se guarda un .env.example con los nombres pero sin valores. Ese sí se sube, y sirve de guía.
Revisa que todos los secretos del proyecto se lean de variables de entorno. Crea un .env.example con los nombres y sin valores, y confirma que .env está en .gitignore.
Comprueba que no se ha subido nada
Busca en todo el historial de Git, no solo en los archivos actuales, cualquier clave, contraseña o token. Enséñame lo que encuentres sin mostrar el valor completo.
Si un secreto se ha subido
Sigue este orden. El primero es el que importa:
- Cambia la clave en el servicio correspondiente. Genera una nueva y anula la antigua.
- Pon la nueva en
.env. - Quita el archivo del repositorio y añádelo a
.gitignore. - Revisa en el servicio si hubo uso que no reconoces.
Borrar el archivo no basta: sigue en el historial. Por eso la clave se cambia siempre.
Otras cosas que no se suben
- Copias de la base de datos con datos reales.
- Documentos con datos personales de clientes.
- La carpeta de dependencias.
- Archivos pesados: vídeos, copias de seguridad.
Comprueba el módulo
¿Prefieres construirlo con ayuda?
Este curso te da el método completo. Si quieres ir más rápido o tu proyecto maneja pagos o datos sensibles, lo revisamos contigo y lo dejamos funcionando.
Consulta gratuita