Administration af secrets

Sikker lagring af legitimationsoplysninger

Når din applikation skal oprette forbindelse til eksterne tjenester - som at sende e-mails gennem SendGrid, behandle betalinger med Stripe eller bruge OpenAI til AI-funktioner - skal du gemme API-nøgler og legitimationsoplysninger sikkert. Klivs system til administration af secrets håndterer dette automatisk.

Hvad gør secrets sikre:

  • Krypteret lagring i databasen
  • Vises aldrig i sin helhed, efter du har gemt dem
  • Injiceres automatisk i edge functions, når det er nødvendigt
  • Kontodækkende, så du kun gemmer hver nøgle én gang
  • Revisionsspor, der sporer, hvornår secrets blev oprettet eller opdateret

Hvordan secrets virker

Når du fortæller AI'en, at du vil integrere med en ekstern tjeneste, beder den om de nødvendige legitimationsoplysninger. Når du har angivet en API-nøgle, gemmer AI'en den sikkert med et beskrivende navn (som OPENAI_API_KEY eller STRIPE_SECRET_KEY). Fra da af kan enhver edge function, der har brug for den legitimationsoplysning, automatisk få adgang til den.

Masket visning: Når du har gemt en secret, ser du kun en delvist maskeret version i administrationsgrænsefladen. For eksempel vises sk-proj-abc123xyz789 som sk-p****9789. Det lader dig kontrollere, hvilken nøgle der er hvilken, uden at afsløre den fulde værdi.

Automatisk injektion: Når en edge function kører, injiceres de secrets, den henviser til, sikkert til netop den kørsel. AI'en skriver funktionen, så den læser dem gennem platformens secrets-grænseflade, og platformen leverer den faktiske værdi ved kørsel - så en udskiftet nøgle træder i kraft ved funktionens næste kørsel.

Håndtering af secrets

Via administrationsgrænsefladen kan du:

  • Se alle dine secrets (med maskerede værdier)
  • Tilføje nye secrets eller opdatere eksisterende
  • Slette secrets, du ikke længere har brug for
  • Se, hvornår hver secret blev oprettet eller sidst opdateret

AI'en kan også oprette og opdatere secrets for dig, når du beskriver integrationer, du vil bygge.

Almindelige anvendelser af secrets

  • E-mail-tjenester: SendGrid-, Mailgun- eller SMTP-legitimationsoplysninger
  • Betalingsbehandling: API-nøgler til Stripe, PayPal eller andre betalingstjenester
  • AI-tjenester: API-nøgler til OpenAI, Anthropic eller Google
  • SMS/opkald: Twilio-godkendelsestokens
  • Eksterne API'er: Enhver tredjepartstjeneste, som din app integrerer med
  • Webhooks: Signeringssecrets til verificering af indgående webhooks
  • Databaseforbindelser: Forbindelsesstrenge til eksterne databaser

Bedste praksis

✅ Brug beskrivende navne - Navngiv secrets tydeligt som SENDGRID_API_KEY i stedet for key1 eller secret.

✅ Roter regelmæssigt - Opdater secrets med jævne mellemrum, især for kritiske tjenester.

✅ Slet når du er færdig - Fjern secrets for tjenester, du ikke længere bruger.

❌ Del ikke secrets - Hvert miljø (test, produktion) bør bruge forskellige API-nøgler.

❌ Læg ikke secrets i koden - Secrets gemmes adskilt fra din kode af en grund. Læg aldrig API-nøgler direkte i dine kildefiler.


Relateret dokumentation: