Conocimiento · TI · Datos · DX

Variables de entorno

Environment Variables

📂IT · datos · DX⏱Lectura de 2 min📊Práctico🔗Relacionados 4

¿Qué son las variables de entorno?

Definición en una línea
Valor de configuración que se guarda fuera del código (sobre todo claves de API y contraseñas). Como no se escribe directamente en el código, es más seguro, y su valor puede cambiar según el entorno.
Este tema, en capacitación interna📚 Curso relacionado💬 Consulta de capacitación
⚡ Resumen en 3 líneas
  • Valores de configuración guardados fuera del código
  • Cómo proteger las claves de API y las contraseñas
  • Cambiar los valores según el entorno

Cuando empiezas a usar variables de entorno, cambia la naturaleza del propio código. El código sin claves es un activo que puede mostrarse fuera sin problema, y aunque subas el mismo código a los servidores de desarrollo, staging y producción, cada uno lee los valores de su propio entorno y funciona. Como ya no hay que abrir archivos para cambiar a mano la dirección del servidor o las contraseñas en cada despliegue, también se reducen los accidentes en los que la configuración de prueba se sube tal cual al servidor de producción.

Los valores que se guardan en variables de entorno son de dos tipos. Uno son los secretos, como las claves de API, las contraseñas de la base de datos o los tokens, que, si se filtran, ponen en riesgo dinero y datos de clientes. El otro son los valores de configuración que cambian según el entorno, como direcciones de servidor, niveles de registro o activación de funciones. Los primeros requieren un nivel de protección más alto. Cuando trabaja una sola persona basta con un archivo .env, pero al sumarse un equipo suele pasarse a GitHub Actions Secrets o a la pantalla de variables de entorno de la plataforma de despliegue, y si se manejan datos de clientes, a una bóveda dedicada como AWS Secrets Manager y la rotación de claves una vez por trimestre.

Hay un límite importante que conviene tener presente. .env no es cifrado. Es simplemente un archivo de texto con nombres y valores, así que cualquier persona con acceso a ese servidor o a esa laptop puede abrirlo. Por eso, en la práctica, la separación de archivos se gestiona con el mismo peso que quién puede entrar en ese servidor, y para cada clave se configura un límite mensual de uso y alertas de llamadas, de modo que, aunque se filtre, el daño quede acotado a ese límite.

En la práctica, el error más frecuente es creer que «con crear el archivo .env ya estamos seguros». Aunque se agregue .gitignore después, una clave que ya se subió queda en el historial de commits, así que, aunque el repositorio sea privado, revisando el historial aparece. También suele pasarse por alto que las variables de frontend (como las de tipo NEXT_PUBLIC_) solo se llaman variables de entorno por el nombre: todos los usuarios las ven en el navegador. Y al pegar el registro de errores completo en un chat de IA, la clave viaja junto. Una clave filtrada no se soluciona borrándola: la única salida es revocarla y emitir una nueva.

Capacitaciones en las que aparece este término · IA·DX
Cursos recomendados · Instructores recomendados · Mini cotización
🧮 Mini cotización · Criterio de honorarios
Aprox. KRW 1,200,000 (≈ US$900)Charla especial de 2 horas · hasta 20 personas · en coreano
Solicitar cotización formal con estas condiciones →
💡 Dicho de forma sencilla
Guardar las contraseñas aparte, en una bóveda: al no escribirlas directamente en el código, se evita que se filtren.
Por qué es importante en la práctica
Si las claves de API o las contraseñas se dejan escritas directamente en el código, se producen filtraciones. Las variables de entorno son el primer hábito de seguridad para evitarlo.
Origen y fuentes

Es un método antiguo con el que el sistema operativo transmite la configuración a los programas, y se ha consolidado como principio práctico para separar el código de la configuración y de los secretos.

Entender con un caso

Veamos un caso hipotético. En la empresa A, un distribuidor de cosméticos con 140 colaboradores, el equipo de marketing, que no tenía desarrolladores, creó en dos semanas un chatbot de consultas de productos, preguntándole a la IA paso a paso. Para que el equipo lo probara entre sí, subieron el código a un repositorio público de GitHub. Diez días después, la factura de uso de la API de IA llegó a KRW 4,700,000 (≈ US$3,520), cuando normalmente era de KRW 180,000 (≈ US$135) al mes.

  1. El asistente de gerencia Park, del equipo de marketing, vio la notificación de pago e informó: «Creo que menos de 300 personas han probado nuestro chatbot». El equipo de TI confirmó en los registros más de 40,000 llamadas desde IP del extranjero.
  2. El jefe de TI Kim tardó 30 minutos en revocar la clave anterior y emitir una nueva, pero tuvo que crear el repositorio desde cero para borrar también la clave que había quedado en el historial de commits.
  3. Después, el equipo pasó las claves a un archivo .env y lo registró en .gitignore. En el repositorio dejó un .env.example con solo los nombres de las variables, para que un nuevo integrante pudiera terminar la configuración en 15 minutos.
  4. El subgerente Kim separó las claves de desarrollo de las de producción, fijó un límite de KRW 300,000 (≈ US$225) al mes por cuenta con alertas de uso, y configuró que al superar el límite, las llamadas se detuvieran automáticamente.
  5. Tras impartir una capacitación interna de 40 minutos a 26 colaboradores no técnicos, durante seis meses no hubo ninguna filtración de claves, y la tarifa de API bajó de KRW 4,700,000 (≈ US$3,520) a KRW 210,000 (≈ US$155) al mes.
Términos relacionados
Capacitaciones relacionadas con este término
📚Transformación digitalCapacitación corporativa de Nanum Consultoría · presencial/en líneaVer curso →
¿Necesita capacitación interna sobre este tema?
Reciba de inmediato un currículo y una cotización personalizados para su equipo.
Consultar sobre capacitación
Última modificación 2026-09-13 · Revisado por John Kim

Preguntas frecuentes

Porque si se comparte o se publica el código, las claves de API y las contraseñas que contiene quedan expuestas y pueden usarse de forma indebida.
Sí. Al hacer «vibe coding», la regla de «no poner las claves de API en el código, sino en variables de entorno» es una norma de seguridad que no se puede saltar.
Porque si el código se comparte o se filtra, las claves y contraseñas se filtran con él. Separarlas mediante variables de entorno es lo seguro.
Aunque no vaya a manejarlas directamente, debe conocer el principio de «no pegar claves de API en el código ni en el chat».