Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Sugeneruokite ir apsaugokite savo API raktą

Paskaita 2 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Įgaliojimas, autentikuojantis jūsų užklausas
  2. Sugeneruokite savo pirmąjį raktą
  3. Saugokite jį niekada neįterpdami tiesiai į kodą
  4. Keiskite savo raktus
  5. Sumažinkite pažeidžiamumo plotą
  6. Svarbiausi punktai

Įgaliojimas, autentikuojantis jūsų užklausas

Jūsų API raktas autentikuoja kiekvieną užklausą, siunčiamą „Mistral“ modeliams: be jo joks kvietimas nėra priimamas. Įsivaizduokite jį kaip techninį slaptažodį, išskyrus tai, kad jis keliauja per kodą, konfigūracijos failus ir diegimo vamzdynus, todėl atsiduria daug daugiau vietų nei įprastas slaptažodis. Kiekvienas, kas jį turi, gali eikvoti jūsų kvotą ir generuoti išlaidas jūsų paskyroje.

Sugeneruokite savo pirmąjį raktą

„Mistral Console“ konsolėje atidarykite savo darbo sritį ir šoninėje juostoje eikite į skiltį API Keys. Spustelėkite Create new key ir suteikite jam aiškų pavadinimą, pavyzdžiui, dev-chatbot-mars-2026. Šis pavadinimas neturi techninės funkcijos, tačiau jis jums labai pravarts, kai sąraše gyvuos šeši raktai ir reikės anuliuoti tik vieną: „raktas 3“ nieko nepasakys, o dev-chatbot-mars-2026 pasakys viską.

Raktas rodomas tik vieną kartą – kūrimo momentu. Nedelsdami jį nukopijuokite ir saugiai paslėpkite. Jei langą uždarysite prieš nukopijuodami, jo atkurti nebebus galima: teks generuoti naują. „Mistral“ raktą sudaro priešdėlis ir ilga raidžių bei skaitmenų eilutė. Nepainiokite jo su savo darbo srities ID arba JWT žetonu: skirtingai nuo pastarojo, jis savaime negalioja baigtis ir lieka galiojantis, kol jį patys anuliuosite.

Saugokite jį niekada neįterpdami tiesiai į kodą

Auksinė taisyklė paprasta: niekada neįterpkite savo API rakto tiesiai į源代码. Tą dieną, kai tas failas atsidurs bendrinamoje saugykloje, raktas keliaus kartu su juo. Visada naudokite aplinkos kintamąjį.

„Linux“ ir „macOS“ sistemose deklaruokite jį terminale:

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

Uždarius terminalą šis kintamasis išnyksta; kad jis išliktų, pridėkite šią eilutę į savo ~/.bashrc, ~/.zshrc arba ~/.profile failą.

„Windows“ sistemoje „PowerShell“ ekvivalentas atrodo taip:

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

O kad išliktų perkrovus sesiją:

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

Programos projekte dažniausia praktika – sukurti .env failą šakniniame aplanke:

MISTRAL_API_KEY=your-api-key-here

Nedelsdami įtraukite .env į savo .gitignore – dar prieš pirmąjį įsipareigojimą (commit), o ne po jo. „Python“ kalboje python-dotenv biblioteka nuskaitytų šį failą ir paleidimo metu įterptų kintamuosius, suteikdama vietinio failo patogumą be paslapčių versijavimo rizikos.

Keiskite savo raktus

Pakeiskite raktą dėl trijų priežasčių. Nedelsiant, jei jis buvo kaip nors atskleistas: įsipareigojimas (commit) nusiųstas į viešą „Git“ saugyklą, skubus pranešimas „Slack“ arba pėdsakai serverio žurnaluose. Reguliariai gamybinėje aplinkoje – kas devyniasdešimt dienų yra pagrįstas dažnumas. Ir kai bendradarbis, turėjęs prieigą, palieka komandą – tą pačią dieną, kai jis grąžina savo leidimą.

Procedūra leidžia išvengti paslaugų sutrikimų, jei laikysitės tvarkos:

  1. Konsolėje sugeneruokite naują raktą
  2. Atnaujinkite aplinkos kintamąjį visuose savo diegimuose
  3. Patikrinkite, ar viskas veikia su nauju raktu
  4. Anuliuokite seną raktą tik po šio patikrinimo

Sukeitimas 3 ir 4 žingsniais yra klasikinė klaida: pirmiausia anuliuojate raktą „saugumo sumetimais“, o tada pastebite, kad pamiršta tarnyba vis dar naudojo senąjį raktą. Šis sukimas be простоя (zero-downtime rotation) užtikrina, kad perėjimo metu joks komponentas neveiks netinkamai.

Sumažinkite pažeidžiamumo plotą

Jei API kviečia kelios programos, sukurkite po vieną raktą kiekvienai programai. Jei vienas bus kompromituotas, teks anuliuoti tik tą konkretų raktą, nesustabdant kitų. Tuo pačiu principu niekada nenaudokite gamybinio rakto kūrimo aplinkoje: būtent ten paslaptys cirkuliuoja laisviausiai.

Be to, stebėkite naudojimą konsolėje, kuri pateikia kiekvieno rakto naudojimo žurnalus. Staigus žetonų arba kvietimų šuolis iš nežinomo IP adreso turėtų paskatinti nedelsiant pakeisti raktą, nelaukiant incidento patvirtinimo.

Verta paminėti tris galutines klaidas, nes su jomis susiduriame kiekvieną savaitę. Raktas, paskelbtas viešoje „Git“ saugykloje, istorijoje lieka skaitomas net ir ištrynus failą: vienintelis tinkamas atsakas – anuliacija. Raktas, išsiųstas atviru tekstu el. paštu arba momentinių žinučių programa, amžinai archyvuojamas serveriuose, kurių nekontroliuojate. O galiojimas baigęs arba anuliuotas raktas, likęs diegime, sukelia 401 Unauthorized klaidas, kurių diagnostika dažnai užtrunka valandą vien todėl, kad niekas nepagalvojo jų patikrinti.

Svarbiausi punktai

  • Generuokite raktus iš savo darbo srities skilties API Keys „Mistral Console“ konsolėje
  • Saugokite juos išimtinai aplinkos kintamuosiuose arba paslapčių valdyklėje
  • Atlikite reguliarų keitimą ir nedelsiant pakeiskite raktą įvykus atskleidimui
  • Sukurkite po vieną raktą kiekvienai programai, kad apribotumėte kompromitacijos poveikį
  • Visada įtraukite .env į savo .gitignore