Secrets: Schlüssel für den Code Ihrer Website

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

#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

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

#Ein Secret ändern oder entfernen

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

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), 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

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.