Ģenerē un nodrošini savu API atslēgu
Šajā lapā
Akreditācijas dati, kas autentificē tavus pieprasījumus
Tava API atslēga autentificē katru pieprasījumu, kas nosūtīts uz Mistral modeļiem: bez tās neviens izsaukums netiek pieņemts. Uztver to kā tehnisku paroli, izņemot to, ka tā ceļo caur kodu, konfigurācijas failiem un izvietošanas cauruļvadiem, kas nozīmē, ka tā nonāk daudz vairāk vietās nekā standarta parole. Ikviens, kam tā ir, var izmantot tavu kvotu un ģenerēt izmaksas tavā kontā.
Ģenerē savu pirmo atslēgu
Mistral Console atver savu darbvietu un dodieties uz sānjoslas sadaļu API Keys. Noklikšķini uz Create new key un piešķir tai aprakstošu nosaukumu, piemēram, dev-chatbot-mars-2026. Šim nosaukumam nav tehniskas funkcijas, taču tas tev izglābs dienu, kad sarakstā līdzās pastāvēs sešas atslēgas un tev būs jāatsauc tikai viena: „key 3” tev nepasaka neko, savukārt dev-chatbot-mars-2026 pastāsta visu.
Atslēga tiek parādīta tikai vienreiz – tās izveides brīdī. Nekavējoties nokopē to un glabā drošā vietā. Ja aizvērsi logu pirms kopēšanas, to vairs nebūs iespējams atgūt: būs jāģenerē jauna. Mistral atslēga sastāv no prefiksa, kam seko gara alfanumēriska virkne. Nejauc to ar savu darbvietas ID vai JWT žetonu: atšķirībā no pēdējā tā nebeidzas pati no sevis un paliek spēkā, līdz to atsauci.
Glabā to, nekad neiekodējot tieši kodā
Zelta likums ir vienkāršs: nekad neiekodē savu API atslēgu pirmkoda failos. Dienā, kad šis fails nonāk koplietojamā repozitorijā, atslēga dodas līdzi. Tā vietā vienmēr izmanto vides mainīgo.
Linux un macOS sistēmās deklarē to terminālī:
export MISTRAL_API_KEY="your-api-key-here"
Šis mainīgais pazūd, aizverot termināli; lai tas saglabātos pastāvīgi, pievieno rindu savam ~/.bashrc, ~/.zshrc vai ~/.profile failam.
Windows sistēmā PowerShell ekvivalents izskatās šādi:
$env:MISTRAL_API_KEY = "your-api-key-here"
Un lai tas saglabātos pēc sesijas restarta:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
Lietojumprogrammas projektā visizplatītākā prakse ir izveidot .env failu saknes direktorijā:
MISTRAL_API_KEY=your-api-key-here
Nekavējoties pievieno .env savam .gitignore – pirms pirmā commit, nevis pēc tā. Python valodā bibliotēka python-dotenv nolasa šo failu un ievada mainīgos startēšanas brīdī, nodrošinot lokālā faila ērtības bez noslēpumu versiju kontroles riska.
Rotē savas atslēgas
Nomaini atslēgu trīs iemeslu dēļ. Nekavējoties, ja tā jebkādā veidā ir tikusi pakļauta riskam: commit, kas nosūtīts uz publisku Git repozitoriju, steigā rakstīts Slack ziņojums vai pēdas servera žurnālos. Regulāri ražošanas vidē, kur saprātīgs biežums ir reizi deviņdesmit dienās. Un kad aiziet sadarbības partneris, kam bija piekļuve, tajā pašā dienā, kad viņš nodod savu piekļuves karti.
Procedūra izvairās no pakalpojumu pārtraukumiem, ja ievēro secību:
-
Ģenerē jaunu atslēgu Console
-
Atjaunini vides mainīgo visos savos izvietojumos
-
Pārliecinies, ka viss strādā ar jauno atslēgu
-
Atsauc veco atslēgu tikai pēc šīs pārbaudes
-
un 4. soļa samainīšana vietām ir klasiska kļūda: tu vispirms atsauc atslēgu „drošības pēc”, tikai lai atklātu, ka aizmirsts serviss joprojām izmantoja veco atslēgu. Šī rotācija bez dīkstāves nodrošina, ka pārejas laikā neviens komponents neizdodas.
Samazini pakļautības virsmu
Ja API izsauc vairākas lietotnes, izveido vienu atslēgu katrai lietotnei. Ja viena tiek apdraudēta, tev jāatsauc tikai šī konkrētā atslēga, neapturot pārējās. Pēc tāda paša principa nekad atkārtoti neizmanto ražošanas atslēgu izstrādes vidē: tieši tur noslēpumi cirkulē visbrīvāk.
Tālāk uzraugi lietojumu no Console, kas nodrošina lietojuma žurnālus katrai atslēgai. Pēkšņs tokena vai izsaukumu pieaugums no nezināmas IP adreses ir nekavējoties jārotē, negaidot incidenta apstiprinājumu.
Ir vērts pieminēt trīs galīgās kļūdas, jo mēs ar tām saskaramies katru nedēļu. Atslēga, kas publicēta publiskā Git repozitorijā, paliek lasāma vēsturē pat pēc faila dzēšanas: vienīgā pareizā reakcija ir atsaukšana. Atslēga, kas nosūtīta nešifrētā veidā pa e-pastu vai tūlītējās ziņojumapmaiņas sistēmu, tiek arhivēta uz visiem laikiem serveros, kurus tu nekontrolē. Un beidzies vai atsaukta atslēga, kas palikusi izvietojumā, rada 401 Unauthorized kļūdas, kuru diagnosticēšana bieži vien prasa stundu vienkārši tāpēc, ka neviens nepadomāja to pārbaudīt.
Galvenās atziņas
- Ģenerē savas atslēgas no savas darbvietas sadaļas API Keys Mistral Console
- Glabā tās ekskluzīvi vides mainīgajos vai noslēpumu pārvaldniekā
- Veic regulāru rotāciju un tūlītēju rotāciju gadījumā, ja tā tikusi pakļauta riskam
- Izveido vienu atslēgu katrai lietotnei, lai ierobežotu kompromitācijas ietekmi
- Vienmēr pievieno
.envsavam.gitignore