Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Autentisering med Bearer-token

Lektion 14 av 14 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Säkra dina API-anrop
  2. Schemat Bearer token
  3. Autentiseringsfel
  4. Bästa praxis för säkerhet
  5. Detektering av läckage
  6. HTTPS krävs
  7. Viktiga punkter
  8. Testa dina kunskaper

Säkra dina API-anrop

Komma igång-guide i xAI-dokumentationen Varje begäran som skickas till xAI API måste autentiseras. API:t använder schemat Bearer token, en widely adopted standard för REST-API:er. Den här lektionen förklarar hur mekanismen fungerar och vilka bästa praxis du bör följa för att skydda dina nycklar i produktion.

Schemat Bearer token

Som namnet antyder kan den som innehar (“bär”) token komma åt API:t. Därför är det avgörande att skydda din nyckel: det finns ingen identitetskontroll utöver själva token.

Header-format

Varje HTTP-begäran måste inkludera headern Authorization med prefixet Bearer följt av din nyckel:

Authorization: Bearer xai-your-api-key

Med cURL ser det ut så här:

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

I Python hanterar SDK:erna denna header automatiskt när du skickar nyckeln till klientkonstruktorn.

Autentiseringsfel

HTTP 401 Unauthorized

Detta fel betyder att din nyckel saknas, är ogiltig eller har återkallats. Kontrollera:

  • Att miljövariabeln XAI_API_KEY är satt
  • Att nyckeln börjar med xai-
  • Att nyckeln inte har återkallats i konsolen

HTTP 403 Forbidden

Din nyckel är giltig men har inte de behörigheter som krävs för den begärda åtgärden. Detta kan hända vid teamrestriktioner för vissa operationer.

Bästa praxis för säkerhet

Exponera aldrig en nyckel i koden

Nycklar får aldrig förekomma i klartext i:

  • Versionerad källkod (Git)
  • Applikationsloggar
  • URL:er eller frågeparametrar
  • Felmeddelanden som visas för användare
  • GitHub-issues och pull requests

Använd ett valv för hemligheter

I produktion lagrar du dina nycklar i ett dedikerat system:

  • AWS Secrets Manager eller Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Din CI/CD-plattforms hemligheter (GitHub Actions, GitLab CI)

Nyckelrotation

Byt dina nycklar regelbundet, och omedelbart om du misstäncker ett läckage:

  1. Skapa en ny nyckel i xAI-konsolen
  2. Uppdatera nyckeln i ditt hemlighetsvalv
  3. Distribuera om din applikation
  4. Kontrollera att allt fungerar med den nya nyckeln
  5. Återkalla den gamla nyckeln i konsolen

Begränsa behörigheter

Om du arbetar i ett team, skapa separata nycklar för varje tjänst och miljö. Om en nyckel äventyras begränsas konsekvenserna till en enda kontext.

Detektering av läckage

Prefixet xai- låter detekteringsverktyg (GitHub secret scanning, GitGuardian, TruffleHog) identifiera nycklar i källkoden automatiskt. Aktivera dessa verktyg i dina repository så att du varnas omedelbart vid oavsiktlig exponering.

Om en nyckel detekteras i en offentlig commit:

  1. Återkalla den omedelbart i xAI-konsolen
  2. Kontrollera din användningshistorik efter bedräglig användning
  3. Skapa en ny nyckel
  4. Rensa upp i din Git-historik (eller ännu bättre, betrakta nyckeln som äventyrad och gå vidare)

HTTPS krävs

xAI API accepterar endast HTTPS-anslutningar. TLS krypterar dina begäranden under överföring, inklusive headern Authorization. Försök aldrig kringgå detta skydd: en begäran över okrypterad HTTP skulle exponera din nyckel på nätverket.

Viktiga punkter

  • API:t använder schemat Bearer token via headern Authorization
  • Nyckeln är den enda autentiseringsfaktorn: skydda den som ett lösenord
  • Använd ett hemlighetsvalv i produktion och hard-koda aldrig en nyckel
  • Aktivera läckagedetektering i dina Git-repository
  • Rotera nycklar regelbundet och återkalla alla äventyrade nycklar omedelbart

Testa dina kunskaper

Grunderna i xAI API: en sista kontroll innan du börjar bygga.

1. Vad bör du göra med en API-nyckel så snart du har skapat den?

Svar: Lagra den på ett säkert ställe (den visas bara en gång), exponera den via variabeln XAI_API_KEY istället för att hard-koda den, använd en nyckel per miljö och testa den direkt med ett anrop till /v1/models.

2. Vad är bas-URL:en och varför är den så viktig?

Svar: https://api.x.ai/v1. Det är detta som möjliggör kompatibilitet med OpenAI: att ändra base_url och nyckeln räcker för att peka befintlig OpenAI-kod mot Grok.

3. Vilka SDK:er kan du använda med Grok?

Svar: Det nativa xAI SDK:t, OpenAI SDK:t (med xAI base_url) och Vercel AI SDK:t på JavaScript-sidan, plus cURL för testning: ekosystemet är öppet.

4. Vad är huvudendpointen för generering?

Svar: POST /v1/responses, det moderna formatet; chat/completions finns kvar som ett alternativ för bakåtkompatibilitet.

5. Hur autentiseras varje begäran?

Svar: Med headern Authorization: Bearer och nyckeln xai-…: standardschemat Bearer token, detsamma oavsett SDK eller verktyg.

En säkrad nyckel, bas-URL:en, ditt val av SDK, Bearer överallt: grunden är lagd och de nästa API-kurserna bygger vidare på den.