Genereeri ja turva oma API-võti
Sellel lehel
Volikiri, mis autentib sinu päringuid
Sinu API-võti autentib iga Mistrali mudelitele saadetava päringu: ilma selleta ühtegi kutset vastu ei võeta. Mõtle sellele kui tehnilisele paroolile, välja arvatud see, et see liigub läbi koodi, konfiguratsioonifailide ja juurutamistorustike, mistõttu satub see palju rohkematesse kohtadesse kui tavaline parool. Igaüks, kellel see on, saab tarbida sinu kvooti ja tekitada sinu kontole kulusid.
Genereeri oma esimene võti
Ava Mistrali konsoolis oma tööruum ja mine külgribal asuvasse API Keys jaotisse. Klõpsa nuppu Create new key ja anna sellele kirjeldav nimi, näiteks dev-chatbot-mars-2026. Sellel nimel puudub tehniline funktsioon, kuid see päästab su olukorras, kus loendis eksisteerib kuus võtit ja pead tühistama vaid ühe: „võti 3“ ei ütle sulle midagi, samas kui dev-chatbot-mars-2026 ütleb kõik.
Võti kuvatakse ainult üks kord, loomise hetkel. Kopeeri see viivitamatult ja salvesta turvalisse kohta. Kui sulged akna enne kopeerimist, pole seda võimalik taastada: pead genereerima uue. Mistrali võti koosneb eesliitest ja sellele järgnevast pikast tähtnumbrilisest stringist. Ära aja seda segamini oma tööruumi ID-ga ega JWT-tokeniga: erinevalt viimasest ei aegu see iseenesest ja kehtib seni, kuni sa selle tühistad.
Salvesta see ilma kunagi koodi sisse kirjutamata
Kuldreegel on lihtne: ära kunagi kirjuta oma API-võtit otse lähtekoodi. Päeval, mil see fail satub jagatud hoidlasse, läheb võti kaasa. Kasuta selle asemel alati keskkonnamuutujat.
Linuxis ja macOSis deklareeri see terminalis:
export MISTRAL_API_KEY="your-api-key-here"
See muutuja kaob terminali sulgemisel; et muuta see püsivaks, lisa rida oma ~/.bashrc, ~/.zshrc või ~/.profile faili.
Windowsis näeb PowerShelli vaste välja selline:
$env:MISTRAL_API_KEY = "your-api-key-here"
Ja et see säiliks seansi taaskäivitamisel:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
Rakenduse projektis on kõige levinum tava luua juurkausta .env fail:
MISTRAL_API_KEY=your-api-key-here
Lisa .env oma .gitignore faili viivitamatult – enne esimest kommiiti, mitte pärast. Pythonis loeb python-dotenv teek selle faili ja süstib muutujad käivitamisel, pakkudes sulle kohaliku faili mugavust ilma saladuste versioonihalduse riskita.
Vaheta oma võtmeid regulaarselt
Vaheta võti kolmel põhjusel. Viivitamatult, kui see on mingil viisil avalikuks saanud: kommiit avalikku Git-hoidlasse saadetuna, kiirustades Slacki sõnumisse kirjutatuna või serveri logidesse jäänuna. Regulaarselt tootmiskeskkonnas, kus iga üheksakümne päeva tagant on mõistlik sagedus. Ja koostöölise lahkumisel, kellel oli ligipääs, samal päeval, kui ta oma pääsme tagastab.
Protseduur väldib teenuse katkemist, kui järgid õiget järjekorda:
- Genereeri konsoolis uus võti
- Uuenda keskkonnamuutujat kõigis oma juurutustes
- Veendu, et kõik toimib uue võtmega
- Tühista vana võti alles pärast seda kontrolli
Sammude 3 ja 4 vahetamine on klassikaline viga: tühistad esmalt „ohutuse mõttes“, et avastada hiljem, et unustatud teenus kasutas endiselt vana võtit. See null-seisakuga vahetus tagab, et ükski komponent ülemineku ajal ei rikneks.
Vähenda ohustatuse pinda
Kui mitu rakendust kutsub API-d, loo iga rakenduse jaoks üks võti. Kui üks neist kompromiteeritakse, pead tühistama vaid selle konkreetse võtme, peatamata teisi. Samal põhimõttel ära kunagi kasuta tootmisvõtit arenduses: see on täpselt see keskkond, kus saladused kõige vabamalt liiguvad.
Jälgi seejärel kasutust konsoolist, mis kuvab iga võtme kasutuslogisid. Tokenite või kutsete järsk tõus tundmatult IP-aadressilt peaks käivitama viivitamatu võtmevahetuse, ootamata intsidenti kinnitust.
Kolm viimast viga väärivad mainimist, sest kohtume nendega igal nädalal. Avalikku Git-hoidlasse avaldatud võti jääb ajalukku loetavaks isegi pärast faili kustutamist: ainus kehtiv reaktsioon on tühistamine. Selges tekstis e-posti või sõnumirakenduse kaudu saadetud võti arhiveeritakse igaveseks serverites, mida sa ei kontrolli. Ja aegunud või tühistatud võti, mis püsib juurutuses, tekitab 401 Unauthorized vigu, mille diagnoosimine võtab sageli tund aega lihtsalt seetõttu, et keegi ei mõelnud seda kontrollida.
Peamised punktid
- Genereeri oma võtmed Mistrali konsoolis oma tööruumi API Keys jaotisest
- Salvesta need ainult keskkonnamuutujatesse või saladuste haldurisse
- Teosta regulaarne vahetus ja viivitamatu vahetus ohustatuse korral
- Loo iga rakenduse jaoks üks võti, et piirata kompromiteerimise mõju
- Alati lisa
.envoma.gitignorefaili