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: