Secrets Management
Sikker lagring av legitimasjon
Når applikasjonen din trenger å koble til eksterne tjenester – som å sende e-post via SendGrid, behandle betalinger med Stripe eller bruke OpenAI for AI-funksjoner – må du lagre API-nøkler og legitimasjon på en sikker måte. Klivs system for håndtering av secrets tar seg av dette automatisk.
Hva som gjør secrets sikre:
- Kryptert lagring i databasen
- Aldri vist i sin helhet etter at du har lagret dem
- Injiseres automatisk i edge functions ved behov
- Kontoomfattende slik at du bare lagrer hver nøkkel én gang
- Revisjonsspor som sporer når secrets ble opprettet eller oppdatert
Hvordan secrets fungerer
Når du forteller AI at du vil integrere med en ekstern tjeneste, vil den be om den nødvendige legitimasjonen. Når du har oppgitt en API-nøkkel, lagrer AI den sikkert med et beskrivende navn (som OPENAI_API_KEY eller STRIPE_SECRET_KEY). Fra da av kan enhver edge function som trenger den legitimasjonen få tilgang til den automatisk.
Maskert visning: Etter å ha lagret en secret, vil du bare se en delvis maskert versjon i administrasjonsgrensesnittet. For eksempel vises sk-proj-abc123xyz789 som sk-p****9789. Dette lar deg bekrefte hvilken nøkkel som er hvilken uten å eksponere hele verdien.
Automatisk injeksjon: Når en edge function kjører, injiseres de secretene den refererer til på en sikker måte for den kjøringen. AI skriver funksjonen slik at den leser dem gjennom plattformens secrets-grensesnitt, og plattformen leverer den faktiske verdien ved kjøretid – slik at en rotert nøkkel trer i kraft ved funksjonens neste kjøring.
Administrere secrets
Gjennom administrasjonsgrensesnittet kan du:
- Se alle secretene dine (med maskerte verdier)
- Legge til nye secrets eller oppdatere eksisterende
- Slette secrets du ikke lenger trenger
- Se når hver secret ble opprettet eller sist oppdatert
AI kan også lage og oppdatere secrets for deg når du beskriver integrasjoner du vil bygge.
Vanlige bruksområder for secrets
- E-posttjenester: SendGrid-, Mailgun- eller SMTP-legitimasjon
- Betalingsbehandling: Stripe-, PayPal- eller andre betalings-API-nøkler
- AI-tjenester: OpenAI-, Anthropic- eller Google-API-nøkler
- SMS/anrop: Twilio auth-tokens
- Eksterne API-er: Enhver tredjepartstjeneste appen din integreres med
- Webhooks: Signeringssecrets for å bekrefte innkommende webhooks
- Databasetilkoblinger: Tilkoblingsstrenger for eksterne databaser
Beste praksis
✅ Bruk beskrivende navn - Navngi secrets tydelig som SENDGRID_API_KEY i stedet for key1 eller secret.
✅ Roter regelmessig - Oppdater secrets med jevne mellomrom, spesielt for kritiske tjenester.
✅ Slett når du er ferdig - Fjern secrets for tjenester du ikke lenger bruker.
❌ Ikke del secrets - Hvert miljø (test, produksjon) bør bruke forskjellige API-nøkler.
❌ Ikke commit dem til koden - Secrets lagres separat fra koden din av en grunn. Legg aldri API-nøkler direkte i kildefilene dine.
Relatert dokumentasjon: