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.

Interaktive Lektion startenLektionsnotizen lesen

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.

Workshop-Dateien

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

Start hereWorkshop-Dateien

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.

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

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

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.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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.

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.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.

Weiterlernen

Weitere Lektionen entdecken