Luo ja suojaa API-avaimesi
Tällä sivulla
Tunniste, joka vahvistaa pyyntösi
API-avaimesi vahvistaa jokaisen Mistral-malleille lähetetyn pyynnön: ilman sitä yhtäkään kutsua ei hyväksytä. Ajattele sitä teknisenä salasanana, mutta ero on siinä, että se kulkee koodin, konfiguraatiotiedostojen ja käyttöönottoputkien läpi, joten se päätyy paljon useampaan paikkaan kuin tavallinen salasana. Kuka tahansa, jolla on avain, voi kuluttaa kiintiösi ja aiheuttaa kustannuksia tilillesi.
Luo ensimmäinen avaimesi
Avaa Mistral Console -palvelussa työtilasi ja siirry sivupalkin API Keys -osioon. Napsauta Create new key ja anna sille kuvaava nimi, kuten dev-chatbot-mars-2026. Nimellä ei ole teknistä tehtävää, mutta se pelastaa tilanteen, kun listalla on kuusi avainta ja sinun täytyy kumota vain yksi: “avain 3” ei kerro mitään, kun taas dev-chatbot-mars-2026 kertoo kaiken.
Avain näkyy vain kerran, luontihetkellä. Kopioi se välittömästi ja tallenna turvalliseen paikkaan. Jos suljet ikkunan ennen kopioimista, avainta ei voi palauttaa: sinun on luotava uusi. Mistral-avain koostuu etuliitteestä ja pitkstä aakkosnumeerisesta merkkijonosta. Älä sekoita sitä työtilatunnukseesi tai JWT-tokeniin: toisin kuin jälkimmäinen, se ei vanhene itsestään, vaan pysyy voimassa, kunnes kumoat sen.
Tallenna se koskaan kovakoodaamatta
Kultainen sääntö on yksinkertainen: älä koskaan kovakoodaa API-avaintasi lähdekoodiin. Sinä päivänä, kun tuo tiedosto päätyy jaettuun arkistoon, avain kulkee mukana. Käytä sen sijaan aina ympäristömuuttujaa.
Linuxissa ja macOSissa määritä se päätteen kautta:
export MISTRAL_API_KEY="your-api-key-here"
Tämä muuttuja katoaa, kun suljet päätteen; tehdäksesi siitä pysyvän, lisää rivi tiedostoon ~/.bashrc, ~/.zshrc tai ~/.profile.
Windowsissa PowerShell-vastaava näyttää tältä:
$env:MISTRAL_API_KEY = "your-api-key-here"
Ja jotta se säilyy istunnon uudelleenkäynnistyksen yli:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
Sovellusprojektissa yleisin käytäntö on luoda .env-tiedosto juureen:
MISTRAL_API_KEY=your-api-key-here
Lisää .env tiedostoon .gitignore välittömästi – ennen ensimmäistä commitia, ei sen jälkeen. Pythonissa python-dotenv-kirjasto lukee tämän tiedoston ja syöttää muuttujat käynnistyksen yhteydessä, mikä tarjoaa paikallisen tiedoston mukavuuden ilman salaisuuksien versionhallinnan riskiä.
Kierrätä avaimiasi
Vaihda avain kolmesta syystä. Välittömästi, jos se on paljastunut millään tavalla: commit, joka on työnnetty julkiseen Git-arkistoon, hätäinen Slack-viesti tai jäljet palvelinlokeissa. Säännöllisesti tuotannossa; yhdeksänkymmenen päivän väli on kohtuullinen tahti. Ja kun yhteistyökumppani lähtee, jolla oli pääsy, samana päivänä kun hän palauttaa tunnuksensa.
Menettely välttää palvelukatkokset, jos noudatat järjestystä:
- Luo uusi avain Consolessa
- Päivitä ympäristömuuttuja kaikissa käyttöönotoissasi
- Varmista, että kaikki toimii uudella avaimella
- Kumoa vanha avain vasta tämän varmistuksen jälkeen
Vaiheiden 3 ja 4 vaihtaminen on klassinen virhe: kumoat ensin “varmuuden vuoksi”, vain huomataksesi, että unohdettu palvelu käytti edelleen vanhaa avainta. Tämä nolla-katko-kierrätys varmistaa, että mikään komponentti ei epäonnistu siirtymän aikana.
Pienennä altistuspintaa
Jos useat sovellukset kutsuvat APIa, luo yksi avain per sovellus. Jos yksi kompromissoituu, sinun tarvitsee vain kumota tuo tietty avain pysäyttämättä muita. Saman periaatteen mukaan älä koskaan käytä tuotantoavainta uudelleen kehitysympäristössä: juuri siellä salaisuudet kiertävät kaikkein vapaimmin.
Seuraavaksi valvo käyttöä Consolen kautta, joka tarjoaa käyttölokit jokaiselle avaimelle. Äkillinen piikki tokeneissa tai kutsuissa tuntemattomasta IP-osoitteesta pitäisi laukaista välitön kierrätys odottamatta vahvistusta tapahtumasta.
Kolme viimeistä virhettä ansaitsee maininnan, koska kohtaamme niitä joka viikko. Julkiseen Git-arkistoon julkaistu avain pysyy luettavana historiassa, vaikka tiedosto poistettaisiin: ainoa kelvollinen vastaus on kumoaminen. Sähköpostilla tai pikaviestillä selväkielisenä lähetetty avain arkistoituu ikuisesti palvelimille, joita et hallitse. Ja vanhentunut tai kumottu avain, joka lojuu käyttöönotossa, tuottaa 401 Unauthorized -virheitä, joiden diagnosointi vie usein tunnin yksinkertaisesti siksi, että kukaan ei muistanut tarkistaa niitä.
Keskeiset asiat
- Luo avaimesi Mistral Consolen työtilasi API Keys -osiosta
- Tallenna ne yksinomaan ympäristömuuttujiin tai salaisuuksien hallintajärjestelmään
- Suorita säännöllinen kierrätys ja välitön kierrätys paljastumistilanteissa
- Luo yksi avain per sovellus rajoittaaksesi kompromissoitumisen vaikutuksia
- Lisää
.envaina tiedostoon.gitignore