
Mini-leçon · Français
Comment garder les clés d’API hors de votre interface web
Utilisez l’exemple serveur fourni pour garder une clé fournisseur hors du navigateur du visiteur et vérifier requêtes autorisées et rejetées.
À 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.
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.
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.
Ce que vous apprendrez
- 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.
Étape 1
Sachez quelle valeur doit rester privée
Le navigateur doit utiliser votre fonction sans recevoir le secret fournisseur.
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
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)
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.
Extra implementation exercise
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.
Erreur fréquente
Considérer toute variable nommée SECRET comme privée, quelle que soit sa destination.
Étape 2
Démarrez l’action protégée fournie
Laissez l’assistant configurer le parcours serveur existant.
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.
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
À vous de jouer
L’action a-t-elle fonctionné et quelle étape privée ou fournisseur reste bloquée ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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)
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
Extra implementation exercise
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.
Erreur fréquente
Copier la fonction auxiliaire serveur dans public/ pour corriger un chemin.
Étape 3
Vérifiez ensemble confidentialité et échec
Une réponse utile n’excuse pas une clé exposée.
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é.
À vous de jouer
Qu’ont réellement montré le contrôle des sorties publiques et la tentative rejetée ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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 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.
Extra implementation exercise
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.
Erreur fréquente
Masquer une valeur divulguée dans l’interface tout en la laissant dans un script téléchargeable.
Étape 4
Effectuez sûrement une modification limitée
Conservez la même frontière de secret en modifiant la fonction.
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.
À 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 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.
Discutez de votre réponse avec le tuteur
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.
- 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.
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.
- 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
How it works (optional)
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.
Extra implementation exercise
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.
Erreur fréquente
Présenter l’atelier restreint comme un service public d’IA prêt pour la production.
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 permettre aux utilisateurs de se connecter à votre site
- 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 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