Secrets
Kazzle heeft een ingebouwde versleutelde kluis voor het opslaan van API-sleutels, databasegegevens, tokens en andere gevoelige waarden die uw app nodig heeft. Secrets worden in rust versleuteld met AES-256-GCM met KMS-verpakte gegevensversleutelingssleutels — platte tekstwaarden raken nooit de database.Concepten
Collections groeperen gerelateerde secrets (bijv.stripe-keys, database-credentials). Elke collection heeft een slug (kleine letters, met koppeltekens) die u in configuratiebestanden en CLI-opdrachten gebruikt.
Environments zijn optionele bereiken binnen een collection (bijv. production, staging). Secrets kunnen aan een specifieke omgeving worden gekoppeld of op collectieniveau als standaardwaarden blijven staan.
Resolutievolgorde: bij het oplossen van secrets voor een bepaalde collection + environment overschrijven environment-specifieke secrets secrets op collectieniveau met dezelfde naam. Dit stelt u in staat om de meeste secrets in omgevingen te delen terwijl u specifieke waarden per omgeving overschrijft.
Secrets beheren
In de app
Open Settings > Vault om collections, environments en secrets via de UI te maken.Met de AI
De AI kan collections maken, environments maken, secrets opslaan, ze tussen bereiken verplaatsen en ze voor u verwijderen. De AI ziet geheime namen en metagegevens, maar niet de versleutelde waarden.Met de CLI
Secrets uit uw app refereren
Wijs deenv van een component naar een secret collection en environment in kazzle.config.ts. Elk secret in dat bereik wordt geïnjecteerd als een process env var waarvan de naam overeenkomt met de geheime naam:
env.collection en env.environment zijn slugs, geen weergavenamen. Gebruik env.include om alleen een subset van de secrets van de collection in te voegen:
Hoe secrets env vars worden
Wanneer secrets voor een component worden opgelost:- De collection wordt per slug in uw space gevonden
- Secrets die aan de opgegeven omgeving zijn gekoppeld, worden geladen
- Secrets op collectieniveau (geen omgeving) worden als standaardwaarden opgenomen
- Environment-specifieke secrets overschrijven secrets op collectieniveau met dezelfde naam
- Geheime verwijzingen in waarden worden opgelost
- Geheime namen worden omgezet naar env var-indeling: gekapitaliseerd, niet-alfanumerieke tekens worden onderstrepen
Stripe Secret Key wordt STRIPE_SECRET_KEY.
Elk secret heeft een body mode die bepaalt hoe het wordt geïnjecteerd:
stringsecrets (API-sleutels, tokens, URI’s) worden als platte scalaire strings geïnjecteerdjsonsecrets (gestructureerde config) worden als JSON-strings geïnjecteerdfieldssecrets (inloggegevens, getypte veldverzamelingen) worden als JSON-strings geïnjecteerd
Wanneer secrets worden geïnjecteerd
Sjabloonverwijzingen
Geheime waarden kunnen verwijzen naar andere geheime velden met dezelfde syntaxis die Kazzle elders gebruikt:${secret.<uuid>.<field>}— specifiek veld of JSON-pad in geheime waarden of toolparameters waar kluisverwijzingen zijn ingeschakeld.${secret.<uuid>}— hele geheime body. Gebruik alleen wanneer een tool expliciet om het hele onbewerkte geheim vraagt; gebruik dit niet in app env/config.