Saltar al contenido
Módulo 5 · Lección 5.6 · 7 min

Lo que nunca debe subirse a GitHub

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.

Actualizado el · Equipo de 360MKT · 7 min de lectura

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í.

Archivo .env
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.

Prompt · Claude o ChatGPT
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

Prompt · Claude o ChatGPT
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:

  1. Cambia la clave en el servicio correspondiente. Genera una nueva y anula la antigua.
  2. Pon la nueva en .env.
  3. Quita el archivo del repositorio y añádelo a .gitignore.
  4. 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
WhatsApp