Minilección · Español

Cómo permitir que los usuarios suban imágenes

Sube, reabre y borra las imágenes de prueba comprobando límites de tamaño y propiedad.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para quienes quieren que los visitantes suban imágenes. Usa el proyecto y un asistente sin escribir políticas de almacenamiento ni código de subida.

Antes de empezar

Un Supabase de práctica independiente con dos cuentas controladas. Se incluyen archivos pequeño, excesivo y no admitido. Pide preparar almacenamiento privado avatars y políticas en ese proyecto desechable.

Tiempo estimado: 25–42 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. Este laboratorio aborda almacenamiento restringido y propiedad de imágenes. Las comprobaciones del cliente y los ajustes MIME no constituyen un proceso completo de validación de contenido y malware para subidas públicas arbitrarias.

Qué aprenderás

  • Distingue vista local y subida almacenada.
  • Prueba los archivos permitidos y rechazados proporcionados.
  • Comprueba borrado solo del propietario y límites de otra cuenta.

Archivos del taller

Paso 1

Entiende qué demuestra la vista previa

Un nombre seleccionado, un archivo almacenado y una imagen legible son observaciones diferentes.

Abre la aplicación con el asistente y selecciona fixtures/avatar-small.webp. Antes de Upload image, el control muestra el nombre. Este inicio no genera vista local al seleccionar; la imagen aparece solo tras subir y acceder con firma correctamente.

Otras aplicaciones pueden mostrar una imagen local sin almacenarla. Aquí también seleccionar un nombre no prueba subida remota. Separa selección, almacenamiento proveedor y lectura posterior.

Un ejemplo concreto

Seleccionar avatar-small.webp puede mostrar el nombre antes de configurar almacenamiento. Para verificar después el guardado remoto, encuentra el objeto en el proveedor y comprueba la vista firmada que lo lee.

Usa el taller completo de imágenes y mi Supabase desechable. Ayúdame a configurar acceso, bucket privado avatars, límite de 2 MB y formatos permitidos con las políticas. Excluye claves privadas de archivos públicos. Ejecuta y guía pruebas de archivo pequeño/excesivo/no admitido y borrado con cuentas separadas. Haz los cambios de código por mí.

Archivos de este paso

fixtures/avatar-small.webp
fixtures/avatar-small.webpDescargar este archivo

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Almacena la imagen, no solo una vista previa local

Una vista previa creada desde un archivo seleccionado no demuestra que un servicio de almacenamiento lo haya recibido.

El navegador conserva primero el archivo elegido. Subirlo envía sus bytes a un servicio de almacenamiento de objetos, que le da una ruta y aplica reglas de acceso.

Utilizaremos un contenedor Supabase privado con una carpeta de propietario por cuenta. La aplicación sube un archivo y después pide una URL firmada de vista previa de corta duración. No hace públicas todas las subidas.

Ejemplo resuelto

Una vista previa local blob: puede funcionar sin solicitudes de red. Nuestra prueba examinará el objeto real y lo recuperará por una vía autorizada.

Extra implementation exercise

La imagen elegida aparece al instante mediante una URL blob. ¿Se ha producido necesariamente la subida?

Mostrar una solución desarrollada

No. Verifica la operación de almacenamiento y el objeto correspondiente antes de afirmar una subida.

  • Distingue vista previa local de almacenamiento remoto.
  • Comprueba el resultado de subida y el objeto almacenado.

Paso 2

Prepara almacenamiento privado de prueba

Usa los ajustes proporcionados y el asistente.

En el proyecto desechable, pide configurar bucket privado avatars, límites y policies.sql. Inicia la aplicación completa de acceso/subida sobre HTTP.

Confirma que el bucket sea privado y cuenta/proyecto correctos. No retires protecciones para hacer funcionar una petición fallida.

Un ejemplo concreto

La interfaz puede rechazar archivos, pero el servicio también debe imponer sus reglas.

Supabase: control de acceso al almacenamiento

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Crea un contenedor privado y reglas de propietario

La configuración del contenedor y las políticas de acceso imponen partes distintas de la tarea.

Crea avatars como privado. Configura límite de 2MB y tipos MIME permitidos, y aplica policies.sql. Los roles del navegador solo deben insertar y leer rutas bajo su ID de usuario verificado.

El atributo accept facilita el uso; no es una comprobación de seguridad. Las reglas de tamaño, tipo y propiedad también se aplican a solicitudes directas. Las etiquetas MIME no demuestran por sí solas que el contenido arbitrario sea seguro; no presentes este laboratorio como un servicio completo de análisis.

Para USER_A/avatar-1.webp, storage.foldername(name) devuelve los componentes de carpeta; [1] selecciona el primero de esta matriz PostgreSQL. Debe coincidir con el ID autenticado. USER_B/avatar-1.webp falla para A. Esta regla de almacenamiento es distinta del selector de archivos y la comprobación MIME previa del navegador.

El primer segmento sigue siendo el ID incluso con carpetas anidadas: USER_A/subfolder/avatar.webp conserva USER_A como componente [1]. Una ruta subfolder/USER_A/... no coincide. Mantén primero el ID; no relajes la política para acomodar una ruta equivocada.

Ejemplo resuelto

El prefijo procede del usuario con sesión, y la política lo compara con auth.uid(). Cambiar la ruta del navegador a la carpeta ajena no debe conceder permisos.

create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);

Supabase: control de acceso al almacenamiento

Extra implementation exercise

¿Por qué no basta comprobar la extensión solo en JavaScript?

Mostrar una solución desarrollada

Quien llama puede enviar una solicitud directa con otros metadatos o ruta. Impón las reglas de contenedor y propietario en el límite del servicio.

  • Reconoce que quien llama puede eludir JavaScript.
  • Exige restricciones y autorización del servicio de almacenamiento.

Paso 3

Sube la imagen pequeña

Comprueba el objeto guardado además de la imagen visible.

Accede como A y sube la imagen pequeña. Encuentra el objeto en el proveedor y usa la vista resultante o acceso firmado.

Si guardar funciona pero la vista falla, revisa lectura/vista antes de subir otra copia. Conserva la referencia.

Un ejemplo concreto

Una vista ausente no significa necesariamente que falló la subida.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sube a una ruta única del propietario

Usa un nombre generado en vez de confiar en la ruta de quien llama o sobrescribir un archivo.

Después de acceder, la aplicación elige una ruta con el ID verificado y un nombre aleatorio. Comprueba tamaño y tipo antes de pedir la subida, pero esas comprobaciones no sustituyen las del proveedor.

La subida no activa upsert. Si el almacenamiento funciona pero falla crear la URL firmada, la interfaz informa de ambas observaciones por separado. Nunca dice «no se subió nada» cuando el objeto quizá ya existe.

Ejemplo resuelto

Generar el nombre evita colisiones accidentales con otra imagen llamada photo.jpg. Por sí solo no es autorización.

Extra implementation exercise

El objeto existe, pero falló crear la vista previa. ¿Debes subir inmediatamente otra copia?

Mostrar una solución desarrollada

Comprueba primero ruta y política de lectura. Volver a subir puede crear duplicados sin reparar la vista previa.

  • Distingue la subida correcta de la autorización de vista previa.
  • Investiga la política de lectura y la ruta antes de crear duplicados.

Paso 4

Prueba los fallos incluidos

El ejercicio contiene archivos que no deben subirse.

Usa fixtures/avatar-too-large.png y fixtures/not-an-image.txt. Registra respuestas de página y almacenamiento. Pide examinar un rechazo confuso o un archivo inválido aceptado.

Los archivos rechazados no deben guardarse como objetos. Una URL firmada válida permite a su poseedor ver la imagen durante su vigencia; eso no prueba por sí solo que el bucket sea público.

Un ejemplo concreto

La restricción del selector y la aplicación real de reglas de almacenamiento son pruebas distintas.

Archivos de este paso

fixtures/avatar-small.webp
fixtures/avatar-small.webpDescargar este archivo

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Verifica el rechazo y el acceso temporal

Prueba las reglas del servicio y entiende qué concede un enlace firmado.

Sube fixtures/avatar-small.webp con la cuenta A. Inspecciona su ruta de almacenamiento y abre la vista firmada autorizada. Después prueba fixtures/avatar-too-large.png, que supera 2MiB, y fixtures/not-an-image.txt, de tipo no permitido: ambos deben rechazarse. Los tres archivos están incluidos.

Utiliza B para solicitar un enlace firmado de la ruta de A; la política debe denegarlo. Una URL emitida legítimamente a A puede usarla cualquiera que la obtenga hasta su caducidad. Cerrar sesión no revoca al instante todas las URL emitidas.

Ejemplo resuelto

Un informe útil registra una ruta sin datos sensibles y la duración de caducidad, no la URL temporal completa.

Extra implementation exercise

Alguien con una URL firmada válida abre la imagen sin sesión. ¿Demuestra eso por sí solo que falló la política privada?

Mostrar una solución desarrollada

No. Comprueba si una cuenta no autorizada puede crear la URL o leer sin un permiso autorizado. Trata los enlaces emitidos como sensibles hasta que caduquen.

  • Reconoce las URL firmadas como permisos temporales para quien las posee.
  • Distingue acceder a la URL del permiso para crearla.

Paso 5

Añade borrado exclusivo del propietario

Verifica quién puede eliminar el objeto subido.

Pide añadir el borrado exclusivo del propietario. Como A, elimina un primer objeto X y verifica que no existe en almacenamiento. Sube después un Y nuevo como A y guarda su referencia sin secretos.

En la sesión separada de B, pide un borrado directo de Y. Registra actor B, objetivo Y y respuesta proveedor; verifica después que Y siga existiendo para A. Un botón oculto o intentar borrar X ya ausente no demuestra la frontera de propiedad.

Un ejemplo concreto

Quitar una imagen de pantalla no equivale a borrar el objeto guardado.

Archivos de este paso

fixtures/avatar-small.webp
fixtures/avatar-small.webpDescargar este archivo

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tu tarea: añadir eliminación solo para el propietario

Una operación nueva necesita su propia política y pruebas negativas.

Añade un control para eliminar el objeto y una política DELETE restringida a la carpeta del propietario. No conviertas el contenedor en un área compartida pública.

Verifica que A puede borrar su objeto y B no. Mantén coherentes el almacenamiento y la interfaz después de un fallo de eliminación.

Ejemplo resuelto

Las políticas originales permiten deliberadamente solo inserción y lectura. El permiso de subida no autoriza automáticamente eliminar.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Extra implementation exercise

Implementa eliminación exclusiva del propietario y demuestra intentos permitidos y prohibidos.

Mostrar una solución desarrollada

Utiliza un bucket avatars privado con ajustes de tamaño y tipo aplicados en el almacenamiento y políticas para las carpetas de cada propietario. Sube una imagen permitida con la cuenta A; examina el resultado devuelto por el almacenamiento y después abre la vista previa mediante una URL firmada de corta duración. Una vista previa blob, por sí sola, no demuestra que se haya subido nada al servicio remoto.

Prueba un archivo no admitido o demasiado grande e intenta subir o leer bajo la carpeta de B. A no debe acceder solo por cambiar una ruta en las herramientas. Las URL firmadas conceden intencionalmente acceso temporal hasta caducar.

Para borrar, añade DELETE con la misma condición de contenedor y carpeta y llama a remove con la ruta exacta guardada. Verifica que después no existe el objeto y que borrar entre propietarios deja intacto el ajeno. El módulo de referencia está separado para que examines ruta y política antes de integrarlo.

  • El permiso de borrado comprueba contenedor y carpeta del propietario verificado.
  • Los intentos fallidos no borran el objeto ajeno ni vacían falsamente la interfaz.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones