
Mini-Lektion · Deutsch
So hältst du API-Schlüssel aus deinem Frontend heraus
Nutze ein bereitgestelltes servergestütztes Beispiel, um einen Anbieterschlüssel aus dem Besucherbrowser herauszuhalten, und prüfe erlaubte und abgewiesene Anfragen.
Für wen ist das gedacht?
Für alle, die eine Website mit einem KI-Dienst oder einem anderen privilegierten Dienst verbinden. Ein Programmierassistent kann das fertige Projekt anbinden; du sollst verstehen, wo dein Geheimnis verwendet werden darf, und musst keinen Servercode schreiben.
Bevor du beginnst
Du brauchst eigenen Google-AI-Studio-API-Zugang und ein separates Netlify-Functions-Übungsprojekt. Nutze einen Programmierassistenten mit dem vollständigen Übungspaket und privater Umgebungseinrichtung. Prüfe vor Anfragen die Modell- und Kontolimits einschließlich möglicher Gebühren. Das Labor verwendet einen separaten Übungscode des Eigentümers und ist kein fertiger öffentlicher KI-Dienst.
Geschätzte Dauer: 20–32 Min.
Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Die Einrichtung von Anbieter und Konto kann länger dauern. Die Nutzung unterliegt den aktuellen Bedingungen und Kontingenten deines Kontos.
Was du lernen wirst
- Hinterlege das Anbieter-Geheimnis nur in der privaten Serverumgebung.
- Führe die bereitgestellte Aktion aus, ohne den Schlüssel Besuchern offenzulegen.
- Prüfe erfolgreiche und abgewiesene Zugriffsversuche.
Schritt 1
Kläre, welcher Wert privat bleiben muss
Der Browser soll deine Funktion nutzen, ohne das Anbieter-Geheimnis zu erhalten.
Öffne das bereitgestellte Projekt mit deinem Assistenten. Bestimme den Anbieterschlüssel als privaten Kontowert und den separaten Übungscode als Zugriffskontrolle des Eigentümers für dieses kleine Übungslabor.
Der Dateiname .env reicht nicht aus, wenn ein Build den Wert in öffentliche Skripte kopiert. Bitte den Assistenten, die tatsächlich an Besucher ausgelieferten Dateien zu prüfen.
Ein konkretes Beispiel
Ein verstecktes Formularfeld gehört weiterhin zum Browser und kann keinen Anbieterschlüssel verbergen.
Öffne diesen fertigen API-Schlüssel-Workshop und führe durch die Einrichtung in run-locally.txt. Halte Anbieterschlüssel und Modellauswahl auf dem Server und nutze einen separaten Übungszugriffscode. Hinterlege keine Geheimnisse in öffentlichen Dateien und bitte mich nicht, sie in geteilte Nachrichten einzufügen. Hilf zu prüfen, was der Browser erhält, und teste erlaubte sowie abgewiesene Anfragen. Erkläre die beobachtbaren Nachweise, statt von mir die Umsetzung des Endpunkts zu verlangen.Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Halte privilegierte API-Schlüssel aus dem Browsercode heraus
Der Browser des Besuchers kann jede an ihn gesendete Datei untersuchen.
Ein Anbieter-Geheimnis kann Ausgaben oder privilegierte Aktionen erlauben. Es in öffentliches JavaScript, ein verstecktes Feld oder eine beim Frontend-Build eingesetzte Umgebungsvariable zu schreiben sendet es weiterhin an den Browser.
Das Beispiel stellt Gemini über deine Serverfunktion eine feste Lernfrage. Der Browser erhält die Antwort; der Anbieterschlüssel bleibt in der Serverumgebung. Nicht jeder Schlüssel ist geheim: Veröffentlichbare Supabase-Schlüssel sind für Browsernutzung mit Zugriffsrichtlinien gedacht, geheime Schlüssel dagegen nicht.
Ausgearbeitetes Beispiel
Öffne insecure-example.txt. Der erfundene Wert ist sichtbar, weil er im ausgelieferten Code steht. Minifizierung derselben Zeile würde sie schwerer lesbar machen, aber nicht ändern, wer sie erhält.
Extra implementation exercise
Ein Schlüssel wird in .env gespeichert und beim Build ins öffentliche JavaScript-Bundle eingefügt. Ist er vor Besuchern geschützt?
Ausgearbeitete Lösung anzeigen
Nein. Sein ursprünglicher Dateispeicherort spielt keine Rolle mehr, nachdem er ins öffentliche Bundle eingefügt wurde. Verlege die privilegierte Aktion in eine Serverfunktion und halte den Wert dort.
- Verfolgt den Schlüssel bis ins ausgelieferte Bundle.
- Unterscheidet Serverumgebung von Frontend-Ersetzung.
Häufiger Fehler
Jede SECRET genannte Variable unabhängig von ihrer Auslieferung als privat behandeln.
Schritt 2
Starte die bereitgestellte geschützte Aktion
Lass den Assistenten den vorhandenen Serverweg einrichten.
Folge run-locally.txt und server-env.example.txt mit deinem Assistenten. Bestätige Konto, Modell und Nutzungsbedingungen, richte den Anbieterschlüssel privat auf dem Server ein und erzeuge einen separaten Übungscode. Starte das vollständige Projekt und öffne die lokale App-URL. Diese Einrichtung ist erforderlich; den Funktionscode zu schreiben ist optional.
Der Browser soll mit deiner Serverfunktion kommunizieren, während der Server den Anbieter privat aufruft. Schlagen Einrichtung, Zugriff oder Kontingent fehl, melde diese Stufe, statt eine Antwort zu erfinden.
Ein konkretes Beispiel
Der Übungscode des Formulars ist nicht der Google-Anbieterschlüssel.
Gemini generateContent API · Gemini-API-Schlüssel · Gemini: aktuelle Modell-IDs und Fähigkeiten · Node.js: Status unterstützter Veröffentlichungen
Selbst ausprobieren
Lief die Aktion, und welche private Einrichtungs- oder Anbieterstufe ist noch blockiert?
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Veranschaulichendes Bereitschaftsergebnis: „Das vollständige Projekt öffnete unter der lokalen Proxy-URL. Mit dem Übungszugangscode lieferte seine Serveraktion eine kurze Erklärung eines Websiteservers. Anbieterzugang und Modellauswahl blieben in der privaten Umgebung.“
Ein blockiertes Beispiel lautet: „Die App läuft, aber der Anbieter meldet fehlendes Kontingent; eine erfolgreiche Antwort wurde nicht beobachtet.“ Prüfe erlaubte Modelle, Limits und mögliche Gebühren, bevor du Anfragen wiederholst. Diese Lektion verspricht keine kostenlosen oder unbegrenzten Aufrufe.
- Dokumentiert die tatsächliche lokale App-Adresse und eine erlaubte Aktion oder ein genaues Konfigurations- beziehungsweise Anbieterhindernis.
- Hält Anbieterzugang und Modell auf dem Server und prüft vor dem Aufruf die Kontonutzungsbedingungen.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-explain.mjsDiese Datei herunterladen
- public/app.jsDiese Datei herunterladen
- START-HERE.txtDiese Datei herunterladen
- run-locally.txtDiese Datei herunterladen
- server-env.example.txtDiese Datei herunterladen
- list-text-models.mjsDiese Datei herunterladen
- package.jsonDiese Datei herunterladen
How it works (optional)
Lege den Anbieteraufruf hinter deinen eigenen Endpunkt
Konfiguriere den Server und sende dann nur die kleine Anfrage, die die Funktion benötigt.
Lies netlify/functions/mini-explain.mjs, veröffentliche das separate Projekt und setze dort serverseitig GEMINI_API_KEY, GEMINI_MODEL und LAB_TOKEN. Wähle ein unterstütztes Textmodell deines Kontos, statt einen alten Modellnamen aus einem Tutorial zu kopieren.
Gib den unabhängigen Übungscode ins Formular ein. Der Browser ruft /.netlify/functions/mini-explain auf; die Funktion ruft Googles festen HTTPS-Endpunkt mit x-goog-api-key auf. Der Code ist eine Eigentümerbeschränkung der Übung, nicht der Gemini-Zugangsschlüssel und kein vollständiges öffentliches Kontingentsystem.
GEMINI_MODEL ist die genaue für dein eigenes API-Konto verfügbare Modell-ID und kein Anzeigename aus einem Screenshot. generate ist eine Hilfsfunktion in derselben Serverfunktionsdatei. Weder Anbieterschlüssel noch Hilfsfunktion gehören in public/. Auch eine gültige Anfrage kann an fehlendem Kontingent oder Anbieterausfall scheitern.
Öffne für die vollständige lokale Reihenfolge run-locally.txt: Bereite die private Umgebung im Stamm vor, verknüpfe ausschließlich das Übungsprojekt und starte den Netlify-Funktionsproxy. server-env.example.txt führt Variablennamen ohne echte Geheimnisse auf. Nur das HTML zu öffnen kann den Server nicht ausführen.
Nutze die aktuelle Modellanleitung unten oder führe list-text-models.mjs mit deiner eigenen Umgebung im privaten Workshop-Stamm aus. Es listet für das Konto sichtbare generateContent-Kandidaten auf, ohne den Schlüssel auszugeben. Wähle ein unterstütztes Textmodell, prüfe Bedingungen und Kontingent und trage seine genaue API-ID serverseitig als GEMINI_MODEL ein.
Führe vor der ersten Funktionsanfrage den Modelllisten-Helfer aus und wähle ein aktuelles Textmodell, das die hier verwendeten generateContent-Anfragefelder einschließlich systemInstruction unterstützt. Die Liste benennt Kandidaten, aber weder Kontingent noch jede Modellfähigkeit. Die gesamte Datei netlify/functions/mini-explain.mjs läuft auf dem Server; public/app.js wird jedem Besucher ausgeliefert. Prüfe auch das Funktionszeitlimit des Hostingtarifs: Die 20-Sekunden-Frist des Anbieters verlängert kein kürzeres Hostlimit.
Ausgearbeitetes Beispiel
Der Anbieter-Prompt steht fest auf dem Server; ein Aufrufer kann diesen Weg daher nicht für beliebig große Prompts verwenden. Die Funktion begrenzt außerdem die Ausgabe und wartet höchstens 20 Sekunden auf die Anbieteranfrage.
Gemini generateContent API · Gemini-API-Schlüssel · Gemini: aktuelle Modell-IDs und Fähigkeiten · Node.js: Status unterstützter Veröffentlichungen
Extra implementation exercise
Welche zwei Anfragen gehören zum Ablauf, und welche darf nicht in den Network-Werkzeugen des Browsers erscheinen?
Ausgearbeitete Lösung anzeigen
Der Browser zeigt seinen Aufruf deiner Funktion und die zurückgegebene Antwort. Der Server stellt die Anbieteranfrage; sein Google-Aufruf mit Zugangsdaten darf nicht als Browseranfrage erscheinen.
- Sieht die Browseranfrage an die Funktion der eigenen Website.
- Hält die authentifizierte Google-Anfrage auf dem Server.
Häufiger Fehler
Den Serverhelfer nach public/ kopieren, um einen Pfadfehler zu reparieren.
Schritt 3
Prüfe Datenschutz und Fehlerfälle gemeinsam
Eine nützliche Antwort entschuldigt keinen offengelegten Schlüssel.
Bitte den Assistenten, ausgelieferte öffentliche Dateien und Browseranfragen auf das Anbieter-Geheimnis zu prüfen, ohne es in geteilten Protokollen anzuzeigen. Probiere im entbehrlichen Projekt einen falschen Übungscode und einen Fall mit fehlender Konfiguration aus.
Der tatsächliche Schlüssel darf nicht in Browserdateien oder -anfragen erscheinen. Abgewiesene oder nicht verfügbare Anfragen müssen Fehler bleiben und einen nutzbaren Wiederholungsweg bieten.
Ein konkretes Beispiel
Eine überzeugende Antwort mit einem in app.js offengelegten Schlüssel ist weiterhin eine unvollständige Aufgabe.
Selbst ausprobieren
Was zeigten die Prüfung öffentlicher Ausgaben und der abgewiesene Versuch tatsächlich?
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Veranschaulichendes Datenschutz- und Fehlerprotokoll: „Der Assistent prüfte die öffentliche Ausgabe und die Browseranfrage an meinen eigenen Server; der Anbieterschlüssel fehlte darin. Ein falscher Übungscode wurde abgelehnt. Als die private Anbieterkonfiguration im wegwerfbaren Aufbau entfernt war, scheiterte die Aktion, statt eine erfundene Erklärung anzuzeigen.“
Dies dokumentiert die geprüfte Grenze, keine vollständige Sicherheitsprüfung. Wird ein Schlüssel in der öffentlichen Ausgabe gefunden, teile diesen Build nicht weiter und ersetze den offengelegten Zugang beim Anbieter, bevor du ihn wieder verwendest.
- Benennt die geprüften öffentlichen Ausgaben und Anfragen, ohne das Anbietergeheimnis wiederzugeben.
- Dokumentiert einen abgelehnten Zugangsversuch und einen Versuch mit fehlender Konfiguration als Fehler.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Prüfe Grenze und Antwort
Eine erfolgreiche Antwort allein beweist nicht, dass der Schlüssel privat blieb.
Durchsuche das veröffentlichte öffentliche HTML und die Skripte nach dem tatsächlichen Anbieterschlüssel, ohne ihn in Screenshots oder geteilte Protokolle einzufügen. Untersuche Browseranfragen: Der Übungscode kann für seinen Eigentümer sichtbar sein, der Gemini-Schlüssel darf es nicht sein.
Teste einen falschen Übungscode und fehlende Anbieterkonfiguration im entbehrlichen Projekt. Ein Fehler muss ein Fehler bleiben. Anbieterstatus 429 kann Kontingent- oder Ratenlimits bedeuten; 401 oder 403 können auf Zugriffs- oder Konfigurationsprobleme hinweisen. Verwandle sie nicht alle in eine erfundene KI-Antwort.
Ausgearbeitetes Beispiel
Ein korrekter Übungscode mit gültigen Anbietereinstellungen sollte eine echte Antwort liefern. Derselbe Endpunkt mit falschem Code sollte vor jeder Anbieteranfrage ablehnen.
Extra implementation exercise
Die Antwort funktioniert, aber der Anbieterschlüssel steht auch in public/app.js. Ist die Aufgabe fertig?
Ausgearbeitete Lösung anzeigen
Nein. Entferne den Schlüssel aus öffentlichen Dateien, tausche ihn wegen der Offenlegung aus, aktualisiere die Servereinstellung und prüfe neues Deployment sowie Repository-Historie auf verbleibende Offenlegung.
- Weist erfolgreiche Ausgabe als hinreichenden Beleg zurück.
- Entfernt das Leck und tauscht den offengelegten Schlüssel aus.
Häufiger Fehler
Einen offengelegten Wert in der Oberfläche verbergen, während er in einem herunterladbaren Skript bleibt.
Schritt 4
Führe sicher eine begrenzte Änderung durch
Erhalte beim Ändern der Funktion dieselbe Geheimnisgrenze.
Bitte den Assistenten, die bereitgestellte feste Aktion für eine kurze DNS-Erklärung anzupassen. Erhalte Modell- und Schlüsseleinstellungen auf dem Server sowie die Übungsgrenze nur für den Eigentümer.
Teste die gewünschte Antwort und einen ungültigen Zugriffscode erneut. Entscheide vor öffentlicher Nutzung über echte Authentifizierung, dauerhafte Nutzungskontrollen und Überwachung deines Anbieterbudgets.
Ein konkretes Beispiel
Ein anderes Antwortthema darf private Kontowerte nicht auf die Seite verschieben.
Selbst ausprobieren
Material zum Einstieg
Dateien und Testinhalte sind vorhanden. Eine echte Dienstprüfung benötigt dein eigenes Konto, Postfach oder deine Domain gemäß den Voraussetzungen. Lokales Prüfen bleibt möglich; kennzeichne nicht ausgeführte Live-Schritte als ungetestet.
Lege die geänderte Aktion und die tatsächlich durchgeführten Datenschutzprüfungen sowie gültigen und ungültigen Tests vor.
Dein Ergebnis Eine um vertrauliche Angaben bereinigte Aufzeichnung zur Schlüsselgrenze und zu gültigen und ungültigen Anfragen der bereitgestellten Aktion.
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Veranschaulichendes Änderungsprotokoll: „Die feste Aktion erklärt DNS jetzt in zwei Sätzen. Ein erlaubter Übungsaufruf lieferte dieses Thema; ein falscher Übungscode wurde abgelehnt; in der öffentlichen Ausgabe wurde weiterhin kein Anbieterschlüssel gefunden.“
„Bevor ich dies Fremden öffne, brauche ich noch echte Authentifizierung, dauerhafte Nutzungslimits und Überwachung des Anbieterbudgets.“ Der gemeinsame Übungscode ist eine kleine Laborgrenze, kein Beleg für einen vollständigen öffentlichen Dienst.
- Ändert das feste Antwortthema zu DNS und erhält die nur serverseitigen Schlüssel- und Modelleinstellungen.
- Prüft erlaubte und abgelehnte Aufrufe erneut und benennt noch nötige Kosten- und Zugangskontrollen für öffentlichen Betrieb.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-explain.mjsDiese Datei herunterladen
- verification.txtDiese Datei herunterladen
- worksheet.htmlDiese Datei herunterladen
- reference/assignment-walkthrough.txtDiese Datei herunterladen
- reference/START-HERE.txtDiese Datei herunterladen
- reference/netlify/functions/mini-explain.mjsDiese Datei herunterladen
How it works (optional)
Deine Aufgabe: verlagere eine zweite feste Aktion
Wiederhole die Grenze bewusst, statt sie versehentlich zu erweitern.
Ändere den festen Server-Prompt so, dass er DNS in zwei Sätzen erklärt. Halte Zugangsdaten, Modellwahl und Ausgabelimit auf dem Server; der Browser soll den Anbieterschlüssel weiter nicht kennen.
Protokolliere Ergebnisse mit gültigem und ungültigem Übungscode. Erkläre, was du vor öffentlichem Zugriff ergänzen würdest: authentifizierte Nutzer oder eine andere wirksame Zugriffsgrenze, dauerhafte Nutzungslimits und Überwachung des Anbieterbudgets.
Ausgearbeitetes Beispiel
Die Änderung eines festen Prompts zeigt, dass du den Steuerungsort des Anbieterverhaltens verstehst. Beliebige Modelle, Endpunkte oder Ausgabelimits aus dem Browser anzunehmen würde diese Kontrolle aufheben.
Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.
Extra implementation exercise
Erstelle die DNS-Version und ein kurzes Grenztestprotokoll.
Ausgearbeitete Lösung anzeigen
Ersetze in der reinen Serverfunktion mini-explain die feste Frage zum Websiteserver durch „Explain DNS in two sentences for a beginner.“ — erkläre DNS in zwei Sätzen für Anfänger. Halte Schlüssel und Modell in Serverumgebungsvariablen; die vollständige Referenzfunktion zeigt die genaue Änderung.
Untersuche ausgelieferte Browserskripte und Network-Anfragen. Der Browser sendet seine Anfrage an deine eigene Funktion; er darf GEMINI_API_KEY nicht selbst an Google senden. Der vom Eigentümer eingegebene Übungscode ist vom Anbieterschlüssel getrennt.
Teste einen falschen Übungscode: Erwarte Ablehnung vor jedem Anbieteraufruf. Ein Kontingent- oder Netzwerkfehler des Anbieters muss ein ehrlicher Fehler bleiben und darf keine vorgefertigte Erfolgsantwort werden. Wurde ein echtes Geheimnis offengelegt, entferne und ersetze es; die Datei danach zu ignorieren widerruft die Offenlegung nicht.
- Kein Anbieter-Geheimnis wird an den Browser ausgeliefert.
- Falscher Zugriff wird abgelehnt, und echte Anbieterfehler bleiben sichtbar.
Häufiger Fehler
Den eingeschränkten Workshop als produktionsreifen öffentlichen KI-Dienst bezeichnen.
War diese Lektion hilfreich?
Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.
Weiterlernen
- So erstellst du deine erste persönliche Website
- So veröffentlichst du deine Website über GitHub
- So verbindest du eine eigene Domain mit deiner Website
- So richtest du E-Mail auf deiner eigenen Domain ein
- So machst du deine Website auf Telefonen benutzbar
- So laden Bilder deiner Website schneller
- So erhältst du Website-Feedback in deinem Postfach
- So ergänzt du deine Website um E-Mail-Abonnements
- So sendest du automatisierte E-Mails von deiner Website
- So speicherst du Formulareingaben in einer Datenbank
- So können sich Menschen auf deiner Website anmelden
- So hältst du eine Seite privat
- So können Nutzer ihre Profilinformationen bearbeiten
- So können Nutzer Bilder hochladen
- So zeigst du Daten einer externen API auf deiner Website
- So ergänzt du deine Website um einen KI-Chatbot
- So beantwortet ein Chatbot Fragen anhand deiner eigenen Inhalte
- So ergänzt du deine Website um einen Blog
- So ergänzt du deine Website um eine Suche
- So ergänzt du deine Website um eine weitere Sprache
- So hilfst du Google, deine Website zu finden
- So reparierst du die Vorschau deiner Website beim Teilen eines Links
- So misst du Besuche und nützliche Aktionen auf deiner Website
- So können Besucher einen Termin buchen
- So nimmst du eine Zahlung auf deiner Website an
- So prüfst du Website-Änderungen vor dem Veröffentlichen
- So machst du ein fehlerhaftes Website-Deployment rückgängig
- So sicherst du deine Website-Daten und stellst sie wieder her
- So findest und behebst du Fehler auf deiner veröffentlichten Website