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.

Commencer le cours interactifLire les notes du cours

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

Fichiers de l’atelier

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

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

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é.

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

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.

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

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.

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

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.

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