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.

Commencer le cours interactifLire les notes du cours

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

Fichiers de l’atelier

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

É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

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.

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

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.

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

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

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