Variables de entorno y secretos en Workers
Configure su Cloudflare Worker con variables de entorno y gestione de forma segura secretos como las claves de API.
Variables de entorno y secretos en Workers es una lección gratuita de Edge Computing with Cloudflare Workers & Deno en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Edge Computing with Cloudflare Workers & Deno, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Edge Computing with Cloudflare Workers & Deno incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Why Configuration Matters
Hardcoding values like API keys into your Worker is insecure and inflexible. Environment variables and secrets keep config out of your code.
Vars vs Secrets
Workers distinguish two kinds:
- Vars: plain text config, visible in dashboard
- Secrets: encrypted, write-only values like keys and tokens
Defining Vars in wrangler
Plain variables go in your wrangler.toml under a [vars] table.
# wrangler.toml
[vars]
API_BASE = 'https://api.example.com'
ENVIRONMENT = 'production'Accessing the env Binding
In the modules format, config arrives as the env argument of your fetch handler.
export default {
async fetch(request, env, ctx) {
return new Response('Base: ' + env.API_BASE);
}
};Adding a Secret
Secrets are never stored in your repo. Add them with the Wrangler CLI, which prompts for the value.
wrangler secret put MY_API_KEYUsing a Secret
Secrets appear on the same env object as vars, so reading them is identical.
const res = await fetch('https://api.example.com/data', {
headers: { Authorization: 'Bearer ' + env.MY_API_KEY }
});Listing & Deleting Secrets
Manage secrets entirely from the CLI. You can list names (never values) and delete ones you no longer need.
wrangler secret list
wrangler secret delete MY_API_KEYPer-Environment Config
Use named environments to give staging and production different values.
# wrangler.toml
[env.staging.vars]
ENVIRONMENT = 'staging'Local Development Secrets
For local wrangler dev, put secrets in a .dev.vars file and add it to .gitignore so they never reach version control.
# .dev.vars
MY_API_KEY=local-test-keySecurity Best Practices
Keep config safe:
- Never commit secrets
- Rotate keys periodically
- Use secrets, not vars, for anything sensitive
Putting It Together
A typical Worker reads a public base URL from vars and an auth token from a secret, then calls an upstream API safely.
export default {
async fetch(req, env) {
const r = await fetch(env.API_BASE + '/me', {
headers: { Authorization: 'Bearer ' + env.MY_API_KEY }
});
return new Response(await r.text());
}
};Quick Check
Test your config knowledge.
Recap
You learned the difference between vars and secrets, how to define and access them via the env binding, manage them with Wrangler, and keep sensitive values secure across environments.
Aprende Edge Computing with Cloudflare Workers & Deno con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 12
- Lecciones
- 47
Preguntas frecuentes
¿La lección «Variables de entorno y secretos en Workers» es gratis?
Sí — el texto completo de «Variables de entorno y secretos en Workers» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Edge Computing with Cloudflare Workers & Deno, actualiza a CoddyKit PRO. El curso de Edge Computing with Cloudflare Workers & Deno incluye 4 lecciones en total.
¿Qué aprenderé en «Variables de entorno y secretos en Workers»?
Configure su Cloudflare Worker con variables de entorno y gestione de forma segura secretos como las claves de API. Practicas Edge Computing with Cloudflare Workers & Deno con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Edge Computing with Cloudflare Workers & Deno?
No se requiere experiencia previa. Edge Computing with Cloudflare Workers & Deno en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Variables de entorno y secretos en Workers»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Edge Computing with Cloudflare Workers & Deno?
Sí. Cada lección de Edge Computing with Cloudflare Workers & Deno incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Configuración del entorno de Workers
- Gestión de solicitudes HTTP
- Implementación de su primer Worker
- Variables de entorno y secretos en Workers