Премини към основното съдържание
Български— Изберете език
Меню

Генерирайте и защитете своя API ключ

Урок 2 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Удостоверителните данни, които автентикират вашите заявки
  2. Генерирайте първия си ключ
  3. Съхранявайте го, без никога да го вграждате в кода
  4. Ротирайте ключовете си
  5. Намалете повърхността на експозиция
  6. Ключови изводи

Удостоверителните данни, които автентикират вашите заявки

Вашият API ключ автентикира всяка заявка, изпратена до моделите на Mistral: без него никое извикване не се приема. Разглеждайте го като техническа парола, с тази разлика, че той пътува през код, конфигурационни файлове и тръбопроводи за внедряване, което означава, че попада в много повече места от една стандартна парола. Всеки, който го притежава, може да изразходи вашата квота и да генерира разходи по вашата сметка.

Генерирайте първия си ключ

В конзолата на Mistral отворете работното си пространство и навигирайте до секцията API Keys в страничната лента. Кликнете върху Create new key и му дайте описателно име, например dev-chatbot-mars-2026. Това име няма техническа функция, но ще ви спаси деня, когато шест ключа съществуват едновременно в списъка и трябва да анулирате само един: „ключ 3“ не ви казва нищо, докато dev-chatbot-mars-2026 ви казва всичко.

Ключът се показва само веднъж, в момента на създаването му. Копирайте го незабавно и го съхранете на сигурно място. Ако затворите прозореца, преди да го копирате, няма начин да го възстановите: трябва да генерирате нов. Ключът на Mistral се състои от префикс, последван от дълъг алфанумеричен низ. Не го бъркайте с идентификатора на работното пространство или JWT токен: за разлика от последния, той не изтича автоматично и остава валиден, докато не го анулирате.

Съхранявайте го, без никога да го вграждате в кода

Златното правило е просто: никога не вграждайте API ключа си в изходния код. В деня, в който този файл попадне в споделено хранилище, ключът отива с него. Винаги използвайте променлива на средата вместо това.

В Linux и macOS я декларирайте в терминала:

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

Тази променлива изчезва, когато затворите терминала; за да я направите постоянна, добавете реда към вашия файл ~/.bashrc, ~/.zshrc или ~/.profile.

В Windows еквивалентът в PowerShell изглежда така:

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

И за да оцелее след рестартиране на сесията:

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

В рамките на проект за приложение най-честата практика е създаването на файл .env в кореновата директория:

MISTRAL_API_KEY=your-api-key-here

Добавете .env към вашия .gitignore незабавно – преди първия си комит, а не след него. В Python библиотеката python-dotenv чете този файл и инжектира променливите при стартиране, осигурявайки удобството на локален файл без риска от версиониране на тайни.

Ротирайте ключовете си

Заменете ключ по три причини. Незабавно, ако е бил разкрит по какъвто и да е начин: комит, изпратен в публично Git хранилище, прибързано съобщение в Slack или следи в сървърните логове. Редовно в производствена среда, като всеки деветдесет дни е разумен ритъм. И когато сътрудник напусне, който е имал достъп, в същия ден, в който върне пропуска си.

Процедурата избягва прекъсване на услугата, ако спазвате реда:

  1. Генерирайте нов ключ в конзолата
  2. Актуализирайте променливата на средата във всички ваши внедрявания
  3. Уверете се, че всичко работи с новия ключ
  4. Анулирайте стария ключ едва след тази проверка

Размяната на стъпки 3 и 4 е класическата грешка: анулирате първо „за сигурност“, само за да откриете, че забравен сервис все още използва стария ключ. Тази ротация без престой гарантира, че никой компонент няма да се провали по време на прехода.

Намалете повърхността на експозиция

Ако множество приложения извикват API, създайте по един ключ за всяко приложение. Ако едно бъде компрометирано, трябва да анулирате само този конкретен ключ, без да спирате другите. По същия принцип никога не преизползвайте производствен ключ в среда за разработка: това е точно средата, в която тайните циркулират най-свободно.

След това наблюдавайте използването от конзолата, която предоставя логове за употреба за всеки ключ. Внезапен скок в токени или обаждания от непознат IP адрес трябва да задейства незабавна ротация, без да чакате потвърждение за инцидент.

Три крайни грешки заслужават споменаване, защото ги срещаме всяка седмица. Ключ, публикуван в публично Git хранилище, остава четим в историята дори след изтриването на файла: единственият валиден отговор е анулиране. Ключ, изпратен в явен текст чрез имейл или незабавно съобщение, се архивира завинаги на сървъри, които не контролирате. И изтекъл или анулиран ключ, останал във внедряване, произвежда грешки 401 Unauthorized, за чието диагностициране често е необходим един час, просто защото никой не се е сетил да провери.

Ключови изводи

  • Генерирайте ключовете си от секцията API Keys на вашето работно пространство в конзолата на Mistral
  • Съхранявайте ги изключително в променливи на средата или мениджър на тайни
  • Извършвайте редовна ротация и незабавна ротация в случай на разкриване
  • Създавайте по един ключ за всяко приложение, за да ограничите въздействието при компрометиране
  • Винаги добавяйте .env към вашия .gitignore