
Mini-leçon 15 sur 30 · Comptes et accès
Sachez quelle valeur doit rester privée
À qui s’adresse cette leçon ?
Pour les personnes connectant un site à une IA ou autre service privilégié. L’assistant peut relier le projet prêt ; vous devez comprendre où utiliser le secret, sans écrire de code serveur.
Le navigateur doit utiliser votre fonction sans recevoir le secret fournisseur.
Objectif de cette leçon
- Placez le secret fournisseur uniquement dans l’environnement serveur privé.
- Exécutez l’action fournie sans exposer la clé aux visiteurs.
- Vérifiez les tentatives d’accès réussies et rejetées.
Explications, exemple détaillé et exercices
Avant de commencer
Votre propre accès API Google AI Studio et un projet distinct de fonctions Netlify sont nécessaires. Utilisez l’atelier complet et un assistant pour l’environnement privé. Confirmez les limites du modèle et du compte, y compris les frais possibles, avant les requêtes. Le laboratoire utilise un code distinct détenu par le propriétaire ; ce n’est pas un service d’IA public prêt à l’emploi.
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.
- 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 configuration fournisseur et compte peut prendre davantage de temps. L’usage dépend des conditions et du quota actuels de votre compte.
Comprendre le principe
Ouvrez le projet avec l’assistant. Identifiez la clé fournisseur comme valeur privée du compte et le code d’exercice distinct comme contrôle d’accès du propriétaire pour ce petit laboratoire.
Le nom .env ne suffit pas si la compilation copie sa valeur dans des scripts publics. Demandez d’examiner les véritables fichiers destinés au visiteur.
Un exemple concret
Un champ de formulaire masqué appartient toujours au navigateur et ne peut pas cacher une clé fournisseur.
Ouvre cet atelier prêt sur les clés API et guide la configuration run-locally.txt. Garde clé fournisseur et choix du modèle sur le serveur et utilise un code d’accès d’exercice distinct. Ne place aucun secret dans les fichiers publics et ne me demande pas de les coller dans des messages partagés. Aide-moi à examiner ce que reçoit le navigateur et à tester requêtes autorisées et rejetées. Explique les preuves observables plutôt que de m’imposer d’implémenter le point d’accès.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
Quelle valeur doit rester hors de la page du visiteur et quelles preuves demanderez-vous à l’assistant d’examiner ?
Afficher une solution détaillée
Exemple de confidentialité : « GEMINI_API_KEY est l’identifiant privé du fournisseur. LAB_TOKEN est un code d’exercice distinct, pas un autre nom pour cette clé. L’assistant inspectera les scripts publics livrés et les requêtes du navigateur pour repérer une exposition accidentelle. »
Un nom de fichier privé ne suffit pas : une compilation peut encore copier son contenu dans la sortie publique. Je garderai les valeurs réelles hors des captures et notes partagées.
Éléments d’une réponse solide
- Identifie la clé fournisseur comme secrète et le code d’exercice comme une limite d’accès distincte.
- Nomme fichiers publics et requêtes du navigateur comme éléments à inspecter pour détecter une exposition accidentelle.
Comment ça marche (facultatif)
Gardez les clés privilégiées hors du code navigateur
Le navigateur du visiteur peut examiner tous les fichiers que vous lui envoyez.
Un secret fournisseur peut autoriser des dépenses ou des opérations privilégiées. Le placer dans du JavaScript public, un champ masqué ou une variable substituée lors de la compilation du frontend l’envoie toujours au navigateur.
L’exemple pose à Gemini une question pédagogique fixe via votre fonction serveur. Le navigateur reçoit la réponse ; la clé reste dans l’environnement serveur. Toutes les clés ne sont pas secrètes : les clés publiables Supabase sont conçues pour le navigateur avec des politiques d’accès, contrairement aux clés secrètes.
Exemple détaillé
Ouvrez insecure-example.txt. La valeur factice est visible, car elle fait partie du code livré. Minifier la même ligne réduit sa lisibilité, pas le nombre de personnes qui la reçoivent.
Exercice technique complémentaire
Une clé est stockée dans .env puis insérée dans le JavaScript public à la compilation. Est-elle privée vis-à-vis des visiteurs ?
Afficher une solution détaillée
Non. Son emplacement initial n’importe plus une fois insérée dans un paquet public. Déplacez l’opération privilégiée vers une fonction serveur et gardez-y la valeur.
- Suit la clé jusque dans le paquet livré.
- Distingue l’environnement serveur de la substitution frontend.

Étape 1 · Comment garder les clés d’API hors de votre interface web
Démarrez l’action protégée fournie
Laissez l’assistant configurer le parcours serveur existant.
Explications, exemple détaillé et exercices
Comprendre le principe
Suivez run-locally.txt et server-env.example.txt avec l’assistant. Confirmez compte, modèle et conditions, définissez la clé en privé sur le serveur et générez un code d’exercice distinct. Lancez le projet complet et ouvrez son URL locale. Ces contrôles sont obligatoires ; écrire la fonction est facultatif.
Le navigateur doit appeler votre fonction serveur, qui appelle le fournisseur en privé. En cas d’échec de configuration, d’accès ou de quota, signalez l’étape au lieu d’inventer une réponse.
Un exemple concret
Le code d’exercice du formulaire n’est pas la clé du fournisseur Google.
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
L’action a-t-elle fonctionné et quelle étape privée ou fournisseur reste bloquée ?
Afficher une solution détaillée
Exemple de préparation : « Le projet complet s’est ouvert à l’URL du proxy. Avec le code d’exercice, l’action serveur a renvoyé une brève explication du rôle d’un serveur web. Les identifiants du fournisseur et le choix du modèle sont restés dans l’environnement privé. »
Exemple de blocage : « L’application fonctionne, mais le fournisseur signale un quota indisponible ; aucune réponse réussie n’a été observée. » Vérifiez modèles autorisés, limites et frais possibles avant de répéter ; la leçon ne promet pas d’appels gratuits ou illimités.
Éléments d’une réponse solide
- Consigne l’adresse locale réelle et une action autorisée ou le blocage précis de configuration/fournisseur.
- Garde clé et modèle sur le serveur et vérifie les conditions du compte avant l’appel.
Comment ça marche (facultatif)
Placez l’appel fournisseur derrière votre point d’accès
Configurez le serveur, puis envoyez seulement la petite requête nécessaire.
Lisez netlify/functions/mini-explain.mjs, déployez le projet séparé et définissez GEMINI_API_KEY, GEMINI_MODEL et LAB_TOKEN côté serveur. Choisissez un modèle texte pris en charge dans votre compte au lieu de copier un ancien nom de tutoriel.
Saisissez le code d’entraînement indépendant dans le formulaire. Le navigateur appelle /.netlify/functions/mini-explain ; cette fonction appelle l’adresse HTTPS fixe de Google avec x-goog-api-key. Le code réserve l’atelier au propriétaire ; ce n’est ni l’identifiant Gemini ni un système complet de quotas publics.
GEMINI_MODEL est l’ID exact disponible dans votre compte API, pas un libellé de capture. generate est une fonction auxiliaire du même fichier serveur. Ni la clé ni cette fonction n’ont leur place dans public/. Une requête valide peut encore échouer si le fournisseur manque de quota ou est indisponible.
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.
Utilisez le guide actuel ci-dessous ou lancez list-text-models.mjs depuis la racine privée avec votre environnement. Il liste les candidats generateContent visibles du compte sans afficher la clé. Choisissez un modèle texte pris en charge, vérifiez conditions et quota, puis copiez son ID API exact dans GEMINI_MODEL côté serveur.
Avant la première requête de fonction, lancez la liste des modèles et choisissez un modèle texte actuel acceptant les champs generateContent utilisés ici, dont systemInstruction. La liste identifie des candidats, pas leur quota ni toutes leurs capacités. Tout netlify/functions/mini-explain.mjs s’exécute au serveur ; public/app.js est livré à chaque visiteur. Vérifiez aussi le délai maximal de fonction de l’hébergeur : les 20 secondes côté fournisseur ne prolongent pas une limite d’hébergement plus courte.
Exemple détaillé
L’instruction fournisseur est fixe sur le serveur : l’appelant ne peut pas transformer cette route en instructions arbitrairement longues. La fonction limite aussi la sortie et attend au plus 20 secondes sa requête fournisseur.
Gemini : API generateContent · Gemini : clés d’API · Gemini : ID et capacités actuels des modèles · Node.js : état de prise en charge des versions
Exercice technique complémentaire
Quelles deux requêtes doivent exister et laquelle doit être absente de Network dans le navigateur ?
Afficher une solution détaillée
Le navigateur montre son appel à votre fonction et la réponse. Le serveur appelle le fournisseur ; sa requête Google contenant l’identifiant ne doit pas apparaître comme requête navigateur.
- Voit la requête navigateur vers la fonction du même site.
- Garde la requête Google authentifiée sur le serveur.

Étape 2 · Comment garder les clés d’API hors de votre interface web
Vérifiez ensemble confidentialité et échec
Une réponse utile n’excuse pas une clé exposée.
Explications, exemple détaillé et exercices
Comprendre le principe
Demandez de rechercher le secret dans les fichiers publics livrés et les requêtes du navigateur sans l’afficher dans les journaux partagés. Essayez un mauvais code d’exercice et une configuration manquante dans le projet jetable.
La vraie clé ne doit apparaître ni dans les fichiers ni dans les requêtes du navigateur. Les requêtes rejetées ou indisponibles doivent rester des échecs avec un parcours de réessai utilisable.
Un exemple concret
Une réponse convaincante avec une clé exposée dans app.js reste un travail inachevé.
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
Qu’ont réellement montré le contrôle des sorties publiques et la tentative rejetée ?
Afficher une solution détaillée
Exemple confidentialité/erreur : « L’assistant a inspecté la sortie publique et la requête du navigateur vers mon serveur ; aucune clé fournisseur n’y figurait. Un code erroné a été refusé. Sans configuration privée fournisseur dans le projet jetable, l’action a échoué au lieu d’afficher une explication inventée. »
Cela décrit la limite inspectée, pas un audit de sécurité complet. Si une clé apparaît dans la sortie publique, cessez de partager cette version et remplacez l’identifiant exposé auprès du fournisseur avant de le réutiliser.
Éléments d’une réponse solide
- Indique quelles sorties et requêtes publiques ont été inspectées sans reproduire le secret.
- Consigne comme échecs un accès refusé et une configuration indisponible.
Comment ça marche (facultatif)
Vérifiez la frontière et la réponse
Une réponse réussie ne prouve pas à elle seule que la clé est restée privée.
Cherchez la vraie clé dans le HTML et les scripts publics déployés sans la coller dans des captures ou journaux partagés. Examinez les requêtes : le code de pratique peut être visible du propriétaire, mais pas la clé Gemini.
Testez un mauvais code et une configuration fournisseur manquante dans le projet jetable. Un échec doit rester un échec. Un 429 peut indiquer des limites de quota ou de débit ; 401 ou 403 des problèmes d’accès ou de configuration. Ne les transformez pas tous en réponse d’IA fabriquée.
Exemple détaillé
Un bon code et des réglages valides doivent renvoyer une vraie réponse. Le même point d’accès avec un mauvais code doit refuser avant toute requête fournisseur.
Exercice technique complémentaire
La réponse fonctionne, mais la clé figure aussi dans public/app.js. La tâche est-elle terminée ?
Afficher une solution détaillée
Non. Retirez la clé des fichiers publics, renouvelez-la puisqu’elle a été exposée, actualisez le réglage serveur et vérifiez le nouveau déploiement et l’historique pour toute exposition restante.
- Refuse une sortie réussie comme preuve suffisante.
- Supprime la fuite et renouvelle la clé exposée.

Étape 3 · Comment garder les clés d’API hors de votre interface web
Effectuez sûrement une modification limitée
Conservez la même frontière de secret en modifiant la fonction.
Explications, exemple détaillé et exercices
Comprendre le principe
Demandez d’adapter l’opération fixe fournie pour expliquer brièvement le DNS. Préservez les paramètres de modèle/clé côté serveur et l’exercice réservé au propriétaire.
Retestez la réponse voulue et un code invalide. Avant usage public, décidez d’une vraie authentification, de contrôles d’usage durables et d’un suivi du budget fournisseur.
Un exemple concret
Changer le sujet de réponse ne doit pas déplacer des valeurs privées dans la page.
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.
- netlify/functions/mini-explain.mjsTélécharger ce fichier
- verification.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/netlify/functions/mini-explain.mjsTélécharger ce fichier
À vous de jouer
Fournissez l’action modifiée et les contrôles confidentialité/valide/invalide réellement exécutés.
Travail à rendre: Un relevé expurgé de la frontière de clé et des requêtes valides/invalides pour l’action fournie.
Afficher une solution détaillée
Exemple de modification : « L’opération fixe explique maintenant le DNS en deux phrases. Un appel autorisé a renvoyé ce sujet ; un mauvais code a été refusé ; l’inspection publique ne trouvait toujours aucune clé fournisseur. »
« Avant de l’ouvrir à des inconnus, il me faut encore une véritable authentification, des limites durables et un suivi du budget fournisseur. » Le code partagé est une petite limite de laboratoire, pas la preuve d’un service public complet.
Éléments d’une réponse solide
- Change le sujet fixe en DNS tout en gardant clé et modèle exclusivement côté serveur.
- Reteste appels autorisés et refusés et nomme les contrôles d’accès/coût encore nécessaires avant ouverture publique.
Comment ça marche (facultatif)
Votre devoir : déplacer une deuxième opération fixe
En changeant l’opération, conservez délibérément les mêmes limites d’accès et d’exécution, sans les élargir par accident.
Modifiez l’instruction fixe du serveur pour expliquer le DNS en deux phrases. Gardez identifiants, choix du modèle et limite de sortie au serveur ; le navigateur ne doit toujours pas connaître la clé.
Consignez le résultat avec des codes valides et invalides. Expliquez les ajouts nécessaires avant un accès public : utilisateurs authentifiés ou autre frontière pertinente, limites d’usage durables et surveillance du budget fournisseur.
Exemple détaillé
Changer une instruction fixe prouve que vous savez où le comportement fournisseur est contrôlé. Accepter du navigateur des modèles, points d’accès ou limites arbitraires annulerait ce contrôle.
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
Produisez la version DNS et un court relevé de test de la frontière.
Afficher une solution détaillée
Dans mini-explain, exclusivement serveur, remplacez la question fixe sur le serveur web par 'Explain DNS in two sentences for a beginner.' (expliquer le DNS en deux phrases pour débutant). Gardez clé et modèle dans les variables serveur ; la fonction de référence complète montre la modification exacte.
Examinez les scripts livrés et les requêtes Network. Le navigateur appelle votre fonction ; il ne doit pas envoyer GEMINI_API_KEY lui-même à Google. Le code d’atelier saisi par le propriétaire est distinct de la clé fournisseur.
Essayez un mauvais code : attendez un rejet avant tout appel fournisseur. Une erreur de quota ou de réseau doit rester un échec honnête, pas une réponse de réussite préfabriquée. Si un vrai secret a été exposé, retirez-le et renouvelez-le ; ignorer ensuite le fichier ne révoque pas l’exposition.
- Aucun secret fournisseur n’est livré au navigateur.
- Un accès incorrect est rejeté et les échecs fournisseur sont affichés 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.