Generér og sikr din API-nøgle
På denne side
Legitimationsoplysningen, der godkender dine forespørgsler
Din API-nøgle godkender hver eneste forespørgsel, der sendes til Mistral-modeller: uden den accepteres ingen kald. Tænk på den som en teknisk adgangskode, bortset fra at den rejser gennem kode, konfigurationsfiler og deployments-pipelines, hvilket betyder, at den ender langt flere steder end en almindelig adgangskode. Enhver, der har den, kan bruge din kvote og generere omkostninger på din konto.
Generér din første nøgle
I Mistral Console skal du åbne dit workspace og navigere til sektionen API Keys i sidebjælken. Klik på Create new key og giv den et beskrivende navn, f.eks. dev-chatbot-mars-2026. Dette navn har ingen teknisk funktion, men det redder dig den dag, seks nøgler sameksisterer på listen, og du skal tilbagekalde bare én: “nøgle 3” fortæller dig ingenting, mens dev-chatbot-mars-2026 fortæller dig alt.
Nøglen vises kun én gang, i øjeblikket den oprettes. Kopier den straks, og gem den et sikkert sted. Hvis du lukker vinduet, før du kopierer den, findes der ingen måde at gendanne den på: du skal generere en ny. En Mistral-nøgle består af et præfiks efterfulgt af en lang alfanumerisk streng. Forveksl den ikke med dit workspace-ID eller et JWT-token: i modsætning til sidstnævnte udløber den ikke af sig selv og forbliver gyldig, indtil du tilbagekalder den.
Gem den uden nogensinde at hardcode den
Den gyldne regel er enkel: hardcod aldrig din API-nøgle i kildekoden. Den dag den fil havner i et delt repository, følger nøglen med. Brug altid en miljøvariabel i stedet.
På Linux og macOS deklarerer du den i terminalen:
export MISTRAL_API_KEY="your-api-key-here"
Denne variabel forsvinder, når du lukker terminalen; for at gøre den permanent skal du tilføje linjen til din fil ~/.bashrc, ~/.zshrc eller ~/.profile.
På Windows ser PowerShell-ækvivalenten sådan ud:
$env:MISTRAL_API_KEY = "your-api-key-here"
Og for at overleve en genstart af sessionen:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
I et applikationsprojekt er den mest almindelige praksis at oprette en .env-fil i roden:
MISTRAL_API_KEY=your-api-key-here
Tilføj .env til din .gitignore med det samme – før dit første commit, ikke bagefter. I Python læser biblioteket python-dotenv denne fil og injicerer variablerne ved opstart, hvilket giver dig bekvemmeligheden ved en lokal fil uden risikoen for at versionere hemmeligheder.
Rotér dine nøgler
Udskift en nøgle af tre årsager. Straks, hvis den er blevet eksponeret på nogen måde: et commit pushet til et offentligt Git-repository, en hastig Slack-besked eller spor i serverlogs. Regelmæssigt i produktion, hvor hver halvfems dage er en rimelig rytme. Og når en samarbejdspartner forlader organisationen, der havde adgang, samme dag som de afleverer deres adgangskort.
Fremgangsmåden undgår serviceafbrydelser, hvis du overholder rækkefølgen:
- Generér en ny nøgle i Console
- Opdater miljøvariablen i alle dine deployments
- Verificér, at alt fungerer med den nye nøgle
- Tilbagekald den gamle nøgle først efter denne verifikation
At bytte om på trin 3 og 4 er den klassiske fejl: du tilbagekalder først “for en sikkerheds skyld”, for derefter at opdage, at en glemt service stadig brugte den gamle nøgle. Denne rotation uden nedtid sikrer, at ingen komponent fejler under overgangen.
Reducér eksponeringsfladen
Hvis flere applikationer kalder API’et, skal du oprette én nøgle pr. applikation. Hvis én bliver kompromitteret, behøver du kun at tilbagekalde den specifikke nøgle uden at stoppe de andre. Efter samme princip må du aldrig genbruge en produktionsnøgle i udvikling: det er netop det miljø, hvor hemmeligheder cirkulerer mest frit.
Overvåg derefter brugen fra Console, som eksponerer brugslogs for hver nøgle. En pludselig stigning i tokens eller kald fra en ukendt IP-adresse bør udløse øjeblikkelig rotation uden at vente på bekræftelse af en hændelse.
Tre sidste fejl fortjener omtale, fordi vi støder på dem hver uge. En nøgle, der er offentliggjort i et offentligt Git-repository, forbliver læsbar i historikken, selv efter filen er slettet: det eneste gyldige svar er tilbagekaldelse. En nøgle sendt i klar tekst via e-mail eller instant messaging arkiveres for evigt på servere, du ikke kontrollerer. Og en udløbet eller tilbagekaldt nøgle, der ligger tilbage i et deployment, producerer 401 Unauthorized-fejl, som det ofte tager en time at diagnosticere, simpelthen fordi ingen tænkte på at tjekke.
Vigtige pointer
- Generér dine nøgler fra sektionen API Keys i dit workspace i Mistral Console
- Gem dem udelukkende i miljøvariabler eller en secrets manager
- Udfør regelmæssig rotation og øjeblikkelig rotation ved eksponering
- Opret én nøgle pr. applikation for at begrænse konsekvenserne af en kompromittering
- Tilføj altid
.envtil din.gitignore