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

Uwierzytelnianie za pomocą tokenu Bearer

Lekcja 14 z 14 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Zabezpiecz swoje wywołania API
  2. Schemat tokenu Bearer
  3. Błędy uwierzytelniania
  4. Najlepsze praktyki bezpieczeństwa
  5. Wykrywanie wycieków
  6. Wymagane HTTPS
  7. Kluczowe wnioski
  8. Sprawdź swoją wiedzę

Zabezpiecz swoje wywołania API

Przewodnik „Getting Started“ w dokumentacji xAI Każde żądanie wysyłane do API xAI musi być uwierzytelnione. API korzysta ze schematu Bearer token, który jest powszechnie przyjętym standardem dla interfejsów REST. W tej lekcji wyjaśnimy, jak działa ten mechanizm, oraz przedstawimy najlepsze praktyki dotyczące ochrony kluczy w środowisku produkcyjnym.

Schemat tokenu Bearer

Jak sama nazwa wskazuje, dostęp do API ma każdy, kto posiada („nosi“) token. Dlatego ochrona klucza jest fundamentalna: poza samym tokenem nie odbywa się żadna dodatkowa weryfikacja tożsamości.

Format nagłówka

Każde żądanie HTTP musi zawierać nagłówek Authorization z prefiksem Bearer, po którym następuje Twój klucz:

Authorization: Bearer xai-your-api-key

W przypadku użycia cURL wygląda to następująco:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Hello"}'

W Pythonie zestawy SDK obsługują ten nagłówek automatycznie, gdy przekażesz klucz do konstruktora klienta.

Błędy uwierzytelniania

HTTP 401 Unauthorized

Błąd ten oznacza, że Twój klucz отсутствует, jest nieprawidłowy lub został odwołany. Sprawdź:

  • Czy zmienna środowiskowa XAI_API_KEY jest ustawiona
  • Czy klucz zaczyna się od xai-
  • Czy klucz nie został odwołany w konsoli

HTTP 403 Forbidden

Twój klucz jest ważny, ale nie posiada uprawnień niezbędnych do wykonania żądanej akcji. Może się to zdarzyć w przypadku ograniczeń zespołowych dotyczących określonych operacji.

Najlepsze praktyki bezpieczeństwa

Nigdy nie ujawniaj klucza w kodzie

Klucze nigdy nie mogą pojawiać się w postaci zwykłego tekstu w:

  • Kodzie źródłowym wersjonowanym (Git)
  • Dziennikach aplikacji (logach)
  • Adresach URL lub parametrach zapytania
  • Komunikatach o błędach wyświetlanych użytkownikom
  • Zgłoszeniach (issues) i pull requestach na GitHubie

Używaj sejfu na tajemnice

W środowisku produkcyjnym przechowuj klucze w dedykowanym systemie:

  • AWS Secrets Manager lub Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Tajemnice Twojej platformy CI/CD (GitHub Actions, GitLab CI)

Rotacja kluczy

Regularnie zmieniaj klucze, a w przypadku podejrzenia wycieku – natychmiast:

  1. Utwórz nowy klucz w konsoli xAI
  2. Zaktualizuj klucz w swoim sejfie na tajemnice
  3. Wdroż ponownie swoją aplikację
  4. Sprawdź, czy wszystko działa z nowym kluczem
  5. Odwołaj stary klucz w konsoli

Ogranicz uprawnienia

Jeśli pracujesz w zespole, twórz osobne klucze dla każdej usługi i środowiska. Jeśli jeden z nich zostanie skompromitowany, skutki ograniczą się tylko do jednego kontekstu.

Wykrywanie wycieków

Prefiks xai- pozwala narzędziom wykrywającym (skanowanie tajemnic GitHub, GitGuardian, TruffleHog) automatycznie identyfikować klucze w kodzie źródłowym. Włącz te narzędzia w swoich repozytoriach, aby otrzymywać natychmiastowe powiadomienia w przypadku przypadkowego ujawnienia.

Jeśli klucz zostanie wykryty w publicznym commicie:

  1. Natychmiast odwołaj go w konsoli xAI
  2. Sprawdź historię użycia pod kątem nieautoryzowanej aktywności
  3. Utwórz nowy klucz
  4. Wyczyść historię Gita (lub lepiej: potraktuj klucz jako skompromitowany i przejdź dalej)

Wymagane HTTPS

API xAI akceptuje wyłącznie połączenia HTTPS. Protokół TLS szyfruje Twoje żądania podczas transmisji, w tym nagłówek Authorization. Nigdy nie próbuj omijać tego zabezpieczenia: żądanie wysłane nieszyfrowanym protokołem HTTP暴露łoby Twój klucz w sieci.

Kluczowe wnioski

  • API korzysta ze schematu Bearer token poprzez nagłówek Authorization
  • Klucz jest jedynym czynnikiem uwierzytelniającym: chroń go jak hasło
  • W środowisku produkcyjnym używaj sejfu na tajemnice i nigdy nie hardkoduj klucza
  • Włącz wykrywanie wycieków w swoich repozytoriach Git
  • Regularnie rotuj klucze i natychmiast odwołuj każdy skompromitowany klucz

Sprawdź swoją wiedzę

Podstawy API xAI: ostatnia weryfikacja przed rozpoczęciem budowy.

1. Co powinieneś zrobić z kluczem API zaraz po jego utworzeniu?

Odpowiedź: Przechowuj go w bezpiecznym miejscu (jest wyświetlany tylko raz), udostępniaj go poprzez zmienną XAI_API_KEY zamiast hardkodować, używaj jednego klucza na środowisko i niezwłocznie przetestuj go, wysyłając żądanie do /v1/models.

2. Jaki jest bazowy adres URL i dlaczego ma to tak duże znaczenie?

Odpowiedź: https://api.x.ai/v1. To właśnie on umożliwia kompatybilność z OpenAI: zmiana base_url i klucza wystarczy, aby skierować istniejący kod OpenAI do Groka.

3. Jakich zestawów SDK możesz używać z Grokiem?

Odpowiedź: Natywnego SDK xAI, SDK OpenAI (z base_url xAI) oraz SDK Vercel AI po stronie JavaScript, a także cURL do testów: ekosystem jest otwarty.

4. Jaki jest główny endpoint generowania?

Odpowiedź: POST /v1/responses, czyli nowoczesny format; chat/completions pozostaje dostępny jako opcja legacy dla zachowania kompatybilności.

5. W jaki sposób uwierzytelniane jest każde żądanie?

Odpowiedź: Za pomocą nagłówka Authorization: Bearer i klucza xai-…: standardowy schemat tokenu Bearer, taki sam niezależnie od używanego SDK lub narzędzia.

Zabezpieczony klucz, bazowy adres URL, wybór SDK, Bearer wszędzie: fundamenty są gotowe, a kolejne kursy dotyczące API będą się na nich opierać.