Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

API-kulcsod generálása és biztosítása

2. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A hitelesítő adat, amely jóváhagyja a kéréseidet
  2. Generáld az első kulcsodat
  3. Tárold soha nem beégetve a kódba
  4. Forgassd a kulcsaidat
  5. Csökkentsd a kitettségi felületet
  6. Főbb megállapítások

A hitelesítő adat, amely jóváhagyja a kéréseidet

Az API-kulcsod hitelesíti a Mistral modelleknek küldött minden egyes kérést: enélkül egyetlen hívást sem fogad el a rendszer. Tekints rá technikai jelszóként, azzal a különbséggel, hogy ez kódokon, konfigurációs fájlokon és telepítési folyamatokon (pipeline) utazik, így sokkal több helyre kerül, mint egy hagyományos jelszó. Bárki, aki megszerezte, felhasználhatja a kvótádat és költségeket generálhat a fiókodon.

Generáld az első kulcsodat

A Mistral Console-ban nyisd meg a munkaterületedet, majd a oldalsávon navigálj az API Keys szekcióhoz. Kattints a Create new key gombra, és adj neki egy leíró nevet, például: dev-chatbot-mars-2026. Ennek a névnek nincs technikai funkciója, de életmentő lesz, ha hat kulcs coexistál a listában, és csak egyet kell visszavonnod: a „3-as kulcs“ semmit nem mond, míg a dev-chatbot-mars-2026 mindent elárul.

A kulcs csak egyszer jelenik meg, a létrehozás pillanatában. Azonnal másold ki, és tárold biztonságos helyen. Ha bezárod az ablakot másolás előtt, nincs mód a visszaállításra: újat kell generálnod. Egy Mistral kulcs egy előtagból és egy hosszú alfanumerikus karakterláncból áll. Ne keverd össze a munkaterület azonosítójával (workspace ID) vagy egy JWT tokennel: utóbbival ellentétben ez nem jár le automatikusan, és addig érvényes, amíg vissza nem vonod.

Tárold soha nem beégetve a kódba

Az aranyszabály egyszerű: soha ne égesd be az API-kulcsodat a forráskódba. Abban a pillanatban, hogy ez a fájl felkerül egy megosztott tárolóba, a kulcs is vele megy. Mindig környezeti változót használj helyette.

Linux és macOS rendszeren deklarálhatod a terminálban:

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

Ez a változó eltűnik, amikor bezárod a terminált; hogy tartós legyen, add hozzá a sort a ~/.bashrc, ~/.zshrc vagy ~/.profile fájlodhoz.

Windows rendszeren a PowerShell ekvivalens így néz ki:

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

Hogy túlélje a munkamenet újraindítását:

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

Egy alkalmazásprojektben a leggyakoribb gyakorlat egy .env fájl létrehozása a gyökérkönyvtárban:

MISTRAL_API_KEY=your-api-key-here

Azonnal add hozzá a .env fájlt a .gitignore listádhoz – még az első commit előtt, ne utána. Pythonban a python-dotenv könyvtár beolvassa ezt a fájlt, és induláskor betölti a változókat, így élvezheted a helyi fájl kényelmét anélkül, hogy kockáztatnád a titkos adatok verziókezelését.

Forgassd a kulcsaidat

Három okból cseréld le a kulcsot. Azonnal, ha bármilyen módon nyilvánosságra került: egy nyilvános Git tárolóba pusholt commit, egy elhamarkodott Slack üzenet vagy nyomok a szervernaplókban. Rendszeresen éles környezetben (production), ahol a kilencven napos ciklus ésszerű ütemezés. És amikor egy együttműködő távozik, aki hozzáféréssel rendelkezett, még azon a napon, amikor visszaadja a belépőkártyáját.

Az eljárás elkerüli a szolgáltatás megszakadását, ha betartod a sorrendet:

  1. Generálj egy új kulcsot a Console-ban
  2. Frissítsd a környezeti változót az összes telepítésedben
  3. Ellenőrizd, hogy minden működik-e az új kulccsal
  4. Csak ez ellenőrzés után vond vissza a régi kulcsot

A 3. és 4. lépés felcserélése a klasszikus hiba: előbb vonod vissza „biztonsági okokból“, csak hogy később fedezd fel: egy elfelejtett szolgáltatás még mindig a régi kulcsot használta. Ez a kiesésmentes (zero-downtime) rotáció biztosítja, hogy egyetlen komponens se álljon le az átállás során.

Csökkentsd a kitettségi felületet

Ha több alkalmazás hívja meg az API-t, hozz létre egy kulcsot alkalmazásonként. Ha az egyiket feltörik, csak azt a specifikus kulcsot kell visszavonnod, anélkül, hogy leállítanád a többit. Ugyanezen az elven alapul, hogy soha ne használj újra éles környezeti kulcsot fejlesztés során: pontosan ez az a környezet, ahol a titkos adatok a legszabadabban keringenek.

Ezt követően figyeld a használatot a Console-ból, amely minden kulcshoz használati naplókat biztosít. A tokenek vagy hívások hirtelen megugrása egy ismeretlen IP-címről azonnali kulcscserét kell, hogy kiváltson, várakozás nélkül az incidens megerősítésére.

Három utolsó hibát érdemes megemlíteni, mert hetente találkozunk velük. Egy nyilvános Git tárolóba publikált kulcs a történetben (history) olvasható marad akkor is, ha a fájlt törölték: az egyetlen érvényes reakció a visszavonás. Egy e-mailben vagy azonnali üzenetküldőben tiszta szöveggel elküldött kulcs örökre archiválva marad olyan szervereken, amelyeket nem te irányítasz. És egy lejárt vagy visszavont kulcs, amely bent ragad egy telepítésben, 401 Unauthorized hibákat produkál, amelyek diagnosztizálása gyakran egy órát vesz igénybe, egyszerűen azért, mert senkinek nem jutott eszébe ellenőrizni.

Főbb megállapítások

  • Generáld a kulcsaidat a Mistral Console munkaterületed API Keys szekciójából
  • Tárold őket kizárólag környezeti változókban vagy titokkezelőben (secrets manager)
  • Végezz rendszeres rotációt, és azonnali cserét feltárás esetén
  • Hozz létre egy kulcsot alkalmazásonként a kompromittálódás hatásának korlátozására
  • Mindig add hozzá a .env fájlt a .gitignore listádhoz