Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Generovanie a zabezpečenie vášho API kľúča

Lekcia 2 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Údaj, ktorý overuje vaše požiadavky
  2. Vygenerujte si svoj prvý kľúč
  3. Ukladajte ho bez toho, aby ste ho niekedy vkladali priamo do kódu
  4. Rotácia vašich kľúčov
  5. Zníženie povrchu expozície
  6. Kľúčové poznatky

Údaj, ktorý overuje vaše požiadavky

Váš API kľúč overuje každú požiadavku odoslanú modelom Mistral: bez neho nie je žiadny volanie prijaté. Považujte ho za technické heslo, ktoré však cestuje cez kód, konfiguračné súbory a nasadzovacie pipeline, čo znamená, že sa dostane na oveľa viac miest než bežné heslo. Ktokoľvek, kto ho má, môže čerpať vašu kvótu a generovať náklady na vašom účte.

Vygenerujte si svoj prvý kľúč

V konzole Mistral otvorte svoj pracovný priestor a prejdite do sekcie API Keys v bočnom paneli. Kliknite na Create new key a pomenujte ho výstižne, napríklad dev-chatbot-mars-2026. Tento názov nemá žiadnu technickú funkciu, ale zachráni vám deň, keď bude v zozname koexistovať šesť kľúčov a budete musieť zrušiť platnosť len jedného: „kľúč 3“ vám nepovie nič, zatiaľ čo dev-chatbot-mars-2026 vám povie všetko.

Kľúč sa zobrazí iba raz, a to v momente vytvorenia. Okamžite ho skopírujte a uložte na bezpečné miesto. Ak okno zatvoríte pred skopírovaním, neexistuje spôsob, ako ho obnoviť: musíte vygenerovať nový. Kľúč Mistral sa skladá z prefixu nasledovaného dlhým alfanumerickým reťazcom. Nezamieňajte ho s ID vášho pracovného priestoru ani s JWT tokenom: na rozdiel od nich sám o sebe nevyprší a zostáva platný, kým ho nezrušíte.

Ukladajte ho bez toho, aby ste ho niekedy vkladali priamo do kódu

Zlaté pravidlo je jednoduché: nikdy nevkladajte svoj API kľúč priamo do zdrojového kódu. V deň, keď sa tento súbor dostane do zdieľaného repozitára, kľúč pôjde s ním. Vždy namiesto toho použite premennú prostredia.

V systémoch Linux a macOS ju deklarujte v termináli:

export MISTRAL_API_KEY="your-api-key-here"

Táto premenná zmizne po zatvorení terminálu; aby bola trvalá, pridajte tento riadok do súboru ~/.bashrc, ~/.zshrc alebo ~/.profile.

V systéme Windows ekvivalent v PowerShelli vyzerá takto:

$env:MISTRAL_API_KEY = "your-api-key-here"

A aby prežil reštart relácie:

[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")

V projekte aplikácie je najbežnejšou praxou vytvoriť súbor .env v koreňovom adresári:

MISTRAL_API_KEY=your-api-key-here

Okamžite pridajte .env do vášho .gitignore – pred prvým commitom, nie až po ňom. V Pythone knižnica python-dotenv číta tento súbor a injektuje premenné pri štarte, čo vám poskytuje pohodlie lokálneho súboru bez rizika verziovania tajomstiev.

Rotácia vašich kľúčov

Kľúč vymeňte z troch dôvodov. Okamžite, ak bol akýmkoľvek spôsobom odhalený: commit poslaný do verejného Git repozitára, unáhlená správa na Slacku alebo stopy v logoch servera. Pravidelne v produkcii, pričom každých deväťdesiat dní je rozumný interval. A keď odíde spolupracovník, ktorý mal prístup, a to v ten istý deň, keď vráti svoj preukaz.

Postup sa vyhne prerušeniu služby, ak dodržíte poradie:

  1. Vygenerujte nový kľúč v konzole
  2. Aktualizujte premennú prostredia vo všetkých vašich nasadeniach
  3. Overte, že všetko funguje s novým kľúčom
  4. Zrušte platnosť starého kľúča až po tomto overení

Výmena krokov 3 a 4 je klasická chyba: najprv zrušíte platnosť „pre istotu“, len aby ste zistili, že zabudnutá služba stále používala starý kľúč. Táto rotácia bez výpadku zabezpečuje, že počas prechodu zlyhá žiadna komponenta.

Zníženie povrchu expozície

Ak viacero aplikácií volá API, vytvorte jeden kľúč na aplikáciu. Ak je jeden kompromitovaný, musíte zrušiť platnosť len tohto konkrétneho kľúča bez zastavenia ostatných. Na rovnakom princípe nikdy nepoužívajte produkčný kľúč vo vývojovom prostredí: práve tam kolujú tajomstvá najvoľnejšie.

Ďalej sledujte využitie z konzoly, ktorá zobrazuje logy využitia pre každý kľúč. Náhlý nárast tokenov alebo volaní z neznámej IP adresy by mal spustiť okamžitú rotáciu, bez čakania na potvrdenie incidentu.

Tri posledné chyby si zaslúžia zmienku, pretože sa s nimi stretávame každý týždeň. Kľúč publikovaný vo verejnom Git repozitári zostáva čitateľný v histórii aj po vymazaní súboru: jedinou platnou odpoveďou je zrušenie platnosti. Kľúč odoslaný v čistom texte e-mailom alebo instantnou správou je navždy archivovaný na serveroch, ktoré nekontrolujete. A vypršaný alebo zrušený kľúč, ktorý zostane v nasadení, produkuje chyby 401 Unauthorized, ktorých diagnostika často trvá hodinu jednoducho preto, že nikoho nenapadlo skontrolovať.

Kľúčové poznatky

  • Generujte svoje kľúče zo sekcie API Keys vo vašom pracovnom priestore v konzole Mistral
  • Ukladajte ich výlučne do premenných prostredia alebo správcu tajomstiev
  • Vykonávajte pravidelnú rotáciu a okamžitú rotáciu v prípade odhalenia
  • Vytvorte jeden kľúč na aplikáciu, aby ste obmedzili dopad kompromitácie
  • Vždy pridajte .env do vášho .gitignore