Clase 02 · Módulo 13
Secretos y variables de entorno
Secretos y variables de entorno
Qué logras en esta clase
Sabes dónde vive cada clave de tu proyecto y cómo reaccionar si una queda expuesta.
- Clasificas cada valor como público, secreto de servidor o secreto de build.
- Guardas cada uno en el lugar que le corresponde.
- Aplicas el procedimiento correcto ante una filtración.
02
Qué es un secreto
Un secreto es un valor que, en manos ajenas, permite actuar como tú: gastar tu saldo, leer tu base o firmar tu app.
03
Tres clases de valores
| Clase | Ejemplos | Dónde vive |
|---|---|---|
| Público | Dirección del proyecto, clave publicable de Supabase | En la app |
| Secreto de servidor | Clave secreta de Supabase, clave de la API de Claude, token de pagos | Secretos de las Edge Functions |
| Secreto de build | Llaves de firma, cuenta de servicio de Google | EAS |
Clasificar antes de guardar evita casi todos los accidentes.
04
Qué queda dentro del binario
El binario es el archivo de la app que se instala. Dentro van:
- Todo tu código JavaScript.
- Cada variable con prefijo
EXPO_PUBLIC_. - La configuración de la app y los archivos de
assets.
Expo lo dice sin rodeos: lo que va en el código del cliente debe considerarse público y legible para cualquiera que pueda ejecutar la app.
05
La regla que no tiene excepciones
Si un valor llega al teléfono, dejó de ser secreto. No importa cómo lo escondas.
06
Cómo funciona el prefijo EXPO_PUBLIC_
Al empaquetar, Expo reemplaza cada process.env.EXPO_PUBLIC_... de tu código por su valor.
EXPO_PUBLIC_SUPABASE_URL=https://tu-proyecto.supabase.co
EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY=valor-publicableEstas dos son seguras de exponer porque RLS está activado (módulo 8). El prefijo es una declaración tuya: «acepto que esto sea visible».
07
Los archivos .env en tu computador
En desarrollo, las variables se cargan desde archivos .env o .env.local en la raíz del proyecto. En SDK 58, npx expo start carga además .env.development.
Estos archivos no se suben a GitHub: deben estar listados en .gitignore. Compruébalo con:
git check-ignore -v .envSi el comando no imprime nada, el archivo no está siendo ignorado.
08
Tres lugares, tres propósitos
La fila de arriba termina dentro de la app. La de abajo nunca sale del servidor. Un secreto de servidor jamás debe aparecer en la fila de arriba.
09
Variables en EAS: por entorno
Como tu .env no se sube, los builds en la nube no lo ven. EAS (los servicios en la nube de Expo) guarda sus propias variables en tres entornos: development, preview y production.
Cada perfil de eas.json indica cuál usa:
{ "build": { "production": { "environment": "production" } } }Así tu build de pruebas apunta al proyecto de pruebas y el de producción al real.
10
Tres niveles de visibilidad en EAS
| Visibilidad | Quién puede leer el valor |
|---|---|
| Plain text | Visible en la web, en la CLI y en los registros |
| Sensitive | Oculta en los registros; legible en la web y la CLI |
| Secret | No se puede leer fuera de los servidores de Expo |
Para las variables EXPO_PUBLIC_ basta la primera o la segunda. La tercera es para valores que solo usa el proceso de build.
11
«Secret» no protege lo que va en la app
El nivel de visibilidad controla quién la ve en Expo. No cambia lo que queda en el binario.
12
Crear y traer una variable
- Crea la variable desde la terminal:
eas env:set --name EXPO_PUBLIC_API_URL --value https://api.example.com --environment production --visibility plaintext- Repite para cada entorno con su valor.
- Trae las de un entorno a tu computador con
eas env:pull --environment development.
También se administran desde el panel de expo.dev.
13
Secretos de servidor: en las Edge Functions
La clave de la API de Claude, la clave secreta de Supabase y los tokens de pago se guardan como secretos del proyecto de Supabase. Solo las Edge Functions (funciones de servidor, módulo 10) los leen como variables de entorno.
Se cargan con la CLI de Supabase o desde el panel. Copia el comando exacto de la documentación de funciones, no de un tutorial antiguo.
14
También hay archivos que son secretos
- Llaves de firma de Android e iOS: archivos
.jks,.p8y.p12. - La clave de cuenta de servicio de Google que usa el envío a Google Play.
EAS puede generar y guardar las credenciales de firma. También acepta variables de tipo archivo.
15
El error más común: subir el .env
Antes del primer commit, pídele a Claude Code que revise .gitignore y que te muestre la lista de archivos que se van a subir.
16
Si una clave se filtra
- Rótala: genera una nueva y revoca la antigua en el panel del proveedor.
- Actualiza el secreto en Supabase o en EAS y vuelve a desplegar.
- Revisa el uso y la facturación del período expuesto.
- Recién después, limpia el repositorio.
- Anota cómo ocurrió y qué cambias para que no se repita.
17
Por qué el orden importa
Borrar la clave del repositorio no deshace la filtración. Lo único que sirve es rotarla.
18
No toda exposición es un incidente
| Clave expuesta | Gravedad | Qué hacer |
|---|---|---|
| Publicable de Supabase | Ninguna, si RLS está bien | Nada: fue diseñada para eso |
| Secreta de Supabase | Alta: salta RLS | Rotar de inmediato |
| API de Claude o de pagos | Alta: gasta tu dinero | Rotar y revisar consumo |
| Llave de firma | Alta | Seguir el proceso de la tienda |
19
Usa a Claude Code como revisor
Antes de cada publicación, pídele una revisión concreta. Un pedido flojo: «revisa la seguridad». Uno útil: «busca en el proyecto cadenas que parezcan claves y lista cada variable EXPO_PUBLIC_ con su uso».
Tú decides si cada una merece ser pública.
20
Lo incómodo de hacerlo bien
- Hay tres lugares que mantener al día, no uno.
- Las variables
EXPO_PUBLIC_se incrustan al empaquetar: cambiarlas exige publicar de nuevo. - Rotar una clave en uso produce minutos de falla si no lo coordinas.
- Un computador nuevo no trae tus
.env: hay que recuperarlos de EAS.
Es el precio de que una fuga pequeña no se vuelva una grande.
21
Lo que te llevas
- Todo lo que va en la app es público, con o sin prefijo.
- Cada valor tiene su lugar: app, secretos de funciones o EAS.
- La visibilidad Secret de EAS no protege valores incrustados en la app.
- Ante una filtración, primero se rota; después se limpia.
- La clave publicable expuesta no es un incidente si RLS está bien.
22
Hazlo ahora
En 10 minutos, arma el inventario de claves de tu proyecto:
- Lista cada clave, token y archivo de credenciales que uses.
- Clasifica cada uno: público, secreto de servidor o secreto de build.
- Anota dónde está guardado hoy y dónde debería estar.
- Ejecuta
git check-ignore -v .envy confirma que responde.
Corrige primero cualquier secreto de servidor que tenga prefijo EXPO_PUBLIC_.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Expo — Variables de entorno en EASdocs.expo.dev ↗
- Expo — Variables de entorno en el proyectodocs.expo.dev ↗
- Expo — Novedades de SDK 58expo.dev ↗
- Supabase — Edge Functions y sus secretossupabase.com ↗
- Supabase — Guía de Expo: clave publicable y RLSsupabase.com ↗
- Expo — EAS Build y credenciales de firmadocs.expo.dev ↗