Ir al contenido

El control de acceso de Supabase Storage acaba en la caché del CDN

Infra · 14 de noviembre de 2026 · 10 min de lectura

A grid of bauhaus shapes in black, white and grey: quarter circles, bars and dots

El control de acceso de Supabase Storage es el conjunto de políticas de Row Level Security de Postgres sobre la tabla storage.objects que decide quién puede subir, listar, leer y borrar cada archivo. Decide cuando la petición llega a Storage. Una vez que la respuesta está en la caché del CDN, nadie vuelve a consultar la política, y ahí un archivo privado puede sobrevivir al permiso que lo abrió.

Esto afecta a cualquier producto que guarde archivos que la gente espera que sigan siendo privados: contratos firmados, facturas, documentos de identidad, informes médicos, exportaciones. Una de las búsquedas que nos llegan dice, palabra por palabra: ¿puede Supabase Storage cumplir el RGPD y el control de acceso por archivo como S3 con un CDN, para millones de usuarios? Puede. Las reglas son más estrictas de lo que sugiere la configuración por defecto, y cuatro de ellas quedan fuera de la política.

¿Cómo decide Supabase Storage quién puede leer un archivo?

Cada archivo es una fila de storage.objects, con su bucket, su ruta en name y el usuario que lo subió en owner_id. Storage convierte cada llamada a la API en una consulta sobre esa tabla, así que una política funciona con archivos igual que con cualquier otra tabla. Sin políticas no pasa nada: la guía de control de acceso de Supabase explica que Storage no admite subidas a un bucket hasta que una política las autoriza.

Tres herramientas hacen casi todo el trabajo:

  • La ruta. storage.foldername(name) devuelve en un array las carpetas en las que está un archivo. Si cada ruta empieza por el id del workspace o del usuario, la política puede compararlo con (storage.foldername(name))[1].
  • El propietario. owner_id sale del claim sub del JWT de quien sube el archivo. Un archivo creado con la service key, o desde el dashboard, no tiene propietario, como recuerda la documentación sobre ownership, así que una política basada solo en el propietario nunca lo encuentra.
  • La operación. Listar una carpeta y descargar un archivo necesitan los dos SELECT. Con storage.allow_only_operation() y storage.allow_any_operation() una política abre la descarga y la firma de URLs y deja cerrado el listado.

Esta es una política para un producto B2B en el que cada archivo pertenece a un workspace:

create policy "members read their workspace files"
on storage.objects for select
to authenticated
using (
  bucket_id = 'documents'
  and storage.allow_any_operation(array['object.get_authenticated', 'object.sign'])
  and (storage.foldername(name))[1] in (
    select workspace_id::text
    from public.memberships
    where user_id = (select auth.uid())
  )
);

El rendimiento depende de dos detalles. auth.uid() va dentro de un select, así Postgres lo calcula una vez por consulta y no una vez por fila, y memberships.user_id necesita su propio índice. La guía de rendimiento de RLS de Supabase muestra una política sobre una columna sin índice que recorre 100.000 filas en 171 ms para una consulta que no devuelve nada. En un bucket con millones de objetos ese coste se paga en cada listado y en cada descarga. Los patrones que mantienen rápidas las políticas los recogimos en Supabase RLS a escala.

Las carpetas son solo prefijos de las claves. En Storage los permisos de una carpeta no pasan a los archivos que contiene, y la propia nota de troubleshooting de Supabase recomienda modelar la jerarquía en una tabla propia, indexada y unida a la política con un join. Ahí van las carpetas compartidas, los proyectos anidados y el compartir documentos uno a uno.

¿Dónde se detiene el control de acceso de Supabase Storage?

Los archivos privados llegan al navegador de dos maneras: una URL firmada o una petición al endpoint autenticado con el JWT del usuario. Desde el plan Pro, el Smart CDN guarda en caché las dos, y la documentación del Smart CDN es precisa sobre lo que hace con ellas. De ahí salen cuatro hechos.

  1. Un token caducado no frena una respuesta en caché. Cada URL firmada es una clave de caché propia. Cuando la respuesta está en caché en el edge, esa misma URL se sigue sirviendo hasta que termina la duración de la caché del CDN, aunque el token que lleva ya haya caducado. Revocar o dejar caducar un token no purga su entrada.
  2. Una URL firmada no se puede revocar por separado. La guía para servir archivos enumera las opciones: borrar, mover o renombrar el objeto. Rotar la clave de firma de URLs del proyecto las revoca todas a la vez, y la página sobre las claves de firma añade que las copias ya en caché se pueden seguir sirviendo hasta que se purgue la caché.
  3. La caché no ve un cambio de política. En el endpoint autenticado, el CDN guarda cada respuesta según el acceso que el usuario tenía al pedirla, y la sirve hasta que caduca su JWT. Si sacas a alguien de un workspace, los archivos que abrió siguen a su alcance hasta que purgas la caché o el token caduca.
  4. Cerrar sesión termina la sesión, no el token. Un access token ya emitido sigue siendo válido hasta que caduca. Pasa lo mismo al borrar un usuario: la documentación sobre la gestión de usuarios indica que borrarlo no cierra su sesión.

Debajo de los cuatro está la caché del navegador. Purgar el CDN no la toca, y un archivo se queda ahí hasta que vence su cacheControl. Supabase considera una hora un valor razonable.

Nada de esto es un fallo. Un CDN que consultara a Postgres en cada petición no sería una caché. El trabajo consiste en decidir, tipo de archivo por tipo de archivo, cuánto tiempo puede alguien conservar el acceso después de que se lo quites, y ajustar los números a esa decisión.

¿Cómo se cierra cada hueco?

Separa los archivos según lo rápido que deba acabar el acceso

Los archivos privados se dividen en dos grupos. Avatares, logos y fotos de producto son privados porque pertenecen a alguien, y nadie sale perjudicado si un excompañero ve uno durante otra hora. Contratos, nóminas e historiales médicos son otra cosa: el acceso tiene que acabar cuando acaba el permiso. El primer grupo puede ir en un bucket público o detrás de URLs firmadas largas. El segundo sigue las reglas de abajo. La propia guía del Smart CDN aconseja un bucket público cuando un archivo no tiene una restricción por usuario que importe de verdad: se cachea mejor y no hay que firmarlo.

Reutiliza URLs firmadas cortas durante toda la visita a la página

Una URL firmada generada en cada petición nunca calienta la caché, y cada visualización va al origen. Una generada al abrir la página, y reutilizada mientras sigue abierta, se cachea bien. Para los archivos sensibles firmamos por minutos, no por días, y al subirlos fijamos un cacheControl corto, que pone límite a la caché del navegador. La copia del CDN solo tiene un límite: el propio objeto. Es la regla siguiente.

Revoca moviendo el archivo

Cuando el acceso a un archivo sensible tiene que acabar ya, lo movemos a una ruta nueva. Cuando un objeto cambia, Supabase invalida todas sus entradas en caché, para todos los tokens, en un máximo de 60 segundos. Las rutas que terminan en una versión, como ws_42/contracts/981/v3.pdf, lo convierten en rutina: mover el archivo es crear una versión nueva, las URLs antiguas dejan de funcionar y la fila de la base de datos apunta a la ruta nueva.

Purga la caché cuando cambia un permiso

Quitar a un miembro, cambiar un rol o editar una política debería llamar a la API de purga para los archivos a los que ese miembro tenía acceso. Necesita la secret key, así que se ejecuta en el servidor. Acepta una ruta exacta o un bucket entero, sin comodines, como explica la documentación sobre la purga, y es una función del plan Pro. Purgar un bucket entero deja la caché fría para todos los clientes, por eso guardamos los archivos sensibles en un bucket aparte.

Acorta la vida del access token

El endpoint autenticado se fía del JWT hasta que caduca, así que la duración del token es el retraso de la revocación. Se reduce en los ajustes de sesiones del proyecto; los tokens nuevos llevan la nueva caducidad y los ya emitidos conservan la suya. En productos que guardan documentos la fijamos en minutos y aceptamos algunas renovaciones más.

Pon un servidor delante de los archivos que no pueden esperar

Para los archivos en los que hasta un minuto es demasiado, la comprobación pasa a tu código. Una Edge Function o una ruta del servidor verifica la sesión y el permiso en cada petición, luego pide el archivo a Storage con la secret key y lo devuelve en streaming. Supabase lo documenta como la forma de revocar el acceso al instante. El CDN sigue cacheando entre Storage y tu servidor, pero lo que recibe el usuario lo decide tu código, petición a petición. Marca esas respuestas con private, no-store para que ninguna caché compartida las guarde.

¿Puede Supabase Storage cumplir el RGPD con millones de usuarios?

Puede sostener una arquitectura conforme. La página de Supabase sobre el RGPD describe una responsabilidad compartida: Supabase protege la infraestructura y ofrece un Data Processing Agreement, y a ti te quedan el tratamiento, el consentimiento y las reglas de acceso. En la parte de almacenamiento cuentan cuatro puntos.

  • Región. Un proyecto vive en una sola región principal, y su base de datos, Auth y los objetos de Storage se quedan ahí. La agrupación genérica "Europe" incluye Londres y Zúrich, que no son Estados miembros de la UE: si tus contratos dicen UE, elige una región concreta de la UE. Copias de seguridad, logs, Edge Functions y subencargados siguen entrando en tu análisis de transferencias.
  • Borrado. Los archivos se borran con la API de Storage, nunca con SQL sobre storage.objects: la guía de borrado advierte que un delete en SQL deja el archivo huérfano en el bucket. remove() acepta 1.000 rutas por llamada, y vaciar un bucket por la API se detiene en 200.000 objetos. Por encima, Supabase remite a su protocolo S3.
  • Orden al borrar una cuenta. Supabase se niega a borrar un usuario de Auth que todavía es propietario de objetos en Storage. Primero los archivos, después el usuario. Borrar los objetos también limpia sus entradas del CDN, en menos de un minuto.
  • Quién abrió qué. Una investigación tras una brecha pregunta quién abrió cada archivo. Las políticas deciden el acceso, pero no lo registran. Los archivos servidos por tu servidor, como arriba, te dan ese registro.

Frente a S3 detrás de CloudFront, el intercambio está claro. S3 tiene IAM, bucket policies y más regiones, y sus URLs prefirmadas con Signature Version 4 duran como máximo siete días. Supabase guarda la regla de acceso en SQL, junto a las membresías de las que depende, y para un equipo pequeño es más fácil mantenerla correcta que una política IAM sincronizada con la base de datos de la app. Las preguntas sobre la caché son las mismas en los dos casos: un CDN delante de archivos privados siempre necesita un plan de revocación. Para costes y egress está la comparativa Cloudflare R2 vs S3 vs Supabase Storage; para una residencia estricta cliente por cliente, un bucket de R2 por tenant.

Las obligaciones del RGPD dependen de tu tratamiento, tus contratos y tu sector. El diseño lo tiene que validar un delegado de protección de datos o un abogado. Aquí describimos cómo se comporta el almacenamiento, no lo que la ley te exige.

Cómo se ve en la práctica

Pongamos una herramienta de contratos en la que cada workspace guarda PDFs firmados. Esta es la configuración que lanzaríamos:

  1. Un bucket privado, documents, con rutas del tipo {workspace_id}/{document_id}/v{n}.pdf.
  2. Una política SELECT unida a una tabla memberships indexada y limitada a descarga y firma, sin política de listado: la app lista los documentos desde su propia tabla.
  3. URLs firmadas de cinco minutos, creadas al abrir la página del documento y reutilizadas mientras sigue abierta, con un cacheControl corto.
  4. Al quitar a un miembro, un job en segundo plano que purga las rutas de los documentos del workspace, leídas de la tabla de documentos. Lo que queda lo acotan las URLs de cinco minutos.
  5. Al retirar un documento, el archivo pasa a v{n+1} y todas las URLs antiguas dejan de funcionar en menos de un minuto.
  6. Al borrar una cuenta, archivos eliminados por la API en lotes de 1.000, luego el usuario de Auth, luego las filas.

Para nóminas o documentos médicos añadiríamos la ruta en el servidor, para que cada descarga se compruebe y quede registrada.

Preguntas frecuentes

¿Prefieres que lo hagamos nosotros?

Diseñamos y desarrollamos este tipo de trabajo para clientes. Cuéntanos qué necesitas.