--- title: "Secrets: Schlüssel für den Code Ihrer Website | Briks" url: https://briks.dev/de/docs/secrets description: "API-Schlüssel und Passwörter Ihres Website-Codes bleiben auf dem Website-Server, nie in Seiten oder Downloads. Hinzufügen, Ändern, Entfernen und Briks-Regeln." last_updated: 2026-10-08 --- # Secrets: Schlüssel für den Code Ihrer Website Manche Funktionen brauchen einen Schlüssel, ein Token oder ein Passwort für einen anderen Dienst. In Secrets bewahren Sie diese Werte auf, damit der Code Ihrer Website sie nutzen kann, ohne dass der Wert je auf einer Seite, in einer Datei oder im Studio erscheint. Diese Seite behandelt das Hinzufügen, Ändern und Entfernen sowie die Regeln, an die sich Briks dabei hält. 8 Minuten Lesezeit Am 8. Oktober 2026 mit dem Studio abgeglichen ## Was ein Secret ist Ein Secret ist ein Wert mit einem Namen. Der Wert ist meist ein API-Schlüssel: das Passwort, mit dem ein Programm mit einem anderen spricht, etwa der Schlüssel, den Ihnen ein Mailingdienst gibt. Über den Namen fragt der Code Ihrer Website den Wert ab, zum Beispiel `MAILING_LIST_KEY`. Der Teil Ihrer Website, der Secrets liest, läuft auf dem Server hinter seinen Routen (Adressen unter `/api/`, die Code ausführen, statt eine Seite zu zeigen). Der Wert bleibt dort. Er steht nicht in den Seiten der Website, wird nicht an die Browser der Besucher gesendet und steckt nicht im Code, den Sie herunterladen können. Einmal gespeichert, kann ein Wert von niemandem mehr angezeigt werden, auch nicht von Ihnen. Das Studio behält nur den Namen, wer ihn gespeichert hat und wann. Bewahren Sie Ihre eigene Kopie an einem sicheren Ort auf, zum Beispiel in einem Passwortmanager. Secrets brauchen Sie nur, wenn der eigene Code Ihrer Website mit etwas arbeitet, das einen Schlüssel verlangt. Eine Visitenkarten-Website mit Kontaktformular braucht keine. Wo 1. Projects 2. Your project 3. Settings 4. Secrets ## Bevor Sie beginnen - **Veröffentlichen Sie die Website einmal.** Geheimnisse werden nur auf der veröffentlichten Website gespeichert, nie vom Studio. Bis zur ersten Veröffentlichung zeigt die Seite **Publish the site first**, und es kann nichts hinzugefügt werden. - **Prüfen Sie Ihre Rolle.** Editors, Admins und Owners können Secrets hinzufügen, ändern und löschen. Viewers sehen die Namen und wann jedes Secret gespeichert wurde. - **Wählen Sie einen Namen.** Buchstaben, Ziffern und Unterstriche, beginnend mit einem Buchstaben, bis zu 128 Zeichen. Üblich sind Großbuchstaben mit Unterstrichen. Namen, die mit `BRIKS_` beginnen, sind für das Studio reserviert. - **Beachten Sie die Grenzen.** Ein Wert darf bis zu 5 KB groß sein, genug für jeden Schlüssel oder jedes Zertifikat. Ein Projekt fasst bis zu 100 Secrets, die des Studios selbst eingeschlossen. ## Secret hinzufügen 1. Klicken Sie auf Add secret Wo: Settings, Secrets Solange es noch keine Secrets gibt, steht der Button in der Mitte der Seite. Sobald Sie welche haben, steht er neben dem Suchfeld über der Liste. 2. Den Namen eingeben Wo: Add a secret Geben Sie ihn unter **Name** genau so ein, wie die Funktion ihn verlangt. Groß- und Kleinschreibung zählt, daher sind `MAILING_LIST_KEY` und `Mailing_List_Key` verschiedene Secrets. 3. Wert einfügen Wo: Add a secret Fügen Sie den Schlüssel in **Value** ein. Der Dialog weist Sie darauf hin: Once saved, the value is never shown again. Bewahren Sie bei Bedarf eine eigene Kopie auf. 4. Speichern Wo: Add a secret Klicken Sie auf **Add secret**. Sie sehen zum Beispiel: MAILING\_LIST\_KEY was added. Die Live-Website hat es nun. ## Mehrere aus einer .env-Datei importieren Eine .env-Datei ist eine einfache Textdatei mit Zeilen im Format `NAME=value`, eine pro Geheimnis. Entwickler haben oft eine. Wenn Sie eine haben, können Sie alle Zeilen auf einmal übernehmen. 1. Klicken Sie auf Import .env Wo: Settings, Secrets Der Dialog **Import a .env file** öffnet sich. 2. Geben Sie ihm die Zeilen Wo: Import a .env file Fügen Sie die Zeilen in das Feld ein, ziehen Sie die Datei darauf oder klicken Sie auf **Choose a file**. Eine Datei darf bis zu 256 KB groß sein. 3. Vorschau prüfen Wo: Import a .env file Jeder Name ist mit **New** markiert, oder mit **Replaces**, wenn bereits ein Secret mit diesem Namen existiert und den neuen Wert erhält. Zeilen, die nicht verwendet werden können, werden als übersprungen aufgeführt, jeweils mit dem Grund. 4. Importieren Wo: Import a .env file Klicken Sie auf die Import-Schaltfläche, die zählt, was gespeichert wird, zum Beispiel **Import 3 secrets**. Vorher wird nichts gespeichert. ## Ein Secret ändern oder entfernen 1. Einen neuen Wert vergeben Wo: Settings, Secrets Öffnen Sie die drei Punkte in der Zeile und wählen Sie **Edit value**. Der Dialog sagt: Der neue Wert ersetzt den alten, der nie angezeigt wird. Fügen Sie den neuen Wert ein und klicken Sie auf **Save value**. 2. Oder löschen Sie sie Wo: Settings, Secrets Wählen Sie stattdessen **Delete**. Der Dialog warnt: Code auf der Website, der ihn liest, findet ihn nicht mehr. Das lässt sich nicht rückgängig machen. Drücken Sie zur Bestätigung **Delete**. Änderungen erreichen die Live-Website sofort: Sie sehen The live site has it now, bei einem Löschen The live site no longer has it. Bei vielen Secrets findet das Feld **Search secrets** eines nach seinem Namen. Die Tabelle zeigt zu jedem **Name** und **Last saved**, dazu, wer es gespeichert hat. Manche Zeilen tragen die Markierung **Managed**. Das Studio setzt sie für seine eigenen Dienste, etwa die E-Mails der Website, und sie lassen sich hier nicht ändern oder löschen. ## Wie der Build ein Secret verwendet Der Code Ihrer Website liest ein Secret bei jeder Ausführung über seinen Namen, daher braucht ein Build den Wert nie. Wenn Sie das Studio bitten, Ihre Website mit einem anderen Dienst zu verbinden, etwa einer Mailingliste oder einem KI-Modell, liest ihr Code den Schlüssel dieses Dienstes unter einem klaren Namen, etwa `MAILING_LIST_KEY`. Den Wert tragen Sie hier unter diesem Namen ein. ## Vor einem Build nach einem Schlüssel gefragt werden - **Eine Änderung an einer veröffentlichten Website.** Wenn Ihre Anfrage einen weiteren Dienst anbindet, steht kurz **Checking which keys this needs** im Status. Hat die Website für einen Schlüssel noch keinen Wert, fragt das Studio vor dem Build nach. Die Karte in der Unterhaltung hat für jeden Schlüssel ein Feld, bis zu 3 für eine Änderung. Fügen Sie den Wert ein und drücken Sie **Save and build**: Er geht direkt in die Secrets der Website, nie in die Unterhaltung, und die Änderung startet. Drücken Sie **Add it later**, um ohne ihn zu bauen. - **Eine Nachricht, die gesendet wird, während er wartet,** wird Teil der Änderung. Schlüssel, die Sie schon gespeichert oder später hinzuzufügen gewählt haben, werden nie erneut abgefragt: Verbindet Ihre neue Nachricht einen weiteren Dienst, wird nur dessen Schlüssel abgefragt, sobald die erste Karte erledigt ist. - **Eine neue Website.** Secrets brauchen eine veröffentlichte Website, daher kann ein erster Build noch keinen Schlüssel annehmen. Unter seinen Fragen vor dem Build kann er fragen, ob die Verbindung jetzt gebaut und der Schlüssel hinzugefügt werden soll, sobald die Website live ist, oder ob dieser Teil vorerst entfällt. - In [Telegram](https://briks.dev/de/docs/telegram) hat die Karte für jeden Schlüssel eine Schaltfläche, die Secrets im Studio öffnet, und **Build**, um weiterzumachen. Ein Schlüssel wird nie über einen Chat gesendet. ## Von der Website benötigt Nach jeder Veröffentlichung liest Briks, welche Secret-Namen der eigene Code der Website anfordert. Die ohne Wert stehen zuerst auf dieser Seite, markiert mit **Needed by the site**. Klicken Sie bei einem auf **Add value**, dann öffnet sich das Formular mit ausgefülltem Namen. Solange ein Name keinen Wert hat, funktioniert der Teil der Website, der ihn nutzt, nicht. Die Antwort auf einen Build oder eine Änderung nennt sie ebenfalls, zum Beispiel: Die Website liest MAILING\_LIST\_KEY, der noch keinen Wert hat: Fügen Sie ihn unter Project Settings → Secrets hinzu. Jeder Name hat eine eigene Schaltfläche, etwa **Add MAILING\_LIST\_KEY**, die diese Seite mit dem eingetragenen Namen öffnet. Derselbe Satz steht in der Benachrichtigung und in Telegram, wenn dort ein fertiger Build gemeldet wird. ## Ein in eine Nachricht eingefügter Schlüssel Briks erkennt die üblichen Formen von Dienstschlüsseln und Tokens. Ein Schlüssel, der in den Studio-Chat, in die Beschreibung eines neuen Projekts, in den Brief eines Projekts, in eine Nachricht an einen Agenten oder dessen Anweisungen, in Ask AI des Visual Editors oder in einen Chat mit dem Bot eingefügt wird, wird entfernt, bevor die Nachricht gespeichert oder gelesen wird, und durch `[key removed: add it in Settings → Secrets]` ersetzt. Das Studio weist sofort darauf hin: A key was removed from your message so it isn't stored. Add it in Project Settings → Secrets. Die Antwort enthält einen Button **Open Secrets** zu dieser Seite. Im Thread eines Agenten, der an jedem Projekt arbeitet, listet **Open Secrets** Ihre Projekte auf, damit Sie das Projekt auswählen können, für das der Schlüssel gedacht ist. Etwas, das sich ein Agent merken soll, wird abgelehnt, wenn es einen Schlüssel enthält. Fügen Sie niemals einen Schlüssel in den Chat ein Ein Schlüssel in einer Form, die Briks nicht erkennt, bleibt in der Nachricht, und alles, was Sie im Studio-Chat eingeben, wird in der Unterhaltung des Projekts gespeichert. Speichern Sie Schlüssel unter **Secrets** und verweisen Sie nur über den Namen auf sie. Dasselbe gilt für den Datei-Explorer: Tippen Sie keinen Schlüssel in eine Datei. Bevor eine Website veröffentlicht wird, liest Briks den eigenen Code auf Schlüssel, die in Dateien geschrieben sind: Werte, die an ihrer Form wie Schlüssel aussehen, und Werte, die allem zugewiesen sind, was wie ein Key, Token oder Passwort benannt ist. Findet Briks einen, wird der Build zurückgeschickt, um den Wert zu entfernen und das Geheimnis stattdessen über seinen Namen zu lesen. ## Sicherheitsregeln, die Briks durchsetzt - Die Werte gehen verschlüsselt direkt an die Serverseite der veröffentlichten Website. Das Studio speichert sie nie, zeigt sie nie wieder an und schreibt sie nie in seine Protokolle. - Werte erscheinen nie in den Seiten der Website, in den Browsern der Besucher oder im Code, den Sie herunterladen. - Nur Editor, Admins und Owner können Secrets hinzufügen, ändern oder löschen. - Namen, die mit `BRIKS_` beginnen, gehören dem Studio, und verwaltete Secrets lassen sich nicht ändern. - Ein Projekt kann pro Minute bis zu 60 Änderungen an seinen Secrets vornehmen. Darüber sehen Sie: That is a lot of changes at once. Wait a minute and try again. ## Wenn ein Geheimnis fehlt Secrets gehören zur Adresse der Website. Ändern Sie die Adresse (siehe [Die Adresse Ihrer Website](https://briks.dev/de/docs/site-address)), bleiben Ihre Secrets bei der alten. Die Meldung des Studios listet sie auf und bittet Sie, sie unter **Settings**, **Secrets** erneut einzugeben, und jede Zeile zeigt **Not on the site · enter again**. Wählen Sie bei jedem **Edit value** und fügen Sie den Wert ein. Verlangt der Code der Website ein Secret, das nicht vorhanden ist, antwortet dieser Teil der Website: Dieser Teil der Website ist noch nicht eingerichtet. Prüfen Sie, ob der Name genau übereinstimmt, einschließlich Groß- und Kleinschreibung, und ob in der Zeile nicht **Not on the site** steht. ## Praxisbeispiel: einen kompromittierten Schlüssel ersetzen Was passiert ist Eine Floristin in Cork > Ihr E-Mail-Dienst warnte, dass der unter `MAILING_LIST_KEY` gespeicherte Schlüssel in einem alten E-Mail-Verlauf aufgetaucht war. Sie erstellten beim E-Mail-Dienst einen neuen Schlüssel, öffneten **Settings**, **Secrets**, wählten bei `MAILING_LIST_KEY` **Edit value**, fügten den neuen Schlüssel ein und drückten **Save value**. MAILING\_LIST\_KEY hat seinen neuen Wert. Die Live-Website hat ihn jetzt. Erst dann löschten sie den alten Schlüssel beim Mailing-Dienst, sodass die Website nie einen Moment ohne funktionierenden Schlüssel war. Es musste nichts neu gebaut werden, weil der Code den Schlüssel über seinen Namen abruft. ### Kann ich den Wert eines Secrets später noch sehen? Nein. Weder Sie noch ein Teammitglied noch Briks. Bewahren Sie beim Speichern Ihre eigene Kopie auf. ### Verändert das Hinzufügen eines Secrets meine Website von selbst? Nein. Ein Secret bewirkt nichts, bis der Code der Website es mit seinem Namen ausliest. Bitten Sie das Studio um die Funktion, die es verwendet. ### Sind Secrets im Code enthalten, den ich herunterlade? Nein. Der Download enthält die eigenen Dateien der Website, und Schlüssel werden nie in sie geschrieben. ### Warum kann ich keinen hinzufügen? Entweder wurde die Website noch nicht veröffentlicht, oder Ihre Rolle ist Viewer. Die Seite sagt, was zutrifft. ## Als Nächstes lesen - [An einem Projekt arbeiten **Der Code Ihrer Website** Code Ihrer Website im File Explorer ansehen, bearbeiten und veröffentlichen, in jedem Plan. Im kostenpflichtigen Plan als Zip laden und sehen, was fehlt.](https://briks.dev/de/docs/code) - [Veröffentlichung und Domains **Die Adresse Ihrer Website** Jede Briks-Website erhält eine Adresse bei briks.live. Wie der Name entsteht, welche Regeln gelten, wie Sie ihn ändern und was mit dem alten passiert.](https://briks.dev/de/docs/site-address) - [Workspaces und Konto **Mitglieder und Rollen** Laden Sie Personen per E-Mail-Link ein und weisen Sie Rollen zu: Owner, Admin, Editor oder Viewer. Was jede Rolle darf und wie viele Personen jeder Plan fasst.](https://briks.dev/de/docs/members-and-roles) - [Daten und Automatisierung **Logs** Build-Protokoll und Anfragen des letzten Tages lesen, nach Level oder Status filtern, ein defektes Formular, einen defekten Job, eine langsame Seite finden.](https://briks.dev/de/docs/logs) Noch nicht weitergekommen? Schreiben Sie an [hello@briks.dev](mailto:hello@briks.dev) mit dem Namen Ihres Projekts und dem, was Sie erwartet haben. Ein Screenshot hilft.