Przejdź do głównej treści
Polski— Wybierz język
Menu

Generowanie i zabezpieczanie klucza API

Lekcja 2 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Poświadczenie uwierzytelniające Twoje żądania
  2. Wygeneruj swój pierwszy klucz
  3. Przechowuj go, nigdy nie hardkodując
  4. Rotacja kluczy
  5. Zmniejsz powierzchnię ekspozycji
  6. Kluczowe wnioski

Poświadczenie uwierzytelniające Twoje żądania

Twój klucz API uwierzytelnia każde żądanie wysyłane do modeli Mistral: bez niego żadne wywołanie nie zostanie zaakceptowane. Traktuj go jak hasło techniczne, z tą różnicą, że podróżuje przez kod, pliki konfiguracyjne i potoki wdrażania, co oznacza, że trafia do znacznie większej liczby miejsc niż standardowe hasło. Każdy, kto go posiada, może zużywać Twój limit i generować koszty na Twoim koncie.

Wygeneruj swój pierwszy klucz

W Konsoli Mistral otwórz swoją przestrzeń roboczą i przejdź do sekcji API Keys na pasku bocznym. Kliknij Create new key i nadaj mu opisową nazwę, np. dev-chatbot-mars-2026. Nazwa ta nie pełni funkcji technicznej, ale uratuje Ci skórę, gdy na liście będzie współistnieć sześć kluczy, a Ty będziesz musiał unieważnić tylko jeden: „klucz 3“ nic Ci nie powie, podczas gdy dev-chatbot-mars-2026 mówi wszystko.

Klucz wyświetla się tylko raz, w momencie tworzenia. Skopiuj go natychmiast i przechowuj w bezpiecznym miejscu. Jeśli zamkniesz okno przed skopiowaniem, nie ma sposobu, aby go odzyskać: musisz wygenerować nowy. Klucz Mistral składa się z prefiksu, po którym następuje długi ciąg alfanumeryczny. Nie myl go z identyfikatorem przestrzeni roboczej ani tokenem JWT: w przeciwieństwie do tego drugiego, nie wygasa samoczynnie i pozostaje ważny aż do momentu jego unieważnienia.

Przechowuj go, nigdy nie hardkodując

Złota zasada jest prosta: nigdy nie hardkoduj klucza API w kodzie źródłowym. W dniu, w którym ten plik trafi do wspólnego repozytorium, klucz podąży za nim. Zawsze używaj zamiast tego zmiennej środowiskowej.

W systemach Linux i macOS zadeklaruj ją w terminalu:

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

Ta zmienna znika po zamknięciu terminala; aby była trwała, dodaj ten wiersz do pliku ~/.bashrc, ~/.zshrc lub ~/.profile.

W systemie Windows odpowiednik w PowerShell wygląda następująco:

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

A aby przetrwała ponowne uruchomienie sesji:

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

W projekcie aplikacji najczęstszą praktyką jest utworzenie pliku .env w katalogu głównym:

MISTRAL_API_KEY=your-api-key-here

Dodaj .env do swojego .gitignore natychmiast – przed pierwszym commitem, a nie po nim. W Pythonie biblioteka python-dotenv odczytuje ten plik i wstrzykuje zmienne podczas uruchamiania, dając Ci wygodę lokalnego pliku bez ryzyka wersjonowania tajemnic.

Rotacja kluczy

Wymieniaj klucz z trzech powodów. Natychmiast, jeśli został w jakikolwiek sposób ujawniony: commit wypchnięty do publicznego repozytorium Git, pochopna wiadomość na Slacku lub ślady w logach serwera. Regularnie w środowisku produkcyjnym, przy czym rozsądnym rytmem jest wymiana co dziewięćdziesiąt dni. Oraz gdy współpracownik odchodzi, mając dostęp – tego samego dnia, w którym zwraca swoją przepustkę.

Procedura ta pozwala uniknąć przerw w działaniu usługi, jeśli zachowasz odpowiednią kolejność:

  1. Wygeneruj nowy klucz w Konsoli
  2. Zaktualizuj zmienną środowiskową we wszystkich wdrożeniach
  3. Zweryfikuj, czy wszystko działa z nowym kluczem
  4. Unieważnij stary klucz dopiero po tej weryfikacji

Zamiana miejscami kroków 3 i 4 to klasyczny błąd: unieważniasz klucz najpierw „dla bezpieczeństwa“, tylko po to, by odkryć, że zapomniana usługa nadal korzystała ze starego klucza. Taka rotacja bez przestoju zapewnia, że żaden komponent nie ulegnie awarii podczas przejścia.

Zmniejsz powierzchnię ekspozycji

Jeśli wiele aplikacji wywołuje API, utwórz jeden klucz na aplikację. Jeśli jeden z nich zostanie skompromitowany, musisz unieważnić tylko ten konkretny klucz, nie zatrzymując działania pozostałych. Zgodnie z tą samą zasadą, nigdy nie używaj klucza produkcyjnego w środowisku deweloperskim: to właśnie tam tajemnice krążą najswobodniej.

Następnie monitoruj użycie z poziomu Konsoli, która udostępnia logi użycia dla każdego klucza. Nagły skok liczby tokenów lub wywołań z nieznanego adresu IP powinien natychmiast uruchomić procedurę rotacji, bez oczekiwania na potwierdzenie incydentu.

Warto wspomnieć o trzech ostatnich błędach, ponieważ spotykamy się z nimi co tydzień. Klucz opublikowany w publicznym repozytorium Git pozostaje czytelny w historii nawet po usunięciu pliku: jedyną słuszną reakcją jest jego unieważnienie. Klucz wysłany jako zwykły tekst przez e-mail lub komunikator instant messaging jest archiwizowany na zawsze na serwerach, nad którymi nie masz kontroli. A wygasły lub unieważniony klucz zalegający we wdrożeniu generuje błędy 401 Unauthorized, których diagnoza często zajmuje godzinę, po prostu dlatego, że nikt nie wpadł na pomysł, by to sprawdzić.

Kluczowe wnioski

  • Generuj klucze z sekcji API Keys swojej przestrzeni roboczej w Konsoli Mistral
  • Przechowuj je wyłącznie w zmiennych środowiskowych lub menedżerze tajemnic
  • Przeprowadzaj regularną rotację oraz natychmiastową w przypadku ujawnienia
  • Twórz jeden klucz na aplikację, aby ograniczyć skutki kompromitacji
  • Zawsze dodawaj .env do swojego .gitignore