Secrets
Kazzle hat einen integrierten verschlüsselten Tresor zum Speichern von API-Schlüsseln, Datenbankzugangsdaten, Token und anderen sensiblen Werten, die deine App benötigt. Secrets werden im Ruhezustand mit AES-256-GCM verschlüsselt, wobei KMS-umhüllte Datenverschlüsselungsschlüssel verwendet werden — Klartextwerte gelangen niemals in die Datenbank.Konzepte
Collections gruppieren zusammenhängende Secrets (z. B.stripe-keys, database-credentials). Jede Collection hat einen Slug (Kleinbuchstaben, mit Bindestrichen), auf den du in Konfigurationsdateien und CLI-Befehlen verweist.
Environments sind optionale Bereiche innerhalb einer Collection (z. B. production, staging). Secrets können auf ein bestimmtes Environment beschränkt oder auf Collection-Ebene als Standardwerte belassen werden.
Auflösungsreihenfolge: Bei der Auflösung von Secrets für eine bestimmte Collection + Environment überschreiben umgebungsspezifische Secrets Collection-Secrets mit demselben Namen. Dies ermöglicht es dir, die meisten Secrets über Environments hinweg zu teilen und gleichzeitig bestimmte Werte pro Environment zu überschreiben.
Secrets verwalten
In der App
Öffne Settings > Vault, um Collections, Environments und Secrets über die Benutzeroberfläche zu erstellen.Mit der KI
Die KI kann Collections erstellen, Environments erstellen, Secrets speichern, sie zwischen Bereichen verschieben und sie für dich löschen. Die KI sieht Secret-Namen und Metadaten, aber nicht die verschlüsselten Werte.Mit der CLI
Secrets aus deiner App referenzieren
Verweise mit derenv-Eigenschaft einer Komponente auf eine Secret-Collection und ein Environment in kazzle.config.ts. Jedes Secret in diesem Bereich wird als Prozessumgebungsvariable eingefügt, deren Name dem Secret-Namen entspricht:
env.collection und env.environment sind Slugs, keine Anzeigenamen. Verwende env.include, um nur eine Teilmenge der Secrets der Collection einzufügen:
Wie Secrets zu Umgebungsvariablen werden
Wenn Secrets für eine Komponente aufgelöst werden:- Die Collection wird nach Slug in deinem Space gefunden
- Secrets, die auf das angegebene Environment beschränkt sind, werden geladen
- Collection-Secrets (ohne Environment) werden als Standardwerte einbezogen
- Umgebungsspezifische Secrets überschreiben Collection-Secrets mit demselben Namen
- Secret-Referenzen innerhalb von Werten werden aufgelöst
- Secret-Namen werden in das Format der Umgebungsvariablen konvertiert: Großbuchstaben, nicht-alphanumerische Zeichen werden zu Unterstrichen
Stripe Secret Key wird zu STRIPE_SECRET_KEY.
Jedes Secret hat einen Body-Modus, der bestimmt, wie es eingefügt wird:
stringSecrets (API-Schlüssel, Token, URIs) werden als einfache Skalarzeichenfolgen eingefügtjsonSecrets (strukturierte Konfiguration) werden als JSON-Zeichenfolgen eingefügtfieldsSecrets (Anmeldedaten, typisierte Feldgruppen) werden als JSON-Zeichenfolgen eingefügt
Wann Secrets eingefügt werden
Template-Referenzen
Secret-Werte können andere Secret-Felder mit der gleichen Syntax referenzieren, die Kazzle anderswo verwendet:${secret.<uuid>.<field>}— spezifisches Feld oder JSON-Pfad innerhalb von Secret-Werten oder Tool-Parametern, wo Vault-Referenzen aktiviert sind.${secret.<uuid>}— gesamter Secret-Body. Verwende dies nur, wenn ein Tool explizit das gesamte rohe Secret anfordert; verwende dies nicht in App-Umgebung/Konfiguration.