Variables de entorno
Environment Variables
¿Qué son las variables de entorno?
- 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.
Jaryong KooDoctor en marketing y referente en análisis de datos con IA y en marca personal
John KimAutor de «Diseño de marketing B2B» y CEO de Nanum ConsultoríaEs 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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.