Salt la conținutul principal
Română— Alege o limbă
Meniu

Generați și securizați cheia dvs. API

Lecția 2 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Credencialul care autentifică cererile dumneavoastră
  2. Generați prima dvs. cheie
  3. Stocați-o fără a o codifica niciodată direct
  4. Rotați cheile
  5. Reduceți suprafața de expunere
  6. Puncte cheie

Credencialul care autentifică cererile dumneavoastră

Cheia dvs. API autentifică fiecare cerere trimisă către modelele Mistral: fără ea, nicio apelare nu este acceptată. Gândiți-vă la ea ca la o parolă tehnică, cu excepția faptului că aceasta circulă prin cod, fișiere de configurare și pipeline-uri de implementare, ajungând astfel în mult mai multe locuri decât o parolă standard. Oricine o deține poate consuma cota dvs. și genera costuri în contul dumneavoastră.

Generați prima dvs. cheie

În Consola Mistral, deschideți spațiul de lucru și navigați la secțiunea API Keys din bara laterală. Faceți clic pe Create new key și atribuiți-i un nume descriptiv, cum ar fi dev-chatbot-mars-2026. Acest nume nu are nicio funcție tehnică, dar vă va salva ziua când șase chei coexistă în listă și trebuie să revocați doar una: „key 3“ nu vă spune nimic, în timp ce dev-chatbot-mars-2026 vă spune totul.

Cheia se afișează o singură dată, în momentul creării. Copiați-o imediat și stocați-o într-un loc sigur. Dacă închideți fereastra înainte de a o copia, nu există nicio modalitate de a o recupera: trebuie să generați una nouă. O cheie Mistral constă dintr-un prefix urmat de un șir alfanumeric lung. Nu o confundați cu ID-ul spațiului de lucru sau cu un token JWT: spre deosebire de acesta din urmă, ea nu expiră automat și rămâne valabilă până când o revocați.

Stocați-o fără a o codifica niciodată direct

Regula de aur este simplă: nu codificați niciodată cheia API direct în codul sursă. În ziua în care acel fișier ajunge într-un repository partajat, cheia merge odată cu el. Folosiți întotdeauna o variabilă de mediu în schimb.

Pe Linux și macOS, declarați-o în terminal:

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

Această variabilă dispare când închideți terminalul; pentru a o face persistentă, adăugați linia în fișierul dvs. ~/.bashrc, ~/.zshrc sau ~/.profile.

Pe Windows, echivalentul în PowerShell arată astfel:

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

Și pentru a supraviețui unei reporniri a sesiunii:

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

Într-un proiect de aplicație, cea mai comună practică este crearea unui fișier .env la rădăcina proiectului:

MISTRAL_API_KEY=your-api-key-here

Adăugați .env în .gitignore imediat—înainte de primul commit, nu după. În Python, biblioteca python-dotenv citește acest fișier și injectează variabilele la pornire, oferindu-vă confortul unui fișier local fără riscul de a versiona secrete.

Rotați cheile

Înlocuiți o cheie din trei motive. Imediat, dacă a fost expusă în orice mod: un commit împins într-un repository Git public, un mesaj Slack grabnic sau urme în jurnalele serverului. Regular în producție, fiecare nouăzeci de zile fiind un ritm rezonabil. Și când un colaborator pleacă și a avut acces, în aceeași zi în care își returnează legitimația.

Procedura evită întreruperea serviciului dacă respectați ordinea:

  1. Generați o nouă cheie în Consolă
  2. Actualizați variabila de mediu în toate implementările dumneavoastră
  3. Verificați dacă totul funcționează cu noua cheie
  4. Revocați vechea cheie doar după această verificare

Inversarea pașilor 3 și 4 este greșeala clasică: revocați mai întâi „pentru siguranță“, doar pentru a descoperi că un serviciu uitat folosea încă vechea cheie. Această rotație fără timp de inactivitate asigură că nicio componentă nu eșuează în timpul tranziției.

Reduceți suprafața de expunere

Dacă mai multe aplicații apelează API-ul, creați o cheie per aplicație. Dacă una este compromisă, trebuie doar să revocați acea cheie specifică fără a opri celelalte. Pe același principiu, nu reutilizați niciodată o cheie de producție în dezvoltare: acesta este chiar mediul în care secretele circulă cel mai liber.

În continuare, monitorizați utilizarea din Consolă, care expune jurnalele de utilizare pentru fiecare cheie. O creștere bruscă a tokenilor sau a apelurilor de la o adresă IP necunoscută ar trebui să declanșeze o rotație imediată, fără a aștepta confirmarea incidentului.

Trei erori finale merită menționate deoarece le întâlnim în fiecare săptămână. O cheie publicată într-un repository Git public rămâne lizibilă în istoric chiar și după ștergerea fișierului: singurul răspuns valid este revocarea. O cheie trimisă în text clar prin e-mail sau mesagerie instantanee este arhivată pentru totdeauna pe servere pe care nu le controlați. Și o cheie expirată sau revocată rămasă într-o implementare produce erori 401 Unauthorized care adesea necesită o oră pentru diagnosticare, simplu pentru că nimeni nu s-a gândit să verifice.

Puncte cheie

  • Generați cheile din secțiunea API Keys a spațiului de lucru în Consola Mistral
  • Stocați-le exclusiv în variabile de mediu sau într-un manager de secrete
  • Efectuați o rotație regulată și o rotație imediată în caz de expunere
  • Creați o cheie per aplicație pentru a limita impactul unei compromiteri
  • Adăugați întotdeauna .env în .gitignore