Mini-leçon · Français

Comment garder une page privée

Utilisez un projet de connexion prêt à l’emploi pour garder une note d’exercice privée et tester les accès autorisés et refusés.

Commencer le cours interactifLire les notes du cours

À qui s’adresse cette leçon ?

Pour les personnes souhaitant rendre une page ou note accessible seulement après connexion. L’assistant peut connecter la protection fournie ; la programmation serveur n’est pas un objectif requis.

Avant de commencer

La configuration de connexion fournie ou un accès Supabase équivalent, un projet d’hébergement de fonctions distinct et un assistant. Utilisez une PRIVATE_NOTE fictive conservée uniquement dans l’environnement serveur, jamais du vrai contenu privé.

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. Cet exemple autorise tous les utilisateurs valides du projet d’entraînement. Les données individuelles et les rôles demandent des règles d’autorisation supplémentaires.

Ce que vous apprendrez

  • Gardez le contenu privé hors de la page publique.
  • Testez le même accès déconnecté puis connecté.
  • Vérifiez un échec d’accès sans révéler la note.

Fichiers de l’atelier

Étape 1

Choisissez ce qui doit être protégé

Privé signifie inaccessible à un visiteur non autorisé, pas simplement masqué.

Utilisez la note fictive et le projet prêts à l’emploi. Demandez de conserver la note sur le serveur plutôt que dans la page publique téléchargée.

Un visiteur peut examiner les fichiers publics même si un élément est masqué. Ne mettez pas de vraies informations privées dans l’exercice.

Un exemple concret

Un paragraphe dissimulé par le style reste dans le fichier public.

Utilise cet atelier complet de note privée et mon projet de connexion gérée d’exercice. Garde PRIVATE_NOTE uniquement dans l’environnement serveur privé et préserve les contrôles d’accès fournis. Aide-moi à exécuter l’application puis à comparer accès direct déconnecté et connexion vérifiée. Ne considère pas un paragraphe masqué comme protégé et n’expose pas les données d’autrui.

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)

Protégez la réponse, pas seulement le bouton

Le contenu privé ne doit pas être envoyé à un navigateur non autorisé dès le départ.

Masquer par CSS ou désactiver des boutons modifie l’interface, pas la réponse. Tout le monde peut examiner les fichiers publics et envoyer directement une requête à un point de terminaison.

Notre serveur lit une note dans son environnement et la renvoie seulement après avoir vérifié un jeton utilisateur. La note fictive sert à l’atelier ; les vraies données privées doivent être dans une source protégée, pas dans un dépôt public.

Exemple détaillé

Un fichier JavaScript public contenant une note « cachée » reste une copie publique. L’exemple garde plutôt cette valeur hors de public/.

Extra implementation exercise

La page masque un paragraphe jusqu’à la connexion, mais ce paragraphe est dans le HTML source. Est-il privé ?

Afficher une solution détaillée

Non. Contrôlez la réponse serveur avant d’envoyer le contenu. Masquer une valeur reçue ne peut pas la rendre secrète.

  • Reconnaît que le navigateur l’a déjà reçu.
  • Place le contrôle d’accès avant la réponse protégée.

Étape 2

Connectez la protection prête à l’emploi

Laissez l’assistant configurer les contrôles serveur existants.

Suivez run-locally.txt avec l’assistant. Avant de tester, confirmez le projet d’authentification, ses valeurs publiques, les réglages privés serveur et la note fictive PRIVATE_NOTE. Démarrez le projet complet et ouvrez l’URL réelle du proxy ; un simple aperçu de fichier ne peut exécuter sa protection.

Ces contrôles de préparation du compte et du serveur sont obligatoires ; lire le code de la fonction est facultatif. Le service doit vérifier la session avant de renvoyer la note ; saisir l’identifiant d’un autre compte dans une requête ne prouve pas son identité.

Un exemple concret

Une identité fournie par l’utilisateur n’équivaut pas à une session de compte confirmée.

Supabase : récupération d’un utilisateur vérifié · Node.js : état de prise en charge des versions

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)

Envoyez un jeton de session au serveur

Le client fournit un jeton bearer ; le serveur le vérifie indépendamment.

Configurez les fichiers de connexion et l’environnement serveur selon START-HERE.txt. Le client récupère sa session actuelle et envoie son jeton d’accès dans l’en-tête Authorization lorsqu’il demande le contenu privé.

Le serveur appelle le point d’accès utilisateur du fournisseur avec ce jeton et la clé d’application publiable du projet. Il rejette les jetons absents ou invalides et distingue une panne du fournisseur d’une identité acceptée. Décoder un jeton sans le vérifier ne suffit pas.

Suivez la requête dans l’ordre : le navigateur envoie son jeton utilisateur → le serveur demande au fournisseur d’identité si ce jeton représente un utilisateur → seul un résultat vérifié permet de renvoyer la note. La clé publiable identifie l’application ; elle n’identifie ni n’autorise la personne à elle seule.

Pour la séquence locale complète, ouvrez run-locally.txt : préparez l’environnement privé de la racine, liez uniquement le projet d’entraînement et démarrez le proxy de fonctions Netlify. server-env.example.txt liste les noms des variables sans vrais secrets. Ouvrir seulement le HTML ne lance pas le serveur.

Exemple détaillé

Un champ userId fourni par l’appelant ne prouve pas qu’il possède cet ID. Utilisez l’identité renvoyée par la vérification.

const r=await fetch('/.netlify/functions/mini-private-note', {
 headers:{Authorization:'Bearer '+session.access_token}
});

Supabase : récupération d’un utilisateur vérifié · Node.js : état de prise en charge des versions

Extra implementation exercise

Le serveur pourrait-il autoriser une requête en faisant confiance au userId du JSON du navigateur ?

Afficher une solution détaillée

Non. Le navigateur peut changer ce champ. Vérifiez l’identifiant d’accès et utilisez l’identité vérifiée.

  • Traite les déclarations d’identité du client comme non fiables.
  • Utilise un jeton vérifié et l’identité obtenue.

Étape 3

Testez le public autorisé

Décidez qui doit pouvoir lire cet élément précis.

Connectez-vous avec votre compte de test contrôlé et demandez la note fictive. Ici, la règle autorise tout utilisateur dont la connexion est vérifiée ; demandez de préserver cette portée déclarée.

Si vous stockez ensuite les données personnelles d’un compte, cette règle large ne suffit plus. Nommez le public plutôt que de supposer les mêmes permissions pour toutes les données privées.

Un exemple concret

Une note commune aux membres et un enregistrement individuel de compte exigent des décisions d’accès différentes.

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)

Renvoyez uniquement les données protégées prévues

Une identité valide ne donne pas automatiquement accès aux enregistrements de tous les utilisateurs.

Ce petit exemple donne à chaque utilisateur valide du projet l’accès à une note partagée. C’est une règle d’autorisation explicite, pas une définition universelle du contenu privé.

La réponse utilise private, no-store pour qu’un cache partagé ne conserve pas la note. Une leçon ultérieure sur les profils emploie des règles d’appartenance pour les données individuelles. Ne transformez pas ce gestionnaire en export global de la base.

Exemple détaillé

Le viewerId du serveur est dérivé de la vérification. La note vient de son environnement, pas des données de la requête.

Extra implementation exercise

Si la note était remplacée par les données du compte d’un autre utilisateur, « tout utilisateur connecté » resterait-il une règle adaptée ?

Afficher une solution détaillée

Non. Ajoutez une règle liant l’identité authentifiée à l’enregistrement demandé ou au rôle. Une connexion seule ne donne pas accès à un autre compte.

  • Distingue l’authentification de l’autorisation par enregistrement.
  • Exige l’appartenance ou un rôle adapté pour les données individuelles.

Étape 4

Essayez le même accès déconnecté

Une requête directe compte autant que le bouton normal.

Utilisez un profil réellement déconnecté, ou déconnectez-vous et vérifiez l’état du compte, puis demandez la même note directement avec l’assistant. Une fenêtre privée supplémentaire peut partager une session privée existante. Répétez avec une connexion vérifiée.

Le résultat déconnecté ne doit pas contenir la note ; la session autorisée doit la recevoir. Une requête ratée doit rester une erreur sans fuite de contenu.

Un exemple concret

Retirer un lien du menu ne protège pas l’adresse qu’il ouvrait.

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)

Essayez le point d’accès sans l’interface

Un vrai test d’accès vise directement la requête de données.

Demandez l’URL de la fonction dans une nouvelle fenêtre sans en-tête Authorization ; elle ne doit pas renvoyer la note. Essayez un jeton bearer mal formé, puis utilisez l’interface connectée pour envoyer une requête autorisée.

Déconnectez-vous et vérifiez que l’application efface la note affichée et n’envoie plus de jeton. Un jeton déjà émis peut rester valide jusqu’à l’expiration configurée ; la révocation globale immédiate est une exigence distincte.

Exemple détaillé

Une requête directe refusée démontre davantage qu’une capture de bouton de connexion. Conservez le statut de réponse et la présence ou non du texte protégé dans votre relevé.

Extra implementation exercise

Une requête directe renvoie 401 sans note, tandis qu’une session vérifiée reçoit la note. Quelle frontière avez-vous testée ?

Afficher une solution détaillée

Vous avez testé que ce point d’accès vérifie l’identité avant de renvoyer la note partagée. Les autres points d’accès et règles d’appartenance demandent leurs propres tests.

  • Identifie la frontière de la réponse serveur.
  • Ne revendique pas de révocation universelle ni d’autorisation individuelle au-delà de l’exemple.

Étape 5

Protégez une autre valeur de test

Répétez les mêmes contrôles après une petite modification.

Demandez d’ajouter une seconde valeur fictive réservée au serveur avec la même règle de public. Ne déplacez aucune des deux dans les fichiers publics par commodité.

Répétez les observations d’autorisation, de refus et d’erreur. Expurgez la transmission et signalez tout test non exécuté.

Un exemple concret

Ajouter un champ ne doit pas rendre publique par accident la note privée d’origine.

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 : ajouter une deuxième valeur protégée

Gardez cette valeur hors des fichiers publics et appliquez les mêmes vérifications serveur.

Ajoutez une autre valeur d’entraînement dans l’environnement du serveur, ne la renvoyez qu’après vérification et affichez-la en toute sécurité sous forme de texte. Conservez une réponse qui ne peut pas être mise en cache.

Répétez les tests sans jeton, avec jeton invalide et avec session valide. Recherchez dans les sources publiques pour confirmer qu’aucune des deux valeurs privées n’y est intégrée.

Exemple détaillé

Le devoir étend la réponse protégée, pas la quantité de données envoyées avant connexion.

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

Protégez une deuxième valeur et fournissez des preuves d’accès positives et négatives.

Afficher une solution détaillée

Appelez directement private-note sans en-tête Authorization : attendez 401 et aucune note. Un jeton bearer inventé doit aussi échouer. Le userId du navigateur ou un bouton caché ne satisfait pas au contrôle d’identité du serveur.

Avec votre véritable jeton de session vérifié dans votre propre projet d’entraînement, attendez la note configurée et Cache-Control: private, no-store. Gardez la note hors du HTML et du JavaScript publics. Ne collez pas de vrai jeton bearer dans un rapport partagé.

Après déconnexion, l’interface doit effacer le contenu privé et arrêter les requêtes authentifiées. Un jeton déjà copié peut rester utilisable jusqu’à expiration : le comportement de déconnexion de l’interface ne garantit pas une révocation instantanée. Cet atelier de note partagée autorise les utilisateurs connectés ; l’appartenance individuelle est l’exercice séparé du profil.

  • Les deux valeurs restent côté serveur jusqu’à autorisation réussie.
  • Les requêtes directes non autorisées ne contiennent aucune valeur ; l’accès valide et le comportement no-store sont vérifiés.

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