Backend und Daten
Secrets und API-Schlüssel
Speichere die privaten Schlüssel, die deine App braucht, um mit anderen Diensten zu sprechen. Halte sie sicher und erfahre, wie sie in deine Vorschau und in deine Live-App kommen.
Ein Secret ist ein privater Wert, den deine App braucht, den aber sonst niemand sehen soll. Meistens ist es ein API-Schlüssel oder ein Token. Das ist ein passwortähnlicher Code, den dir ein Dienst gibt, zum Beispiel für Karten, Wetter oder SMS. Damit kann deine App den Dienst nutzen.
Secrets gehören nicht zum Code deiner App. Buildliy speichert sie getrennt und verschlüsselt. Wenn deine App läuft, gibt Buildliy sie an den Server deiner App weiter. So tauchen sie nie in deinem Code auf, nicht in GitHub und nicht in den Seiten, die Besucher herunterladen.
So bleiben Secrets sicher
- Verschlüsselt gespeichert. Buildliy verschlüsselt jedes Secret, bevor es gespeichert wird.
- Nur auf dem Server. Nur der Server-Code deiner App kann ein Secret lesen. Es wird nie an die Browser deiner Besucher geschickt.
- Nie wieder sichtbar. Nach dem Speichern kannst du den Wert eines Secrets nicht mehr ansehen. Du kannst ihn nur ersetzen.
- Nur für den Inhaber. Nur der Inhaber des Projekts kann die Secrets unter Verwalten → Secrets sehen und ändern. Ein Teammitglied kann in einer geteilten App die Schlüsselkarte der KI beantworten. Einen Schlüssel, den schon jemand gespeichert hat, kann es aber nicht ersetzen.
Wenn die KI nach einem Schlüssel fragt
Wenn eine Funktion, die du dir wünschst, einen Schlüssel braucht, hält die KI an und zeigt dir im Chat eine Karte. Es gibt zwei Arten.
Eine Verbindungskarte gibt es für Dienste aus der Liste der Konnektoren in Buildliy, zum Beispiel Resend, Twilio, Airtable oder SendGrid. Klicke auf Verbinden mit dem Namen des Dienstes, um deinen Schlüssel hinzuzufügen. Buildliy prüft vor dem Speichern, ob der Schlüssel beim Dienst funktioniert. Es speichert ihn verschlüsselt und legt ihn in deinem Konto ab, damit du ihn auch in deinen anderen Apps nutzen kannst. Sobald die Verbindung steht, macht die KI mit dem Build weiter. Hast du den Dienst schon einmal verbunden, aber er ist für diese App noch nicht eingeschaltet, steht auf dem Button stattdessen Weiter mit und der Name des Dienstes. Ist er schon verbunden und für diese App eingeschaltet, nutzt die KI ihn einfach und du siehst keine Karte. Vorerst überspringen schließt die Karte, ohne etwas zu verbinden. Die KI antwortet dann, dass du den Dienst jederzeit auf der Seite „Konnektoren“ verbinden kannst, und wartet auf deine nächste Nachricht. Mehr dazu findest du unter Konnektoren.
Eine Schlüsselkarte gibt es für alle anderen Schlüssel. Sie zeigt die Frage der KI, den Namen, unter dem der Schlüssel gespeichert wird (Gespeichert als, zum Beispiel WEATHER_API_KEY), und ein Feld, in das du den Schlüssel einfügst.
Den Schlüssel beim Dienst holen
Melde dich auf der Website des Dienstes an und kopiere deinen API-Schlüssel. Die Frage auf der Karte sagt meistens, wofür der Schlüssel gebraucht wird.
In die Karte einfügen
Füge den Schlüssel in das Feld ein. Klicke auf das Augen-Symbol, wenn du prüfen möchtest, was du eingefügt hast. Blende ihn wieder aus, bevor du deinen Bildschirm teilst.
Auf Speichern klicken
Der Schlüssel wird verschlüsselt gespeichert. So steht es auch auf der Karte: „Sicher und verschlüsselt gespeichert. Er erscheint nie im Chat oder im Code deiner App. Du kannst ihn später unter Verwalten → Secrets ändern.“ (Teammitglieder sehen: „Der Projektinhaber kann ihn später ändern.“) Danach baut die KI damit weiter.
Wenn du auf Überspringen klickst, wird nichts gespeichert und die KI macht ohne den Schlüssel weiter. Die Funktion, die ihn braucht, funktioniert dann erst, wenn du den Schlüssel unter Verwalten → Secrets hinzufügst.
Zahlungen annehmen richtest du anders ein. Siehe Zahlungen annehmen.
Füge keine Schlüssel in den Chat ein
Alles, was du in das Chatfeld tippst, wird in deiner Unterhaltung gespeichert und von der KI gelesen. Es wird nicht versteckt oder verschlüsselt wie ein Secret. Nutze deshalb immer die Schlüsselkarte oder Verwalten → Secrets.
Wenn du aus Versehen einen Schlüssel einfügst
Buildliy achtet im Chatfeld auf geheime Schlüssel, zum Beispiel einen geheimen Stripe-Schlüssel, ein GitHub-Token oder eine Datenbankadresse mit Passwort. Eine Nachricht mit einem Schlüssel wird nicht gesendet. Stattdessen erscheint über dem Chatfeld eine Karte mit dem Titel Das sieht nach einem geheimen Schlüssel aus. Sie erscheint, sobald du den Schlüssel einfügst oder auf „Senden“ drückst. Sie zeigt dir, um welche Art von Schlüssel es sich handelt, wobei der größte Teil des Schlüssels verdeckt ist. Dazu bietet sie dir an:
- Als Secret speichern: Speichert den Schlüssel unter Verwalten → Secrets mit dem Namen aus Speichern als, zum Beispiel
STRIPE_SECRET_KEY. Den Namen kannst du ändern. Gehört der Schlüssel zu einem Dienst aus der Liste der Konnektoren, kannst du wählen zwischen Als deinen …-Konnektor speichern (Buildliy prüft, ob er funktioniert, und speichert ihn in deinem Konto, sodass auch deine anderen Apps ihn nutzen können) und Als Secret für diese App speichern. In einem geteilten Workspace setzt du zuerst ein Häkchen. Damit bestätigst du, dass Teammitglieder, die in dieser App bauen, die Verbindung nutzen können. - Nachricht bearbeiten: Setzt deinen Cursor auf den Schlüssel, damit du ihn entfernen kannst. Solange der Schlüssel in der Nachricht steht, wird sie trotzdem nicht gesendet.
- Ist kein Schlüssel – trotzdem senden: Sendet deine Nachricht so, wie sie ist. Das ist für die seltenen Fälle gedacht, in denen die Karte falsch liegt.
Sobald der Schlüssel gespeichert ist, wird er in deiner Nachricht zu [saved as STRIPE_SECRET_KEY]. So kannst du den Rest deiner Nachricht sicher senden. Nur der Inhaber des Projekts kann ihn speichern. Teammitglieder sehen stattdessen Schlüssel entfernen, und die Karte bittet sie, den Inhaber den Schlüssel unter Verwalten → Secrets hinzufügen zu lassen. Auf der Startseite, bevor deine App existiert, bietet dir die Karte an, den Schlüssel vorerst zu entfernen.
Schlüssel, die öffentlich sein sollen, werden nicht markiert, zum Beispiel ein veröffentlichbarer Stripe-Schlüssel (pk_…). Wenn du eine Word-, Excel- oder Textdatei anhängst, in der ein geheimer Schlüssel steht, wird der Schlüssel vor der KI versteckt.
Wenn ein Schlüssel trotzdem im Chat gesendet wurde, behandle ihn als offengelegt. Gehe auf die Website des Dienstes, erstelle einen neuen Schlüssel und lösche den alten. Speichere den neuen Schlüssel dann unter Verwalten → Secrets.
Secrets selbst hinzufügen, ändern oder entfernen
Secrets öffnen
Öffne den Tab Verwalten und wähle Secrets.
Neues Secret ausfüllen
Gib unter Neues Secret hinzufügen bei Name einen Namen in Großbuchstaben mit Unterstrichen ein, zum Beispiel
WEATHER_API_KEY. Dazu kommt der Wert und, wenn du magst, eine Beschreibung, damit du dich später erinnerst, wofür es ist.Speichern
Klicke auf Speichern. Das Secret erscheint unter Gespeicherte Secrets.
Der Name muss zu dem Namen passen, den der Code deiner App verwendet. Wenn du dir nicht sicher bist, frage die KI, welchen Namen sie erwartet.
Aus welchem Secret liest das Wetter-Widget seinen Schlüssel?
- Ein Secret ändern. Klicke auf das Symbol mit dem Kreispfeil (Dieses Secret erneuern), füge den neuen Wert ein und klicke auf Erneuern. Auf breiteren Bildschirmen zählt die Spalte Erneuerungen, wie oft ein Secret schon rotiert wurde.
- Unter einem vorhandenen Namen speichern. Wenn du ein Secret unter einem Namen speicherst, der schon vergeben ist, wird der alte Wert ersetzt. Buildliy fragt vorher nach: Deine Vorschau wechselt sofort zum neuen Wert, und deine veröffentlichte App behält den alten, bis du erneut veröffentlichst. Du wählst Das alte behalten oder Ersetzen.
- Ein Secret entfernen. Klicke auf das Papierkorb-Symbol (Dieses Secret löschen) und bestätige. Deine App kann es dann nicht mehr nutzen: die Vorschau sofort, deine veröffentlichte App beim nächsten Veröffentlichen.
Secrets in deiner Vorschau und in deiner Live-App
- Deine Vorschau übernimmt ein neues, geändertes oder entferntes Secret automatisch. Du musst nichts neu bauen.
- Deine veröffentlichte App bekommt ihre Secrets, wenn du veröffentlichst. Veröffentliche nach einer Änderung erneut, damit deine Live-Seite den neuen Wert nutzt. Wenn deine App live ist, erinnert dich die Meldung nach einer Änderung unter Verwalten → Secrets oder nach dem Speichern eines Schlüssels über eine Karte im Chat daran, erneut zu veröffentlichen.
Secrets und Konnektoren
Beide speichern Schlüssel sicher. Der Unterschied ist, wo sie liegen und wer sie nutzen kann.
| Konnektor | Secret | |
|---|---|---|
| Wo es gespeichert wird | In deinem Buildliy-Konto | In einer einzelnen App |
| Genutzt von | Standardmäßig allen deinen eigenen Apps (für eine App schaltest du es unter Verwalten → Konnektoren aus); in einer App, die du mit deinem Team teilst, erst, wenn du es dort einschaltest | Nur dieser App |
| Vor dem Speichern geprüft | Ja, Buildliy testet den Schlüssel beim Dienst | Nein |
| Am besten für | Dienste aus der Liste der Konnektoren, die du in mehreren Apps nutzt | Alle anderen Schlüssel oder einen anderen Schlüssel für nur eine App |
Wenn ein Secret und ein Konnektor denselben Namen haben, gewinnt für diese App das Secret. So kannst du ganz einfach in einer App einen anderen Schlüssel verwenden.
Schlüssel, die Buildliy für dich hinzufügt
Manche Funktionen fügen Secrets für dich hinzu. Wenn deine App KI in deiner App nutzt, siehst du BUILDLIY_API_KEY und BUILDLIY_API_URL. Wenn sie Zahlungen annimmt, siehst du BUILDLIY_API_KEY und BUILDLIY_WEBHOOK_SECRET. Wenn Besucher Dateien hochladen können oder sie ihre Fehler meldet, siehst du BUILDLIY_API_KEY und BUILDLIY_API_URL. Wenn sie geplante Aufgaben hat, siehst du BUILDLIY_CRON_SECRET. Ändere oder lösche sie nicht, sonst funktionieren diese Funktionen nicht mehr.
Verwandte Themen
Du kommst nicht weiter? Lies die FAQ oder schreib uns.