Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Hitelesítés bearer tokennel

14. lecke 14 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. API-hívásaid biztonságossá tétele
  2. A bearer token séma
  3. Hitelesítési hibák
  4. Biztonsági legjobb gyakorlatok
  5. Szivárgásészlelés
  6. HTTPS kötelező
  7. Főbb megállapítások
  8. Ellenőrizd a tudásod

API-hívásaid biztonságossá tétele

Kezdő útmutató a xAI dokumentációjában Minden, a xAI API-hoz küldött kérést hitelesíteni kell. Az API a bearer token sémát használja, ami a REST API-k széles körben elterjedt szabványa. Ez a lecke bemutatja a mechanizmus működését, valamint a kulcsaid gyártási környezetben történő védelmének legjobb gyakorlatait.

A bearer token séma

Ahogy a neve is sugallja, bárki, aki birtokolja („viseli“) a tokent, hozzáférhet az API-hoz. Ezért alapvető fontosságú a kulcsod védelme: a tokenen kívül nincs más identitásellenőrzés.

A fejléc formátuma

Minden HTTP-kérésnek tartalmaznia kell az Authorization fejlécet, amely a Bearer előtagot követi, majd a kulcsod következik:

Authorization: Bearer xai-your-api-key

cURL-lal ez így néz ki:

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"}'

Pythonban az SDK-k automatikusan kezelik ezt a fejlécet, amikor átadod a kulcsot a kliens konstruktorának.

Hitelesítési hibák

HTTP 401 Unauthorized (Jogosulatlan)

Ez a hiba azt jelenti, hogy a kulcsod hiányzik, érvénytelen vagy visszavonták. Ellenőrizd a következőket:

  • Be van-e állítva az XAI_API_KEY környezeti változó
  • A kulcs xai- karakterekkel kezdődik-e
  • Nem vonták-e vissza a kulcsot a konzolon

HTTP 403 Forbidden (Tiltott)

A kulcsod érvényes, de nincs megfelelő jogosultsága a kért művelet végrehajtásához. Ez előfordulhat, ha a csapat bizonyos műveletekre korlátozásokat vezetett be.

Biztonsági legjobb gyakorlatok

Soha ne tedd ki a kulcsot a kódban

A kulcsok soha nem szerepelhetnek olvasható szövegként a következő helyeken:

  • Verziókezelt forráskódban (Git)
  • Alkalmazásnaplókban
  • URL-ekben vagy lekérdezési paraméterekben
  • A felhasználóknak megjelenített hibaüzenetekben
  • GitHub issue-kban és pull requestekben

Használj titokkezelő tárolót (Secrets Vault)

Gyártási környezetben a kulcsaidat dedikált rendszerben tárold:

  • AWS Secrets Manager vagy Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • CI/CD platformod titkai (GitHub Actions, GitLab CI)

Kulcsforgatás (Key Rotation)

Rendszeresen cseréld le a kulcsaidat, és azonnal tedd meg ezt, ha szivárgásra gyanakszol:

  1. Hozz létre egy új kulcsot a xAI konzolon
  2. Frissítsd a kulcsot a titokkezelő tárolódban
  3. Telepítsd újra az alkalmazásodat
  4. Ellenőrizd, hogy minden működik-e az új kulccsal
  5. Vond vissza a régi kulcsot a konzolon

Jogosultságok korlátozása

Ha csapatban dolgozol, hozz létre külön kulcsot minden szolgáltatáshoz és környezethez. Ha az egyiket feltörik, a hatás egyetlen kontextusra korlátozódik.

Szivárgásészlelés

Az xai- előtag lehetővé teszi az észlelő eszközök (GitHub titkos szkennelés, GitGuardian, TruffleHog) számára, hogy automatikusan azonosítsák a kulcsokat a forráskódban. Kapcsold be ezeket az eszközöket a tárházaidban, hogy azonnal értesülj véletlen kitettség esetén.

Ha egy kulcsot nyilvános commitban észlelnek:

  1. Azonnal vond vissza a xAI konzolon
  2. Ellenőrizd a használati előzményeidet csalárd használat után kutatva
  3. Hozz létre egy új kulcsot
  4. Tisztítsd meg a Git előzményeidet (vagy még jobb, ha a kulcsot kompromittáltnak tekinted, és továbblépsz)

HTTPS kötelező

A xAI API csak HTTPS-kapcsolatokat fogad el. A TLS titkosítja a kéréseidet átvitel közben, beleértve az Authorization fejlécet is. Soha ne próbáld meg kijátszani ezt a védelmet: egy titkosítatlan HTTP-n keresztül küldött kérés kitenné a kulcsodat a hálózaton.

Főbb megállapítások

  • Az API a bearer token sémát használja az Authorization fejlécen keresztül
  • A kulcs az egyetlen hitelesítési tényező: védd úgy, mint egy jelszót
  • Használj titokkezelő tárolót gyártási környezetben, és soha ne kódold bele a kulcsot
  • Kapcsold be a szivárgásészlelést a Git-tárházaidban
  • Rendszeresen forgasd a kulcsokat, és azonnal vond vissza a kompromittált kulcsokat

Ellenőrizd a tudásod

A xAI API alapjai: egy utolsó ellenőrzés, mielőtt építeni kezdenél.

1. Mit kell tenned egy API-kulccsal, amint létrehoztad?

Válasz: Tárold biztonságos helyen (csak egyszer jelenik meg), tedd elérhetővé az XAI_API_KEY változón keresztül a közvetlen beágyazás helyett, használj külön kulcsot minden környezethez, és azonnal teszteld egy /v1/models hívással.

2. Mi az alap URL, és miért olyan fontos?

Válasz: https://api.x.ai/v1. Ez teszi lehetővé az OpenAI-kompatibilitást: a base_url és a kulcs megváltoztatása elég ahhoz, hogy a meglévő OpenAI-kód a Grok-ra mutasson.

3. Mely SDK-kat használhatod a Grok-kal?

Válasz: A natív xAI SDK-t, az OpenAI SDK-t (a xAI base_url-lal) és a Vercel AI SDK-t JavaScript oldalon, plusz a cURL-t teszteléshez: az ökoszisztéma nyitott.

4. Mi a fő generálási végpont?

Válasz: POST /v1/responses, a modern formátum; a chat/completions továbbra is elérhető kompatibilitási célból, mint örökölt lehetőség.

5. Hogyan hitelesítik az egyes kéréseket?

Válasz: Az Authorization: Bearer fejléccel és az xai-… kulccsal: a szabványos bearer token séma, függetlenül az SDK-tól vagy eszköztől.

Egy biztonságos kulcs, az alap URL, az SDK választása, bearer mindenhol: az alapok készen állnak, és a következő API tanfolyamok erre építenek.