
Mini-leçon · Français
Comment permettre aux utilisateurs de se connecter à votre site
Connectez la page de connexion prête à un service de comptes géré et testez codes par courriel, déconnexion et tentatives ratées.
À 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.
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.
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.
Ce que vous apprendrez
- 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.
Étape 1
Comprenez le parcours de connexion
Recevoir un code et être connecté sont deux moments distincts.
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é.Supabase : codes de connexion par e-mail · Supabase : types de clés d’API
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)
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
Extra implementation exercise
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.
Erreur fréquente
Considérer un champ e-mail ou un nom d’affichage stocké comme une preuve d’identité.
Étape 2
Préparez le fournisseur et la page
Choisissez le parcours par code attendu par le formulaire.
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.
À vous de jouer
La configuration et le message reçu correspondaient-ils au formulaire par code ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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)
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.
Extra implementation exercise
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é.
Erreur fréquente
Utiliser une clé serveur privilégiée parce qu’elle semble faire réussir davantage de requêtes.
Étape 3
Terminez une vraie connexion
Utilisez le courriel plutôt qu’un code inventé.
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.
À 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 ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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)
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 */ }Extra implementation exercise
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.
Erreur fréquente
Réutiliser un message de réussite d’une ancienne requête après une vérification échouée.
Étape 4
Vérifiez rechargement et déconnexion
Assurez-vous que l’état visible suit la session réelle.
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é.
À vous de jouer
Quel état du compte est apparu après rechargement, après déconnexion et dans une nouvelle fenêtre privée ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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 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.
Extra implementation exercise
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.
Erreur fréquente
Supposer que les règles de visibilité côté client sécurisent les données sous-jacentes.
Étape 5
Consignez tout le parcours du compte
Terminez par des observations reproductibles, pas seulement une capture de réussite.
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.
À 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 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.
Discutez de votre réponse avec le tuteur
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.
- 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.
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)
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.
Extra implementation exercise
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.
Erreur fréquente
Remettre une capture contenant un jeton de session réutilisable.
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 garder une page privée
- Comment permettre aux utilisateurs de modifier leur profil
- Comment permettre aux utilisateurs de téléverser des images
- 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