Clase 03 · Módulo 07
Guardar datos en Supabase con RLS
Guardar datos en Supabase con RLS
Qué logras en esta clase
Cada mensaje de tu formulario queda guardado en una tabla que solo tú puedes leer.
- Creas un proyecto en Supabase y la tabla de contactos.
- Distingues la clave publicable de la secreta.
- Activas RLS y compruebas que un visitante no puede leer nada.
02
Qué es Supabase
Es un servicio que te entrega una base de datos Postgres ya instalada, con un panel web para verla y una forma de conectarla a tu código. Postgres es un sistema de base de datos relacional: guarda la información en tablas con filas y columnas.
Tú no instalas ni mantienes un servidor. Creas un proyecto y obtienes una dirección y unas claves.
03
Lo que incluye el plan gratis
| Límite | Valor |
|---|---|
| Proyectos activos | 2 |
| Base de datos | 500 MB por proyecto |
| Respaldos automáticos | No incluidos |
| Pausa | Tras 7 días sin actividad |
| Retención de registros | 1 día |
Un formulario de contacto ocupa una fracción mínima de ese espacio. El plan Pro cuesta US$25 al mes e incluye respaldos diarios guardados 7 días.
04
Tres consecuencias del plan gratis
- Pausa: una web con poco movimiento puede quedar con el proyecto pausado. Hay que saber reactivarlo desde el panel.
- Sin respaldo: copiar tus datos es tarea tuya. Se ve en la clase 6 y en el módulo 11.
- Dos proyectos: no gastes uno en pruebas sueltas.
05
Crear el proyecto
- Crea tu cuenta en supabase.com y activa la verificación en dos pasos.
- Crea un proyecto nuevo.
- Elige la región más cercana a tus visitantes.
- Define la contraseña de la base de datos y guárdala en tu gestor de contraseñas.
El asistente puede cambiar de aspecto, pero esos son los datos que pide. Al terminar tienes una dirección del proyecto y sus claves.
06
Sin RLS, la tabla queda expuesta
La clave publicable es pública por diseño. Una tabla sin protección se puede leer con esa clave desde cualquier parte.
07
Diseñar la tabla de contactos
| Columna | Qué guarda |
|---|---|
id | Número único de cada mensaje |
creado_en | Fecha y hora, puesta sola |
nombre | Quién escribe |
email | A dónde responder |
mensaje | El texto |
estado | Si ya respondiste; parte en «nuevo» |
Las mismas columnas que los campos de tu formulario, más las que te sirven para gestionar.
08
La tabla en SQL
create table public.contactos (
id bigint generated always as identity primary key,
creado_en timestamptz not null default now(),
nombre text not null,
email text not null,
mensaje text not null,
estado text not null default 'nuevo'
);
alter table public.contactos enable row level security;SQL es el lenguaje con que se le habla a la base de datos. La última línea activa la protección desde el primer momento, antes de que exista una sola fila.
09
Dónde se ejecuta ese SQL
| Vía | Cuándo conviene |
|---|---|
| Editor de SQL del panel | Probar rápido, una tabla |
| Migración en tu repositorio | Lo que recomienda Supabase: queda registrado y se puede repetir |
Una migración es un archivo con los cambios de la base, guardado junto al código. Pídele a Claude que escriba la tabla como migración y revísala antes de aplicarla.
10
Dos claves, dos niveles de poder
| Clave | Empieza con | Actúa como | Dónde vive |
|---|---|---|---|
| Publicable | sb_publishable_ | Visitante (anon) | Navegador o servidor |
| Secreta | sb_secret_ | service_role | Solo servidor |
Ambas se administran en el panel, en Settings > API Keys. La secreta se salta RLS: quien la tenga lee y borra todo.
11
Cuidado con las claves antiguas
Muchos tutoriales y mucho código generado por IA todavía las usan. Si Claude te propone variables con esos nombres, pídele que use las claves publicable y secreta según la documentación vigente.
12
Qué es RLS
RLS significa Row Level Security, seguridad a nivel de fila. Es una función de Postgres que revisa cada operación contra reglas llamadas políticas.
Una política dice qué rol puede hacer qué operación sobre cuáles filas. Los roles que importan aquí: anon, el visitante sin sesión, y authenticated, un usuario que inició sesión.
13
RLS activado y cero políticas
Con RLS activo y ninguna política, el visitante no puede hacer nada con la tabla. Para un formulario de contacto, eso es justo lo que buscas.
14
El patrón de este curso
La action valida, frena bots e inserta con la clave secreta. La tabla tiene RLS activado y ninguna política para anon. Nadie puede leer ni escribir en ella desde afuera.
15
La alternativa: insertar desde el navegador
| Por función con clave secreta | Directo con clave publicable | |
|---|---|---|
| Código de servidor | Sí | No |
| Política necesaria | Ninguna | Solo INSERT para anon |
| Exposición al spam | Menor: puedes filtrar antes | Mayor: cualquiera puede insertar |
La segunda sirve para un sitio totalmente estático. Su precio es que no hay dónde frenar a un bot antes de que escriba en tu tabla.
16
Cómo se ve esa política
grant insert on table public.contactos to anon;
create policy "Visitantes pueden enviar"
on public.contactos for insert
to anon
with check ( true );Permite insertar y nada más. No hay política de SELECT, así que el visitante escribe pero no lee. with check define cómo debe ser la fila nueva; true acepta cualquiera.
17
Permisos y políticas: dos puertas
Postgres revisa primero los permisos de la tabla, llamados grants, y después las políticas.
| Qué falta | Qué ves |
|---|---|
| El permiso | Un error, con código 42501 |
| Una política que calce | Una respuesta vacía, sin error |
18
Insertar desde la action
import { createClient } from "@supabase/supabase-js";
import { SUPABASE_URL, SUPABASE_SECRET_KEY } from "astro:env/server";
const supabase = createClient(SUPABASE_URL, SUPABASE_SECRET_KEY);
const { error } = await supabase
.from("contactos")
.insert({ nombre, email, mensaje });supabase-js es la biblioteca oficial para hablar con Supabase desde JavaScript. Pide Node 22 o superior. Las dos variables se cargan como viste en la clase anterior.
19
El error no avisa solo
La biblioteca devuelve un objeto con error. Si tu código no lo revisa, un guardado fallido pasa inadvertido y el visitante ve «enviado».
20
La prueba que demuestra que está cerrada
- Envía un mensaje desde tu formulario.
- Confirma en el panel que la fila existe.
- Pídele a Claude un script de prueba que use solo la clave publicable e intente leer la tabla.
- El resultado correcto es una lista vacía o un error.
Si ese script devuelve tus mensajes, la tabla está abierta. No publiques hasta corregirlo.
21
Ver tus datos en el panel
El panel de Supabase tiene un editor de tablas donde ves las filas como en una planilla.
22
El error que deja todo abierto
El otro: poner la clave secreta en una variable con prefijo PUBLIC_. Con eso la entregas a cada visitante.
23
Lo que te llevas
- Supabase es Postgres con panel; el plan gratis no respalda y pausa tras 7 días sin actividad.
- La clave publicable puede verse; la secreta se salta RLS y solo vive en el servidor.
- RLS activado sin políticas cierra la tabla a los visitantes.
- El formulario inserta desde una función de servidor, no desde el navegador.
- La tabla se da por protegida solo después de probar como visitante.
24
Hazlo ahora
En 15 minutos:
- Crea tu proyecto en Supabase y activa la verificación en dos pasos.
- Pídele a Claude, en modo plan, la migración de tu tabla de contactos con RLS activado.
- Lee el SQL y comprueba que incluye la línea que activa RLS.
- Aplícala y busca la tabla en el panel.
- Guarda la clave secreta en tu archivo local de secretos, no en el chat.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026