Hemligheter och miljövariabler
Hantera API-nycklar och miljövariabler för ditt Convex-backend.
Klicka på Settings-knappen i builder-verktygsfältet för att öppna inställningspanelen. Den har tre sektioner:
| Sektion | Vad den används till |
|---|---|
| General | Projektnamn och kunskapsbas |
| SEO & sharing | Ange webbplatsens titel, beskrivning och favicon |
| Secrets | Miljövariabler för ditt Convex-backend |
Hur lägger jag till en hemlighet?
Section titled “Hur lägger jag till en hemlighet?”- Klicka på Settings-knappen i builder-verktygsfältet
- Öppna fliken Secrets
- Ange ett namn (till exempel
STRIPE_SECRET_KEY) och ett värde - Klicka på Add
Hur använder jag hemligheter i min app?
Section titled “Hur använder jag hemligheter i min app?”Hemligheter synkroniseras till din apps Convex-backend. Referera till dem i Convex-action/mutation/query-kod med process.env.SECRET_NAME. De är INTE tillgängliga i din frontend-kod eller som miljövariabler på pod-nivå – detta förhindrar att hemligheter läcker in i webbläsarpaketet.
AI:n använder automatiskt dina hemligheter när den bygger funktioner:
"Accept payments with Stripe"→ använder dinSTRIPE_SECRET_KEY"Send emails with Resend"→ använder dinRESEND_API_KEY"Add Google OAuth"→ använder dinGOOGLE_CLIENT_IDochGOOGLE_CLIENT_SECRET
Hemligheter är bara tillgängliga i dina Convex-backendfunktioner (actions och mutations), inte i React-kod på frontend. AI:n genererar Convex-funktioner som läser dem via process.env.
Kan jag visa/redigera en hemlighet efter att jag skapat den?
Section titled “Kan jag visa/redigera en hemlighet efter att jag skapat den?”Hemlighetsvärden är maskerade som standard. Du kan växla synlighet för att visa värden, uppdatera dem, eller ta bort och återskapa dem.
Kan AI:n se mina hemligheter?
Section titled “Kan AI:n se mina hemligheter?”AI:n kan se dina hemliga namn men inte deras värden. Detta gör att den kan referera till rätt miljövariabel när den bygger funktioner, utan att känsliga uppgifter exponeras.
Identifiering av känsliga nycklar
Section titled “Identifiering av känsliga nycklar”Proyecta identifierar automatiskt vanliga mönster för känsliga nycklar (API-nycklar, tokens, lösenord) och maskerar deras värden i gränssnittet.
Webbplatsmetadata
Section titled “Webbplatsmetadata”Sektionen SEO & sharing låter dig ange:
- Site title — visas i webbläsarfliken och i sökresultat
- Site description — används för SEO-metabeskrivningar
- Favicon — ikonen som visas i webbläsarflikar
Dessa inställningar sparas på ditt projekt och tillämpas när du publicerar.
Kunskapsbas
Section titled “Kunskapsbas”Sektionen Knowledge Base låter dig lägga till referensmaterial och kontext som AI:n använder när den bygger din app. Lägg till varumärkesriktlinjer, tekniska specifikationer eller annan dokumentation som hjälper AI:n att fatta bättre beslut.
Vanliga frågor
Section titled “Vanliga frågor”Är hemligheter krypterade?
Hemligheter lagras i ditt projekt och synkroniseras till din Convex-deployment. De visas aldrig i din incheckade kod.
Kan jag ha olika hemligheter för dev och produktion?
För närvarande gäller hemligheter både din utvecklingsmiljö och din publicerade (produktions-)Convex-deployment. Hantering av hemligheter per miljö är planerat för en framtida version.
Vad gör jag om jag råkar exponera en hemlighet?
Ta omedelbart bort den gamla hemligheten, återkalla nyckeln hos tredjepartsleverantören och skapa en ny.
Vad är skillnaden mellan hemligheter och connectors?
Hemligheter är råa miljövariabler som du hanterar själv. Connectors är hanterade integrationer där Proyecta tar hand om lagring av autentiseringsuppgifter, autentisering, tokenförnyelse och granskningsloggning åt dig. Använd connectors när de finns tillgängliga (Stripe, Slack, Resend, ElevenLabs); använd hemligheter för tjänster som ännu inte har en connector.