LeçonsComment permettre aux utilisateurs de se connecter à votre site

Mini-leçon 11 sur 30 · Comptes et accès

Comprenez le parcours de connexion

À qui s’adresse cette leçon ?

Pour les personnes souhaitant une connexion par compte sur un petit site. Le service géré et l’application fournie réalisent l’implémentation ; travaillez avec un assistant sans écrire de code d’authentification.

Recevoir un code et être connecté sont deux moments distincts.

Objectif de cette leçon

  • Demandez et utilisez un vrai code de connexion.
  • Vérifiez les états connecté et déconnecté.
  • Gardez les mauvais codes et courriels absents comme de vrais échecs.
Explications, exemple détaillé et exercices

Avant de commencer

Votre projet Supabase d’exercice et une boîte de test autorisée ou un expéditeur configuré. Utilisez la page sur HTTP local ou votre hébergement HTTPS. L’assistant peut guider la configuration des codes par courriel.

Vérifiez vos acquis de départ

Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.

  1. Comment publier votre site depuis GitHub

    Connectez un dépôt d’exercice à l’hébergement.

Durée estimée: 20–32 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. La livraison des e-mails et la configuration du compte peuvent ajouter de l’attente. Vérifiez les restrictions du fournisseur et les durées de session dans le compte utilisé pour l’exercice.

Comprendre le principe

Utilisez la page prête avec l’assistant. La personne saisit une adresse, reçoit un code et le soumet avant que le service n’établisse la connexion.

« Consultez votre boîte » indique une demande envoyée, pas un visiteur authentifié.

Un exemple concret

Une adresse seule ne prouve pas que son propriétaire a terminé la connexion.

Utilise l’application Supabase fournie. Guide la configuration des codes par courriel avec ma boîte autorisée, place uniquement les valeurs publiables du projet dans la configuration publique et exécute la page sur HTTP. Aide-moi à demander un code, le saisir, recharger et me déconnecter. Un code invalide ou un courriel absent ne doit pas devenir un faux état connecté.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quels états visibles vérifierez-vous entre saisie de l’adresse et connexion réelle ?

Afficher une solution détaillée

Exemple de réponse : « Après Send sign-in code, j’attends un message d’acceptation de la demande. Je dois ensuite trouver le mail. La page ne doit identifier mon compte connecté qu’après la réussite de Verify code. »

« Check your inbox » appartient à l’étape de demande. Cela ne démontre ni l’arrivée du mail ni l’existence d’une session.

Éléments d’une réponse solide

  • Distingue la demande du message, la réception du code et la vérification de connexion.
  • Identifie l’affichage du compte vérifié, et non la saisie de l’adresse, comme preuve de session.
Comment ça marche (facultatif)

Ajoutez une véritable session de connexion

L’authentification vérifie une identité ; afficher une adresse e-mail ne suffit pas.

Nous utiliserons Supabase Auth pour envoyer un code à usage unique par e-mail et établir une session après vérification. Le SDK du navigateur gère le stockage et le renouvellement de session ; nous n’implémentons pas de base de mots de passe.

Une requête acceptée par le point de terminaison d’e-mail ne signifie pas que l’utilisateur est connecté. La session apparaît uniquement après une vérification valide. L’autorisation d’accès aux données privées est une autre vérification, distincte et ultérieure.

Exemple détaillé

Saisir l’adresse d’une autre personne ne doit pas donner ses accès. Le code envoyé dans sa boîte est l’étape de vérification.

Supabase : codes de connexion par e-mail · Supabase : types de clés d’API

Exercice technique complémentaire

La page a accepté une adresse et affiche “Check your inbox” (consultez votre boîte). Le visiteur est-il déjà authentifié ?

Afficher une solution détaillée

Non. La demande de connexion a commencé. Vérifiez le code et examinez la session obtenue avant d’afficher un état connecté.

  • Sépare les états de demande et de vérification.
  • Exige une vérification réussie et une session.

Étape 1 · Comment permettre aux utilisateurs de se connecter à votre site

Préparez le fournisseur et la page

Choisissez le parcours par code attendu par le formulaire.

Explications, exemple détaillé et exercices

Comprendre le principe

Avant de tester, faites vérifier quatre prérequis à l’assistant : le bon projet Supabase, une boîte autorisée par ses réglages d’expéditeur, un modèle de mail contenant un code et la page fournie servie en HTTP. Le modèle doit correspondre à cette saisie de code, pas contenir uniquement un lien magique.

Seuls l’URL du projet et sa clé publiable vont dans public/config.js. Excluez les clés secrètes ou service-role des fichiers du navigateur. Ces vérifications du fournisseur et de l’application fonctionnelle sont nécessaires ; lire ou réécrire l’authentification reste facultatif.

Un exemple concret

Un lien mail fonctionnel peut rester le mauvais parcours pour une page demandant de saisir un code.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

La configuration et le message reçu correspondaient-ils au formulaire par code ?

Afficher une solution détaillée

Exemple de préparation : « Le projet d’exercice est sélectionné ; le modèle de mail contient le code ; public/config.js contient seulement l’URL et la clé publiable ; la page s’ouvre en HTTP local. »

Un blocage pourrait être : « La page s’ouvre, mais le mail ne contient qu’un lien. Le test de saisie de code attend la correction du modèle fournisseur avec l’assistant. » Aucun des deux relevés ne contient de clé ni de code réutilisable.

Éléments d’une réponse solide

  • Précise le projet, le modèle de mail contenant le code et la disponibilité de la prévisualisation HTTP.
  • Distingue les réglages publics du projet des clés secrètes et rapporte l’étape bloquée.
Comment ça marche (facultatif)

Configurez le fournisseur et le client navigateur

Le modèle d’e-mail et le type de clé doivent correspondre au parcours par code fourni.

Dans un projet Supabase séparé, activez l’authentification Email. Vérifiez si son expéditeur peut livrer à votre boîte de test ; configurez un SMTP compatible si nécessaire. Dans le modèle Magic Link, incluez {{ .Token }} pour que le message fournisse le code attendu par cette page.

Placez l’URL du projet et la clé publiable dans config.js. Cette clé identifie l’application ; ce n’est ni une session utilisateur ni un secret administratif. Ne mettez jamais de clé secrète ou service-role dans ce fichier navigateur. Servez public/ en HTTP/HTTPS pour que les imports de modules fonctionnent.

La page attend un code d’e-mail (OTP) saisi par l’utilisateur. Dans le modèle du fournisseur, {{ .Token }} produit ce code ; un modèle contenant uniquement une variable de lien de confirmation ne donnera pas à cette interface le code qu’elle demande. Utilisez le guide actuel d’e-mail sans mot de passe pour trouver le modèle, sans deviner le nom d’un réglage.

Le guide officiel Supabase “With OTP” explique explicitement que les codes par e-mail partagent l’implémentation Magic Link : modifiez le modèle Magic Link pour inclure {{ .Token }}. Ce nom ne signifie pas que cette page doit recevoir un message contenant seulement un lien. Suivez ce guide si les libellés du tableau de bord diffèrent ; n’inventez pas un réglage de modèle sans rapport.

Exemple détaillé

La méthode du SDK s’appelle signInWithOtp, mais l’e-mail peut contenir un lien ou un code selon le modèle. Notre interface attend la version avec code.

Exercice technique complémentaire

Votre page demande un code, mais l’e-mail ne contient qu’un lien magique. Que devez-vous vérifier ?

Afficher une solution détaillée

Vérifiez la valeur Token dans le modèle configuré et répétez la demande après l’avoir aligné sur l’interface par code. Suivez la documentation actuelle du fournisseur pour votre projet.

  • Vérifie le modèle d’e-mail et le parcours voulu.
  • N’invente pas de code et ne prétend pas que le message a été vérifié.

Étape 2 · Comment permettre aux utilisateurs de se connecter à votre site

Terminez une vraie connexion

Utilisez le courriel plutôt qu’un code inventé.

Explications, exemple détaillé et exercices

Comprendre le principe

Commencez sans connexion dans une nouvelle fenêtre privée. Demandez un code pour votre boîte contrôlée et saisissez d’abord volontairement un mauvais code. Vérifiez le refus et l’absence de compte connecté. Demandez ensuite un nouveau code, saisissez la valeur réelle reçue et inspectez le compte identifié.

Un code refusé ne doit pas créer de connexion. Si vous étiez déjà connecté, le mauvais code pourrait laisser la session existante intacte : c’est une autre situation, qui ne teste pas la prévention d’une nouvelle session. Si aucun mail n’arrive, notez précisément ce blocage.

Un exemple concret

Un message aimable de réussite après un code rejeté représenterait faussement l’état du compte.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Dans une nouvelle fenêtre déconnectée, qu’avez-vous observé avec un mauvais code puis un nouveau code réellement reçu ?

Afficher une solution détaillée

Exemple de test : « Dans une nouvelle fenêtre privée, le mauvais code a affiché Code was not accepted et la page indiquait encore No signed-in account. J’ai ensuite demandé un nouveau code par mail, l’ai vérifié et vu mon compte contrôlé identifié. »

Si le mail n’arrive pas, un relevé valable est : « Demande acceptée ; aucun code dans la boîte autorisée ni les indésirables ; vérification réussie non testée. » Tester un mauvais code en étant déjà connecté ne démontre pas qu’une nouvelle session a été empêchée.

Éléments d’une réponse solide

  • Teste un code erroné sans session connectée et constate qu’aucune connexion n’a été établie.
  • Utilise ensuite un nouveau code réel et vérifie l’identité du compte obtenu.
Comment ça marche (facultatif)

Demandez et vérifiez un code

Chaque bouton correspond à une transition d’état différente.

Lisez public/app.js. La première action appelle signInWithOtp avec l’e-mail saisi ; la seconde appelle verifyOtp avec cet e-mail et le jeton reçu. Un résultat réussi comprend une session.

Utilisez votre propre boîte et copiez exactement le code actuel. Un code incorrect, expiré ou déjà utilisé doit laisser l’utilisateur déconnecté. N’enregistrez ni codes ni jetons d’accès dans un rapport partagé.

Exemple détaillé

L’interface utilise textContent pour l’état et le texte du compte. Elle n’interprète pas une adresse e-mail comme du HTML.

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

Exercice technique complémentaire

Un code incorrect renvoie une erreur, mais votre application affiche quand même “Signed in” (connecté). Quelle condition doit changer ?

Afficher une solution détaillée

Affichez l’état connecté uniquement si la vérification réussit et qu’une session existe. Ne prenez pas le clic sur le bouton comme preuve.

  • Vérifie l’erreur renvoyée et la session.
  • Distingue l’échec d’une authentification réussie.

Étape 3 · Comment permettre aux utilisateurs de se connecter à votre site

Vérifiez rechargement et déconnexion

Assurez-vous que l’état visible suit la session réelle.

Explications, exemple détaillé et exercices

Comprendre le principe

Rechargez après la connexion réussie et inspectez le compte affiché. Utilisez ensuite Sign out et vérifiez à nouveau l’identité. Pour une session indépendante, prenez un autre profil de navigateur ou fermez toutes les fenêtres privées avant d’en ouvrir une nouvelle : des fenêtres privées supplémentaires peuvent partager la session privée existante.

Le projet fourni affiche l’état du compte ; il ne contient pas de document protégé à tester. Si vous ajoutez du contenu privé, un serveur devra en vérifier l’accès avant de le renvoyer. Masquer un bouton ne suffit pas à cette protection.

Un exemple concret

Une page déconnectée ne doit pas continuer d’agir comme l’ancien compte simplement parce qu’un libellé reste affiché.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quel état du compte est apparu après rechargement, après déconnexion et dans une nouvelle fenêtre privée ?

Afficher une solution détaillée

Exemple de session : « Après rechargement, le compte de test A restait identifié. Sign out a changé l’identité en No signed-in account. Un profil de navigateur distinct n’affichait pas non plus de compte. »

Ce projet montre l’état du compte, pas un document privé. Si la session reste après déconnexion, notez l’échec ; le contrôle d’accès au contenu privé appartient à la leçon private-page.

Éléments d’une réponse solide

  • Consigne l’état du compte après rechargement et après l’action de déconnexion.
  • Vérifie un autre profil ou une session privée nouvellement démarrée au lieu de supposer qu’une autre fenêtre est indépendante.
Comment ça marche (facultatif)

Vérifiez la persistance et la déconnexion

Testez davantage que le premier code réussi.

Après connexion, actualisez et examinez l’état du compte. Déconnectez-vous ensuite et actualisez à nouveau. Utilisez une fenêtre privée pour vérifier qu’un autre navigateur n’hérite pas automatiquement de la session.

La déconnexion efface la session de ce client ; cela ne signifie pas que tous les jetons copiés partout cessent instantanément de fonctionner. La durée de vie et le comportement de révocation des jetons comptent lors de la création de points de terminaison serveur protégés.

Exemple détaillé

Une interface déconnectée ne doit pas conserver l’affichage d’un compte privé ni joindre automatiquement un ancien jeton à une nouvelle requête. Les points d’accès privés nécessitent toujours une vérification serveur.

Exercice technique complémentaire

Masquer le bouton Sign in suffirait-il à protéger un document privé ?

Afficher une solution détaillée

Non. Le serveur doit vérifier l’appelant avant de renvoyer un contenu protégé. La leçon suivante sur les pages privées implémente cette frontière.

  • Distingue l’état de l’interface de l’autorisation serveur.
  • Exige des contrôles d’accès lors de la demande du document.

Étape 4 · Comment permettre aux utilisateurs de se connecter à votre site

Consignez tout le parcours du compte

Terminez par des observations reproductibles, pas seulement une capture de réussite.

Explications, exemple détaillé et exercices

Comprendre le principe

Répétez adresse–courriel–code après correction. Gardez un relevé expurgé de connexion, rechargement, déconnexion et d’une tentative ratée significative.

Si des restrictions d’expéditeur ou limites de compte bloquent le test, nommez précisément l’étape. Ne remplacez pas un vrai code livré par une simulation locale.

Un exemple concret

Un relevé utile distingue courriel absent, code erroné et vérification réussie.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Fournissez les vérifications du parcours du compte et les points encore bloqués.

Travail à rendre: Un bref relevé du parcours couvrant arrivée réelle du code, connexion, rechargement, déconnexion et tentative ratée.

Afficher une solution détaillée

Exemple complet : « La boîte contrôlée a reçu un code ; le mauvais code sans connexion a été refusé ; un nouveau code valide a identifié A ; le rechargement a conservé A ; la déconnexion a effacé l’identité ; un profil de navigateur indépendant n’avait aucune session. »

Exemple incomplet : « La demande de code a échoué à cause des restrictions d’expéditeur. Réception et vérification non testées ; prochaine action : contrôler destinataire autorisé et configuration d’expéditeur. » Un parcours bloqué doit rester incomplet, pas être remplacé par une fausse connexion locale.

Éléments d’une réponse solide

  • Fournit dans l’ordre les observations de demande, mail, mauvais code, code valide, rechargement et déconnexion.
  • Nomme toute étape mail/fournisseur manquante sans inclure de codes ni de jetons de session.
Comment ça marche (facultatif)

Votre devoir : vérifier tout le parcours du compte

Documentez les états de demande, d’échec, de connexion et de déconnexion.

Testez un code incorrect avant de réussir une connexion valide. Vérifiez l’actualisation, la déconnexion et une fenêtre privée. Utilisez uniquement des boîtes que vous contrôlez.

Améliorez un message peu clair sans en changer la vérité : un code demandé est en attente, et une erreur n’est pas une session réussie.

Exemple détaillé

Le rapport doit identifier les états observés sans exposer le code reçu, le jeton bearer ni les informations privées du profil.

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.

Exercice technique complémentaire

Terminez le parcours du compte et expliquez ce que prouve chaque état observé.

Afficher une solution détaillée

Configurez l’URL du projet et la clé publiable, puis un modèle contenant {{ .Token }} pour que le message comporte le code attendu par cette page. Demandez un code pour votre propre boîte. Un e-mail demandé n’est pas une session vérifiée.

Saisissez un mauvais code et confirmez qu’aucune session utilisateur n’est créée. Utilisez un nouveau code valide, vérifiez l’identité affichée, rechargez et observez la session. Déconnectez-vous et vérifiez que l’onglet n’annonce plus de session.

Recommencez dans une fenêtre privée : elle ne doit pas hériter de l’état connecté de la première. Masquer un bouton n’a rien à voir avec la protection d’un document ; le serveur doit vérifier l’autorisation avant de renvoyer un contenu privé.

  • Les cas de code incorrect et de déconnexion restent non authentifiés.
  • Une session valide persiste selon sa configuration, et la déconnexion du client est vérifiée honnêtement.

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

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