Mini-leçon · Français

Comment permettre aux utilisateurs de téléverser des images

Téléversez, rouvrez et supprimez les images de test fournies en vérifiant les limites de taille et la propriété des comptes.

Commencer le cours interactifLire les notes du cours

À qui s’adresse cette leçon ?

Pour les personnes souhaitant permettre le téléversement d’images. Utilisez le projet prêt et un assistant sans écrire de règles de stockage ni de code de téléversement.

Avant de commencer

Un projet Supabase d’exercice distinct avec deux comptes contrôlés. Les fichiers petit, trop gros et non pris en charge sont fournis. Demandez de préparer le stockage privé avatars et les règles fournies dans ce projet jetable.

Durée estimée: 25–42 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Cet atelier couvre le stockage restreint d’images et leur appartenance. Les contrôles client et réglages MIME ne constituent pas une chaîne complète d’analyse de contenu et de logiciels malveillants pour des fichiers publics arbitraires.

Ce que vous apprendrez

  • Distinguez aperçu local et fichier stocké.
  • Testez les fichiers fournis autorisés et rejetés.
  • Vérifiez la suppression réservée au propriétaire et les limites d’un autre compte.

Fichiers de l’atelier

Étape 1

Comprenez ce que prouve l’aperçu

Un nom de fichier sélectionné, un fichier stocké et une image lisible sont trois observations différentes.

Ouvrez l’application avec l’assistant et choisissez fixtures/avatar-small.webp. Avant Upload image, le sélecteur affiche le nom choisi. Ce projet ne crée pas d’aperçu local lors de la sélection : l’image n’apparaît qu’après réussite du téléversement et de l’accès signé.

D’autres applications affichent une image locale sans la stocker. Ici aussi, choisir un nom de fichier ne démontre aucun téléversement distant. Vérifiez séparément sélection, stockage fournisseur et lecture ultérieure.

Un exemple concret

Sélectionner avatar-small.webp peut afficher son nom avant toute configuration du stockage. Pour démontrer ensuite son stockage distant, retrouvez l’objet chez le fournisseur et vérifiez l’aperçu signé qui le lit.

Utilise l’atelier complet de téléversement et mon projet Supabase jetable. Aide-moi à configurer connexion, bucket privé avatars, limite indiquée de 2 MB et formats autorisés avec les règles fournies. Exclus les clés privées des fichiers publics. Lance la page et guide les tests de fichiers petit/trop gros/non pris en charge et les contrôles de suppression avec des comptes distincts. Gère le code pour moi.

Fichiers de cette étape

fixtures/avatar-small.webp
fixtures/avatar-small.webpTélécharger ce fichier

Start hereFichiers de l’atelier

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

How it works (optional)

Stockez l’image, pas seulement un aperçu local

Un aperçu créé depuis un fichier sélectionné ne prouve pas qu’un service de stockage l’a reçu.

Le navigateur détient d’abord le fichier choisi. Le téléversement envoie ses octets à un service de stockage d’objets, qui lui donne un chemin et applique des règles d’accès.

Nous utiliserons un compartiment Supabase privé avec un dossier propriétaire par compte. L’application téléverse le fichier puis demande une URL d’aperçu signée de courte durée. Elle ne rend pas tous les fichiers publiquement lisibles.

Exemple détaillé

Un aperçu blob: local peut fonctionner sans requête réseau. Notre test examinera l’objet réel et le récupérera par une voie autorisée.

Extra implementation exercise

L’image choisie apparaît immédiatement via une URL blob. Le téléversement a-t-il forcément eu lieu ?

Afficher une solution détaillée

Non. Vérifiez l’opération de stockage et l’objet correspondant avant d’affirmer le téléversement.

  • Sépare l’aperçu local du stockage distant.
  • Vérifie le résultat du téléversement et l’objet stocké.

Étape 2

Préparez le stockage privé de test

Utilisez les paramètres fournis et un assistant pour configurer.

Dans le projet jetable, faites configurer le bucket privé avatars, les limites de taille/format et policies.sql. Lancez l’application complète de connexion/téléversement sur HTTP.

Confirmez le caractère privé du bucket et le bon compte/projet. Ne retirez pas les protections de stockage pour faire réussir une requête ratée.

Un exemple concret

L’interface peut aider à rejeter un fichier, mais le service de stockage doit aussi imposer ses propres règles.

Supabase : contrôle d’accès au stockage

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Créez un compartiment privé et des règles de propriétaire

La configuration du compartiment et les politiques d’accès imposent des aspects distincts de la tâche.

Créez avatars en privé. Configurez sa limite de 2MB et les types MIME autorisés, puis appliquez policies.sql. Les rôles du navigateur doivent insérer et lire uniquement sous leur ID utilisateur vérifié.

L’attribut accept facilite l’usage, sans constituer une sécurité. Les règles de taille, type et appartenance s’appliquent encore aux requêtes directes. Une étiquette MIME ne prouve pas la sûreté d’un contenu arbitraire ; ne présentez pas l’atelier comme un service complet d’analyse.

Pour USER_A/avatar-1.webp, storage.foldername(name) renvoie les composants de dossier ; [1] choisit le premier dans ce tableau PostgreSQL. Il doit correspondre à l’ID authentifié. USER_B/avatar-1.webp échoue pour A. Cette règle de stockage est distincte du sélecteur de fichiers et du contrôle MIME préalable du navigateur.

Le premier segment reste l’ID même avec des sous-dossiers : USER_A/subfolder/avatar.webp garde USER_A comme composant [1]. Un chemin subfolder/USER_A/... ne correspondrait pas. Gardez l’ID en premier ; n’assouplissez pas la politique pour accepter un chemin erroné.

Exemple détaillé

Le préfixe vient de l’utilisateur connecté et la politique le compare à auth.uid(). Remplacer le chemin par le dossier d’autrui ne doit pas accorder de droit.

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 : contrôle d’accès au stockage

Extra implementation exercise

Pourquoi vérifier l’extension uniquement dans JavaScript ne suffit-il pas ?

Afficher une solution détaillée

L’appelant peut envoyer directement une requête avec d’autres métadonnées ou un autre chemin. Imposez les règles de compartiment et de propriétaire à la frontière du service.

  • Reconnaît que l’appelant peut contourner JavaScript.
  • Exige des restrictions et une autorisation côté stockage.

Étape 3

Téléversez la petite image de test

Vérifiez l’objet stocké autant que l’image visible.

Connectez-vous comme A et téléversez la petite image fournie. Retrouvez son objet chez le fournisseur et utilisez l’aperçu obtenu ou l’accès signé.

Si le stockage réussit mais l’aperçu échoue, examinez lecture/aperçu avant de téléverser une autre copie. Gardez la référence d’objet.

Un exemple concret

Un aperçu absent ne signifie pas nécessairement que le téléversement a échoué.

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Téléversez vers un chemin propriétaire unique

Utilisez un nom généré au lieu de faire confiance au chemin de l’appelant ou d’écraser un fichier.

Après connexion, l’application choisit un chemin avec l’ID vérifié et un nom aléatoire. Elle vérifie taille et type avant la demande, mais ces contrôles ne remplacent pas ceux du fournisseur.

Le téléversement n’active pas upsert. Si le stockage réussit mais la création d’URL signée échoue, l’interface présente ces observations séparément. Elle n’annonce jamais « rien téléversé » alors que l’objet peut déjà exister.

Exemple détaillé

Un nom généré évite les collisions accidentelles avec une autre image photo.jpg. Il ne constitue pas une autorisation à lui seul.

Extra implementation exercise

L’objet existe, mais la création d’aperçu échoue. Faut-il immédiatement téléverser une autre copie ?

Afficher une solution détaillée

Vérifiez d’abord chemin et politique de lecture. Téléverser encore peut créer des doublons sans réparer l’aperçu.

  • Distingue le stockage réussi de l’autorisation d’aperçu.
  • Examine la politique de lecture et le chemin avant de créer des doublons.

Étape 4

Essayez les cas d’échec fournis

L’exercice inclut des fichiers qui ne doivent pas être téléversés.

Utilisez fixtures/avatar-too-large.png et fixtures/not-an-image.txt. Notez les réponses de la page et du stockage. Demandez d’examiner un rejet confus ou un fichier invalide accepté.

Les fichiers rejetés ne doivent pas devenir des objets stockés. Une URL signée valide peut permettre à son détenteur de voir l’image pendant sa durée de validité ; cela ne prouve pas à lui seul que le bucket est devenu public.

Un exemple concret

Une restriction du sélecteur de fichiers et l’application réelle des règles de stockage sont deux contrôles distincts.

Fichiers de cette étape

fixtures/avatar-small.webp
fixtures/avatar-small.webpTélécharger ce fichier

Start hereFichiers de l’atelier

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

How it works (optional)

Vérifiez les refus et l’accès temporaire

Testez les règles du service et comprenez ce qu’accorde un lien signé.

Envoyez fixtures/avatar-small.webp avec le compte A. Vérifiez son chemin de stockage et ouvrez l’aperçu signé autorisé. Essayez ensuite fixtures/avatar-too-large.png, supérieur à 2MiB, et fixtures/not-an-image.txt, de type non accepté : tous deux doivent être refusés. Les trois fichiers sont fournis.

Avec B, demandez un lien signé vers le chemin de A ; la politique doit le refuser. Une URL légitimement émise pour A reste utilisable par toute personne qui l’obtient jusqu’à expiration. Se déconnecter ne révoque pas instantanément toutes les URL émises.

Exemple détaillé

Un relevé utile indique un chemin expurgé et la durée d’expiration, pas l’URL temporaire complète.

Extra implementation exercise

Quelqu’un ouvre l’image sans connexion avec une URL signée valide. Cela prouve-t-il à lui seul l’échec de la politique privée ?

Afficher une solution détaillée

Non. Testez si un compte non autorisé peut créer l’URL ou lire sans capacité autorisée. Traitez les liens émis comme sensibles jusqu’à expiration.

  • Reconnaît les URL signées comme des autorisations temporaires pour leur détenteur.
  • Distingue l’accès par URL du droit de créer cette URL.

Étape 5

Ajoutez une suppression réservée au propriétaire

Vérifiez qui peut supprimer l’objet téléversé.

Demandez à l’assistant d’ajouter la suppression réservée au propriétaire. En A, supprimez un premier objet X et vérifiez son absence dans le stockage. Téléversez ensuite un nouvel objet Y en A ; gardez sa référence expurgée pour le contrôle suivant.

Dans la session distincte de B, faites cibler Y par une suppression directe assistée. Notez acteur B, cible Y et réponse fournisseur, puis vérifiez que Y existe encore pour A. Un bouton masqué ou une nouvelle tentative sur X déjà absent ne démontrerait pas cette limite de propriété.

Un exemple concret

Retirer une image de l’écran n’équivaut pas à supprimer l’objet stocké.

Fichiers de cette étape

fixtures/avatar-small.webp
fixtures/avatar-small.webpTélécharger ce fichier

Start hereFichiers de l’atelier

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

How it works (optional)

Votre devoir : ajouter une suppression réservée au propriétaire

Une nouvelle opération exige sa propre politique et ses tests négatifs.

Ajoutez un contrôle de suppression de l’objet et une politique DELETE restreinte au dossier propriétaire. N’élargissez pas le compartiment en espace public partagé.

Vérifiez que A peut supprimer son objet et que B ne le peut pas. Gardez l’état du stockage et de l’interface cohérent après un échec.

Exemple détaillé

Les politiques initiales autorisent volontairement seulement l’insertion et la lecture. Le droit de téléversement n’autorise pas automatiquement la suppression.

Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

Extra implementation exercise

Implémentez la suppression propriétaire et démontrez des tentatives autorisées et interdites.

Afficher une solution détaillée

Utilisez un compartiment avatars privé avec des réglages de taille et de type appliqués côté stockage et des politiques pour les dossiers de chaque propriétaire. Téléversez une image autorisée avec le compte A ; examinez le résultat renvoyé par le stockage, puis ouvrez l’aperçu accessible par une URL signée de courte durée. Un aperçu blob ne prouve pas, à lui seul, qu’un téléversement distant a eu lieu.

Essayez un fichier non pris en charge ou trop grand et tentez un téléversement ou une lecture dans le dossier de B. A ne doit pas accéder en changeant seulement un chemin dans les outils. Les URL signées accordent délibérément un accès temporaire jusqu’à expiration.

Pour supprimer, ajoutez DELETE avec la même condition de compartiment et dossier et appelez remove avec le chemin stocké exact. Vérifiez l’absence de l’objet ensuite et qu’une suppression entre propriétaires laisse l’autre objet intact. Le module de référence est séparé pour examiner chemin et politique avant intégration.

  • Le droit de suppression vérifie le compartiment et le dossier du propriétaire vérifié.
  • Les échecs ne suppriment pas l’objet d’autrui et ne vident pas faussement l’interface.

Cette leçon vous a-t-elle été utile ?

Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.

Poursuivre votre apprentissage

Explorer les autres leçons