
Mini-Lektion 15 von 30 · Konten und Zugriff
Kläre, welcher Wert privat bleiben muss
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.
Der Browser soll deine Funktion nutzen, ohne das Anbieter-Geheimnis zu erhalten.
Ziel dieser Lektion
- 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.
Erklärung, ausgearbeitetes Beispiel und Übung
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.
Prüfe deine Vorkenntnisse
Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.
- So veröffentlichst du deine Website über GitHub
Verbinde ein Übungsrepository mit einem Hostingdienst.
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.
Die Idee verstehen
Ö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
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Welcher Wert muss von der Besucherseite fernbleiben, und welche Nachweise soll der Assistent prüfen?
Ausgearbeitete Lösung anzeigen
Veranschaulichender Datenschutzplan: „GEMINI_API_KEY ist der private Anbieterzugang. LAB_TOKEN ist ein separater Übungszugangscode und kein anderer Name für diesen Schlüssel. Der Assistent prüft ausgelieferte öffentliche Skripte und Browseranfragen auf versehentlich offengelegte Zugangsdaten.“
Ein privater Dateiname allein beweist nichts: Ein Build könnte seinen Inhalt trotzdem in öffentliche Ausgaben kopieren. Die tatsächlichen Werte halte ich aus Screenshots und geteilten Notizen heraus.
Was eine gute Antwort enthält
- Erkennt den Anbieterschlüssel als geheim und den Übungszugangscode als separate Laborgrenze.
- Nennt öffentliche Dateien und Browseranfragen als Prüfstellen für versehentliche Schlüsselfreigabe.
So funktioniert es (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.
Zusätzliche technische Übung
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 1 · So hältst du API-Schlüssel aus deinem Frontend heraus
Starte die bereitgestellte geschützte Aktion
Lass den Assistenten den vorhandenen Serverweg einrichten.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
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.
Dateien für diesen Schritt
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
- 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
Selbst ausprobieren
Lief die Aktion, und welche private Einrichtungs- oder Anbieterstufe ist noch blockiert?
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.
Was eine gute Antwort enthält
- 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.
So funktioniert es (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
Zusätzliche technische Übung
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 2 · So hältst du API-Schlüssel aus deinem Frontend heraus
Prüfe Datenschutz und Fehlerfälle gemeinsam
Eine nützliche Antwort entschuldigt keinen offengelegten Schlüssel.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
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
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Was zeigten die Prüfung öffentlicher Ausgaben und der abgewiesene Versuch tatsächlich?
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.
Was eine gute Antwort enthält
- Benennt die geprüften öffentlichen Ausgaben und Anfragen, ohne das Anbietergeheimnis wiederzugeben.
- Dokumentiert einen abgelehnten Zugangsversuch und einen Versuch mit fehlender Konfiguration als Fehler.
So funktioniert es (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.
Zusätzliche technische Übung
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 3 · So hältst du API-Schlüssel aus deinem Frontend heraus
Führe sicher eine begrenzte Änderung durch
Erhalte beim Ändern der Funktion dieselbe Geheimnisgrenze.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
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
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
- 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
Selbst ausprobieren
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.
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.
Was eine gute Antwort enthält
- Ä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.
So funktioniert es (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.
Zusätzliche technische Übung
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.