Hitelesítés bearer tokennel
Ezen az oldalon
API-hívásaid biztonságossá tétele
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_KEYkö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:
- Hozz létre egy új kulcsot a xAI konzolon
- Frissítsd a kulcsot a titokkezelő tárolódban
- Telepítsd újra az alkalmazásodat
- Ellenőrizd, hogy minden működik-e az új kulccsal
- 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:
- Azonnal vond vissza a xAI konzolon
- Ellenőrizd a használati előzményeidet csalárd használat után kutatva
- Hozz létre egy új kulcsot
- 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
Authorizationfejlé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.