Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Generování a zabezpečení vašeho API klíče

Lekce 2 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Údaj, který autentizuje vaše požadavky
  2. Vygenerujte svůj první klíč
  3. Ukládejte jej, aniž byste jej kdy tvrdě kódovali
  4. Rotace vašich klíčů
  5. Snížení plochy expozice
  6. Klíčové poznatky

Údaj, který autentizuje vaše požadavky

Váš API klíč autentizuje každý požadavek odeslaný modelům Mistral: bez něj není žádný volání přijato. Berte ho jako technické heslo, které však cestuje skrze kód, konfigurační soubory a nasazovací pipeline, což znamená, že se ocitne na mnohem více místech než běžné heslo. Kdokoli, kdo ho má, může čerpat vaši kvótu a generovat náklady na vašem účtu.

Vygenerujte svůj první klíč

V konzoli Mistral otevřete svůj pracovní prostor a přejděte do sekce API Keys v postranním panelu. Klikněte na Create new key a zadejte mu popisný název, například dev-chatbot-mars-2026. Tento název nemá žádnou technickou funkci, ale zachrání vám život, až bude v seznamu existovat šest klíčů a budete muset zrušit pouze jeden: „klíč 3“ vám nic neřekne, zatímco dev-chatbot-mars-2026 vám řekne vše.

Klíč se zobrazí pouze jednou, a to v okamžiku vytvoření. Okamžitě jej zkopírujte a uložte na bezpečné místo. Pokud okno před kopírováním zavřete, neexistuje způsob, jak jej získat zpět: musíte vygenerovat nový. Klíč Mistral se skládá z prefixu následovaného dlouhým alfanumerickým řetězcem. Nezaměňujte jej s ID pracovního prostoru nebo tokenem JWT: na rozdíl od nich sám o sobě nevyprší a zůstává platný, dokud jej nezrušíte.

Ukládejte jej, aniž byste jej kdy tvrdě kódovali

Zlaté pravidlo je jednoduché: nikdy nekódujte svůj API klíč přímo do zdrojového kódu. V den, kdy se tento soubor dostane do sdíleného repozitáře, půjde s ním i klíč. Vždy místo toho použijte proměnnou prostředí.

Na Linuxu a macOS ji deklarujte v terminálu:

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

Tato proměnná zmizí po zavření terminálu; aby byla trvalá, přidejte řádek do souboru ~/.bashrc, ~/.zshrc nebo ~/.profile.

Na Windows vypadá ekvivalent v PowerShellu takto:

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

A aby přežila restart relace:

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

V projektu aplikace je nejčastější praxí vytvořit soubor .env v kořenovém adresáři:

MISTRAL_API_KEY=your-api-key-here

Okamžitě přidejte .env do vašeho .gitignore – před prvním committem, ne až po něm. V Pythonu knihovna python-dotenv tento soubor čte a injektuje proměnné při spuštění, což vám poskytuje pohodlí lokálního souboru bez rizika verzování tajných údajů.

Rotace vašich klíčů

Klíč vyměňte ze tří důvodů. Okamžitě, pokud byl jakýmkoli způsobem prozrazen: commit odeslaný do veřejného Git repozitáře, unáhlená zpráva na Slacku nebo stopy v logách serveru. Pravidelně v produkčním prostředí, přičemž každých devadesát dní je rozumný rytmus. A když odejde spolupracovník, který měl přístup, a to ve stejný den, kdy vrátí svůj průkaz.

Postup se vyhne přerušení služby, pokud budete respektovat pořadí:

  1. Vygenerujte nový klíč v konzoli
  2. Aktualizujte proměnnou prostředí ve všech vašich nasazeních
  3. Ověřte, že vše funguje s novým klíčem
  4. Zrušte starý klíč až po tomto ověření

Prohození kroků 3 a 4 je klasická chyba: nejprve klíč zrušíte „pro jistotu“, jen abyste zjistili, že zapomenutá služba stále používala starý klíč. Tato rotace bez výpadků zajišťuje, že během přechodu žádná komponenta neselhá.

Snížení plochy expozice

Pokud API volá více aplikací, vytvořte jeden klíč na aplikaci. Pokud je jeden kompromitován, stačí zrušit pouze tento konkrétní klíč, aniž byste zastavili ostatní. Na stejném principu nikdy nepoužívejte produkční klíč ve vývojovém prostředí: to je přesně prostředí, kde tajemství cirkulují nejvolněji.

Dále sledujte využití z konzole, která zpřístupňuje logy využití pro každý klíč. Náhlý nárůst tokenů nebo volání z neznámé IP adresy by měl spustit okamžitou rotaci, bez čekání na potvrzení incidentu.

Tři poslední chyby si zaslouží zmínku, protože se s nimi setkáváme každý týden. Klíč publikovaný do veřejného Git repozitáře zůstává čitelný v historii i po smazání souboru: jedinou platnou reakcí je jeho zrušení. Klíč odeslaný v čistém textu prostřednictvím e-mailu nebo instant messagingu je navždy archivován na serverech, které nekontrolujete. A vypršelý nebo zrušený klíč přetrvávající v nasazení produkuje chyby 401 Unauthorized, jejichž diagnostika často trvá hodinu pouze proto, že nikoho nenapadlo to zkontrolovat.

Klíčové poznatky

  • Generujte své klíče ze sekce API Keys vašeho pracovního prostoru v konzoli Mistral
  • Ukládejte je výhradně do proměnných prostředí nebo správce tajných údajů
  • Provádějte pravidelnou rotaci a okamžitou rotaci v případě prozrazení
  • Vytvářejte jeden klíč na aplikaci, abyste omezili dopad kompromitace
  • Vždy přidejte .env do vašeho .gitignore