Generiraj i osiguraj svoj API ključ
Na ovoj stranici
Vjerodajnica koja autentificira tvoje zahtjeve
Tvoj API ključ autentificira svaki zahtjev poslan Mistral modelima: bez njega nijedan poziv nije prihvaćen. Zamisli ga kao tehničku lozinku, osim što putuje kroz kod, konfiguracijske datoteke i pipelineove za deploy, što znači da završava na puno više mjesta nego standardna lozinka. Svatko tko ga posjeduje može trošiti tvoju kvotu i generirati troškove na tvom računu.
Generiraj svoj prvi ključ
U Mistral konzoli otvori svoj radni prostor i idi na odjeljak API Keys u bočnoj traci. Klikni Create new key i daj mu opisno ime, poput dev-chatbot-mars-2026. Ovo ime nema tehničku funkciju, ali će ti spasiti dan kada šest ključeva koegzistira na popisu, a trebaš opozvati samo jedan: “ključ 3” ti ne govori ništa, dok dev-chatbot-mars-2026 govori sve.
Ključ se prikazuje samo jednom, u trenutku stvaranja. Odmah ga kopiraj i pohrani na sigurno mjesto. Ako zatvoriš prozor prije kopiranja, nema načina da ga povratiš: moraš generirati novi. Mistral ključ sastoji se od prefiksa nakon kojeg slijedi duga alfanumerička niz. Nemoj ga brkati sa svojim ID-jem radnog prostora ili JWT tokenom: za razliku od potonjeg, on ne istječe sam od sebe i vrijedi dok ga ne opozoveš.
Pohrani ga bez ikakvog hardkodiranja
Zlatno je pravilo jednostavno: nikada ne hardkodiraj svoj API ključ u izvorni kod. Onog dana kada ta datoteka završi u zajedničkom repozitoriju, ključ ide s njom. Umjesto toga uvijek koristi varijablu okruženja.
Na Linuxu i macOSu deklariraj je u terminalu:
export MISTRAL_API_KEY="your-api-key-here"
Ova varijabla nestaje kada zatvoriš terminal; da bi bila trajna, dodaj redak u svoju datoteku ~/.bashrc, ~/.zshrc ili ~/.profile.
Na Windowsima ekvivalent u PowerShellu izgleda ovako:
$env:MISTRAL_API_KEY = "your-api-key-here"
A da preživi ponovno pokretanje sesije:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
U projektu aplikacije najčešća je praksa stvoriti .env datoteku u korijenu:
MISTRAL_API_KEY=your-api-key-here
Odmah dodaj .env u svoj .gitignore—prije prvog commita, a ne nakon. U Pythonu knjižnica python-dotenv čita ovu datoteku i ubacuje varijable pri pokretanju, pružajući ti pogodnost lokalne datoteke bez rizika od verzioniranja tajni.
Rotiraj svoje ključeve
Zamijeni ključ iz tri razloga. Odmah, ako je na bilo koji način otkriven: commit poslan u javni Git repozitorij, ishitrena poruka na Slacku ili tragovi u zapisnicima poslužitelja. Redovito u produkciji, pri čemu je svakih devedeset dana razuman ritam. I kada suradnik ode koji je imao pristup, istog dana kada vrati svoju iskaznicu.
Postupak izbjegava prekide usluge ako poštuješ redoslijed:
- Generiraj novi ključ u konzoli
- Ažuriraj varijablu okruženja u svim svojim deployevima
- Provjeri radi li sve s novim ključem
- Opozovi stari ključ tek nakon ove provjere
Zamjena koraka 3 i 4 klasična je pogreška: prvo opozoveš ključ “radi sigurnosti”, samo da bi otkrio/la da zaboravljena usluga još uvijek koristi stari ključ. Ova rotacija bez zastoja osigurava da nijedna komponenta ne zakaže tijekom prijelaza.
Smanji površinu izloženosti
Ako više aplikacija poziva API, stvori jedan ključ po aplikaciji. Ako je jedan kompromitiran, trebaš opozvati samo taj specifični ključ bez zaustavljanja ostalih. Po istom principu, nikada ne koristi produkcijski ključ u razvoju: to je upravo okruženje u kojem tajne najslobodnije cirkuliraju.
Zatim prati korištenje iz konzole, koja izlaže zapisnike korištenja za svaki ključ. Nagli skok u tokenima ili pozivima s nepoznate IP adrese trebao bi potaknuti trenutnu rotaciju, bez čekanja potvrde incidenta.
Tri konačne pogreške zaslužuju spomen jer ih susrećemo svaki tjedan. Ključ objavljen u javnom Git repozitoriju ostaje čitljiv u povijesti čak i nakon brisanja datoteke: jedini valjan odgovor je opoziv. Ključ poslan u čistom tekstu putem e-pošte ili instant poruka zauvijek se arhivira na poslužiteljima koje ne kontroliraš. A istekao ili opozvan ključ koji ostaje u deployu proizvodi pogreške 401 Unauthorized za čiju dijagnozu često treba sat vremena, jednostavno zato što se nitko nije sjetio provjeriti.
Ključne točke
- Generiraj svoje ključeve iz odjeljka API Keys svog radnog prostora u Mistral konzoli
- Pohrani ih isključivo u varijable okruženja ili upravitelja tajni
- Izvedi redovitu rotaciju i trenutnu rotaciju u slučaju otkrivanja
- Stvori jedan ključ po aplikaciji kako bi ograničio/la utjecaj kompromitacije
- Uvijek dodaj
.envu svoj.gitignore