Clase 02 · Módulo 10
La clave nunca va en la app
La clave nunca va en la app
Qué logras en esta clase
Entiendes por qué la clave de Claude no puede viajar en tu app y dónde va en su lugar.
- Distingues qué valores pueden ir en el teléfono y cuáles no.
- Dibujas la arquitectura app, servidor, Claude.
- Sabes qué hacer si una clave se filtra.
02
Qué es una clave de API
Una API es la puerta por la que un programa le pide algo a otro. La API de Claude recibe pedidos y los cobra por uso a una cuenta de la Console de Anthropic, aparte de tu suscripción.
La clave de API es el texto secreto que identifica esa cuenta. Quien la tenga puede hacer pedidos que pagas tú, sin que nadie le pregunte quién es.
03
El binario es público
Todo lo que viaja dentro de tu app lo puede leer cualquiera que la descargue.
04
Por qué no hay escondite en el teléfono
- El archivo que publicas (
.aabo.ipa) se puede descargar y abrir. - Tu JavaScript va adentro, con todos sus textos.
- El dueño del teléfono puede inspeccionar el tráfico que sale de su equipo.
- No necesitas ser experto: existen herramientas hechas para eso.
Lo que la app conoce, el usuario puede conocerlo.
05
EXPO_PUBLIC_ significa público
En Expo, las variables de entorno con prefijo EXPO_PUBLIC_ quedan dentro de la app. El nombre lo dice: son visibles.
Por eso sirven para la URL de Supabase y su clave publicable, que Supabase considera seguras de exponer porque RLS protege los datos (visto en el módulo 8).
06
Qué puede ir en la app y qué no
| Valor | ¿En la app? | Por qué |
|---|---|---|
| URL de Supabase | Sí | No da acceso por sí sola |
| Clave publicable de Supabase | Sí | RLS decide qué ve cada usuario |
| Clave secreta de Supabase | Nunca | Se salta RLS |
| Clave de la API de Claude | Nunca | Gasta dinero de tu cuenta |
| Token secreto de un medio de pago | Nunca | Permite operar a tu nombre |
07
Qué pasa si la clave se filtra
- Alguien la copia y la usa desde sus propios programas.
- El gasto corre contra tu cuenta hasta tu límite.
- Al llegar al límite, la función deja de responder para tus usuarios reales.
- No sabes quién fue: todos los pedidos llegan con la misma clave.
Publicar una app nueva no lo arregla: las versiones ya instaladas siguen llevando la clave vieja.
08
Ofuscar no es proteger
Partir la clave en trozos o «esconderla» en el código solo retrasa a quien la busca.
09
La arquitectura correcta
La app envía el pedido a un servidor tuyo junto con la sesión del usuario. Ese servidor es el único que conoce la clave. Claude nunca recibe una llamada directa desde un teléfono.
10
Qué hace el servidor en el medio
- Verifica que el pedido viene de un usuario con sesión válida.
- Revisa cuánto ha usado esa persona.
- Arma el pedido con tus instrucciones y el texto recibido.
- Llama a Claude con la clave guardada como secreto.
- Devuelve a la app solo el resultado.
11
Por qué una Edge Function de Supabase
Una Edge Function es un trozo de código que corre en los servidores de Supabase, no en el teléfono.
- Ya tienes el proyecto y los usuarios ahí.
- Reconoce la sesión que envía tu app.
- Tiene un lugar propio para secretos.
- El plan Free incluye 500.000 invocaciones al mes (al 18-11-2026).
Si tu backend vive en otro servicio, sus funciones de servidor cumplen el mismo rol.
12
Tres formas de conectar, una sola correcta
| Forma | Problema |
|---|---|
| La app llama directo a Claude con la clave | La clave queda en el binario |
| Un servidor que reenvía todo sin revisar | Cualquiera lo usa: es tu clave con otra dirección |
| Un servidor que verifica usuario y cuota | Ninguno: es la que se construye en la clase 3 |
13
El error del reenvío abierto
Lo que protege es que el servidor exija una sesión válida y limite el uso antes de llamar a Claude. Sin esos dos controles, la arquitectura se ve correcta y no protege nada.
14
La app pide, el servidor decide
El servidor resuelve si el pedido se atiende, con qué modelo y cuánto se gasta. La app solo muestra el resultado.
15
Lo que ganas además de seguridad
- Cambias de modelo sin publicar una versión nueva de la app.
- Tus instrucciones al modelo quedan privadas.
- Registras el uso de cada persona.
- Cortas a quien abusa sin afectar al resto.
- Corriges un error de la función en minutos, sin revisión de tienda.
16
Dónde vive cada secreto
| Lugar | Qué guarda |
|---|---|
| Secretos de Edge Functions | La clave de Claude en producción |
supabase/functions/.env | La clave para pruebas locales, fuera de Git |
Variables EXPO_PUBLIC_ | Solo valores públicos |
| Repositorio, chats, capturas | Ningún secreto, nunca |
La documentación de Supabase pide agregar ese .env local a .gitignore para que no se suba.
17
Revisa tu proyecto en cuatro pasos
- Busca en la carpeta de la app el dominio de la API de Claude: no debería aparecer.
- Abre tus archivos
.envy lee cada variableEXPO_PUBLIC_. - Confirma que
.gitignoreincluye los.envcon secretos. - Pide a Claude Code que busque claves o tokens escritos en el código y en el historial de Git.
18
Si la clave ya se filtró
- Revoca la clave en la Console y crea una nueva.
- Guarda la nueva solo como secreto del servidor.
- Revisa el uso de la cuenta en busca de gasto ajeno.
- Corrige el código que la exponía.
19
Una clave por app y entorno
La Console permite además agrupar claves en espacios de trabajo y fijar un límite de gasto a cada uno, salvo al espacio por defecto. Así un error en pruebas no consume el presupuesto de producción.
20
Lo que te llevas
- Lo que va en el binario o en una variable
EXPO_PUBLIC_es público. - La clave de Claude vive solo como secreto de una función de servidor.
- El servidor verifica sesión y cuota antes de llamar; sin eso es un reenvío abierto.
- Una clave filtrada se revoca; borrarla del código no alcanza.
- Con el servidor en medio cambias modelo e instrucciones sin publicar la app.
21
Hazlo ahora
En 10 minutos:
- Dibuja en papel el flujo de tu función con IA: app, función de servidor, Claude.
- Anota al lado de cada caja qué secretos conoce.
- Haz la revisión de cuatro pasos sobre tu proyecto.
- Lista tus variables
EXPO_PUBLIC_y confirma, una por una, que no te importa que sean públicas.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Supabase: guía de autenticación con Expo (variables EXPO_PUBLIC_)supabase.com ↗
- Supabase: secretos de Edge Functionssupabase.com ↗
- Supabase: Edge Functionssupabase.com ↗
- Supabase: precios y límitessupabase.com ↗
- Claude Platform: límites de uso y de gastoplatform.claude.com ↗
- Claude Platform: precios de la APIplatform.claude.com ↗