Secrets Management
Säker lagring av inloggningsuppgifter
När appen behöver koppla till externa tjänster — som att skicka mejl genom SendGrid, bearbeta betalningar med Stripe eller använda OpenAI för AI-funktioner — behöver du lagra API-nycklar och inloggningsuppgifter säkert. Klivs secrets management-system hanterar detta automatiskt.
Det som gör secrets säkra:
- Krypterad lagring i databasen
- Visas aldrig i sin helhet efter att du sparat dem
- Injiceras automatiskt i edge functions när det behövs
- Kontoomfattande så att du bara lagrar varje nyckel en gång
- Auditspår som följer när secrets skapades eller uppdaterades
Så fungerar secrets
När du säger till AI:n att du vill integrera med en extern tjänst ber den om nödvändiga inloggningsuppgifter. När du ger en API-nyckel lagrar AI:n den säkert med ett beskrivande namn (som OPENAI_API_KEY eller STRIPE_SECRET_KEY). Från och med då kan varje edge function som behöver den inloggningsuppgiften komma åt den automatiskt.
Maskerad visning: Efter att ha sparat en secret ser du bara en delvis maskerad version i admin UI. Till exempel visas sk-proj-abc123xyz789 som sk-p****9789. Det låter dig verifiera vilken nyckel som är vilken utan att exponera hela värdet.
Automatisk injicering: När en edge function körs injiceras de secrets den refererar till säkert för just den körningen. AI:n skriver funktionen så att den läser dem genom plattformens secrets-gränssnitt, och plattformen tillhandahåller det faktiska värdet vid runtime — så en roterad nyckel börjar gälla vid funktionens nästa körning.
Hantera secrets
I adminpanelen kan du:
- Visa alla dina secrets (med maskerade värden)
- Lägga till nya secrets eller uppdatera befintliga
- Radera secrets som du inte längre behöver
- Se när varje secret skapades eller senast uppdaterades
AI:n kan också skapa och uppdatera secrets åt dig när du beskriver integrationer du vill bygga.
Vanliga användningar för secrets
- Mejltjänster: SendGrid, Mailgun eller SMTP-inloggningsuppgifter
- Betalningsbearbetning: Stripe, PayPal eller andra betalnings-API-nycklar
- AI-tjänster: OpenAI, Anthropic eller Google API-nycklar
- SMS/samtal: Twilio auth tokens
- Externa API:er: Valfri tredjepartstjänst som appen integrerar med
- Webhooks: Signeringssecrets för att verifiera inkommande webhooks
- Databaskopplingar: Connection strings för externa databaser
Bästa praxis
✅ Använd beskrivande namn - Namnge secrets tydligt, som SENDGRID_API_KEY, i stället för key1 eller secret.
✅ Rotera regelbundet - Uppdatera secrets periodiskt, särskilt för kritiska tjänster.
✅ Radera när du är klar - Ta bort secrets för tjänster som du inte längre använder.
❌ Dela inte secrets - Varje miljö (test, produktion) ska använda olika API-nycklar.
❌ Committa inte till kod - Secrets lagras separat från koden av en anledning. Lägg aldrig API-nycklar direkt i källfiler.
Relaterad dokumentation: