
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.
À 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.
É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

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é.
Erreur fréquente
Présenter la sélection d’un fichier comme un téléversement terminé.
É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
À vous de jouer
Quels paramètres de stockage ont été appliqués et le compte de test ouvre-t-il l’application exécutée ?
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Exemple de configuration : « L’assistant a préparé le compartiment privé avatars dans le projet jetable, fixé les limites indiquées de 2 MB en PNG/JPEG/WebP et appliqué les politiques de dossiers propriétaires. L’application HTTP s’ouvre et A peut se connecter. »
Si l’envoi échoue avant la fin de ces contrôles, notez l’étape manquante. Rendre le compartiment public ou retirer les règles de propriété n’est pas un raccourci valable.
- Identifie le projet jetable, le compartiment privé avatars et les limites de format/taille configurées.
- Consigne l’application de connexion/téléversement fonctionnelle et les blocages sans affaiblir ses protections.
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.
Erreur fréquente
Rendre tout le compartiment public pour réparer un aperçu défaillant.
É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é.
À vous de jouer
La petite image a-t-elle été stockée et pouvait-elle être lue ensuite ?
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Exemple de téléversement : « A a envoyé avatar-small.webp. Le fournisseur montrait un objet dans le dossier d’A ; j’ai gardé sa référence expurgée. L’image est ensuite apparue via l’aperçu signé de courte durée. »
Un résultat partiel pourrait être : « L’objet existe, mais l’accès à l’aperçu échoue. » Il faut vérifier la lecture du même objet plutôt que multiplier les copies sans savoir si le stockage a réussi.
- Relie le téléversement réussi d’A à la référence réelle de l’objet stocké.
- Consigne séparément si l’aperçu signé a pu lire cet objet.
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.
Erreur fréquente
Remplacer le contrôle d’accès par des noms de fichiers aléatoires.
É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.
À vous de jouer
Que s’est-il passé pour les fichiers trop gros et non pris en charge et quel accès avez-vous réellement testé ?
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Exemple de refus : « Le PNG trop gros a été refusé sans nouvel objet. Le fichier texte aussi ; l’assistant a aidé à le tester si le sélecteur masquait les formats non acceptés. »
« L’URL signée de l’image autorisée s’ouvrait pendant sa courte validité. Cela démontrait l’accès par cette URL, pas que le compartiment privé était devenu public. » Le filtre du sélecteur ne teste pas directement les limites du stockage fournisseur.
- Consigne séparément refus et stockage pour les deux fichiers invalides fournis.
- Distingue la lecture temporaire par lien signé d’un accès public sans restriction au compartiment.
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)
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.
Erreur fréquente
Publier une URL signée dans un rapport et s’attendre à ce qu’elle reste privée.
É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é.
À vous de jouer
Pour commencer
Les fichiers et contenus d’essai sont fournis. La vérification réelle exige votre propre compte, boîte de réception ou domaine, selon les prérequis. L’inspection locale reste possible ; notez les étapes réelles non exécutées comme non testées.
Fournissez la suppression par le propriétaire et la tentative du second compte avec les résultats réels sur les objets.
Travail à rendre Le résultat de téléversement/suppression et les vrais contrôles valide, trop gros, non pris en charge et intercomptes.
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Exemple de suppression : « A a supprimé X et le fournisseur a confirmé son absence. A a ensuite téléversé un nouveau Y. La session distincte de B a tenté de supprimer Y ; A a vérifié que Y existait encore. »
L’assistant doit identifier l’acteur B et la cible Y avant le test isolé. Retenter X testerait un objet déjà absent, pas la protection réservée au propriétaire.
- Supprime le premier objet d’A en tant que propriétaire et vérifie que cet objet exact a disparu.
- Téléverse un nouvel objet d’A, le cible depuis B et vérifie qu’il reste stocké.
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.
- policies.sqlTélécharger ce fichier
- public/app.jsTélécharger ce fichier
- upload-tests.txtTélécharger ce fichier
- worksheet.htmlTélécharger ce fichier
- reference/assignment-walkthrough.txtTélécharger ce fichier
- reference/START-HERE.txtTélécharger ce fichier
- reference/public/index.htmlTélécharger ce fichier
- reference/public/app.jsTélécharger ce fichier
- reference/delete-policy.sqlTélécharger ce fichier
- fixtures/avatar-small.webpTélécharger ce fichier
- fixtures/avatar-too-large.pngTélécharger ce fichier
- fixtures/not-an-image.txtTélécharger ce fichier
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.
Erreur fréquente
Accorder DELETE à tout utilisateur authentifié pour faire fonctionner un bouton.
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
- Comment créer votre premier site personnel
- Comment publier votre site depuis GitHub
- Comment relier un domaine personnalisé à votre site
- Comment configurer une messagerie sur votre domaine
- Comment rendre votre site utilisable sur téléphone
- Comment accélérer le chargement des images de votre site
- Comment recevoir les commentaires de votre site dans votre boîte mail
- Comment ajouter des abonnements par e-mail à votre site
- Comment envoyer des e-mails automatiques depuis votre site
- Comment enregistrer les formulaires dans une base de données
- Comment permettre aux utilisateurs de se connecter à votre site
- Comment garder une page privée
- Comment permettre aux utilisateurs de modifier leur profil
- Comment garder les clés d’API hors de votre interface web
- Comment afficher les données d’une API externe sur votre site
- Comment ajouter un chatbot d’IA à votre site
- Comment faire répondre un chatbot à partir de votre contenu
- Comment ajouter un blog à votre site
- Comment ajouter une recherche à votre site
- Comment ajouter une autre langue à votre site
- Comment aider Google à trouver votre site
- Comment corriger l’aperçu de votre site lors du partage d’un lien
- Comment mesurer les visites et les actions utiles sur votre site
- Comment permettre aux visiteurs de prendre rendez-vous
- Comment accepter un paiement sur votre site
- Comment prévisualiser les changements du site avant publication
- Comment annuler un déploiement défectueux de votre site
- Comment sauvegarder et restaurer les données de votre site
- Comment trouver et corriger les erreurs de votre site en ligne