Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Godkendelse med Bearer-token

Lektion 14 af 14 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Sikr dine API-kald
  2. Bearer token-ordningen
  3. Godkendelsesfejl
  4. Bedste praksis for sikkerhed
  5. Registrering af læk
  6. HTTPS er påkrævet
  7. Vigtige pointer
  8. Tjek din forståelse

Sikr dine API-kald

Kom-i-gang-guide i xAI-dokumentationen Alle forespørgsler sendt til xAI-API’et skal godkendes. API’et bruger Bearer token-ordningen, en udbredt standard for REST-API’er. Denne lektion forklarer, hvordan mekanismen fungerer, og hvilke bedste praksisser du bør følge for at beskytte dine nøgler i produktion.

Bearer token-ordningen

Som navnet antyder, kan den, der besidder („bærer”) tokenet, få adgang til API’et. Derfor er det afgørende at beskytte din nøgle: Der foretages ingen identitetskontrol ud over selve tokenet.

Header-format

Hver HTTP-forespørgsel skal indeholde headern Authorization med præfikset Bearer efterfulgt af din nøgle:

Authorization: Bearer xai-your-api-key

Med cURL ser det sådan ud:

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 håndterer SDK’erne denne header automatisk, når du sender nøglen til klient-konstruktøren.

Godkendelsesfejl

HTTP 401 Unauthorized

Denne fejl betyder, at din nøgle mangler, er ugyldig eller er blevet tilbagekaldt. Tjek følgende:

  • At miljøvariablen XAI_API_KEY er sat
  • At nøglen starter med xai-
  • At nøglen ikke er blevet tilbagekaldt i konsollen

HTTP 403 Forbidden

Din nøgle er gyldig, men har ikke de tilladelser, der kræves til den anmodede handling. Dette kan ske, hvis teamet har begrænset visse operationer.

Bedste praksis for sikkerhed

Eksponér aldrig en nøgle i koden

Nøgler må aldrig optræde som klartekst i:

  • Versionsstyret kildekode (Git)
  • Applikationslogs
  • URL’er eller query-parametre
  • Fejlmeddelelser vist til brugere
  • GitHub-issues og pull requests

Brug en hemmelighedsbutik (secrets vault)

I produktion skal du gemme dine nøgler i et dedikeret system:

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

Nøglerotation

Skift dine nøgler regelmæssigt, og straks hvis du mistænker et læk:

  1. Opret en ny nøgle i xAI-konsollen
  2. Opdater nøglen i din hemmelighedsbutik
  3. Genudrul din applikation
  4. Tjek at alt fungerer med den nye nøgle
  5. Tilbagekald den gamle nøgle i konsollen

Begræns tilladelser

Hvis du arbejder på et hold, skal du oprette separate nøgler til hver tjeneste og hvert miljø. Hvis én nøgle kompromitteres, begrænses konsekvenserne til én enkelt kontekst.

Registrering af læk

Præfikset xai- gør det muligt for registreringsværktøjer (GitHub secret scanning, GitGuardian, TruffleHog) automatisk at identificere nøgler i kildekoden. Aktiver disse værktøjer i dine repositories, så du straks bliver advaret ved utilsigtet eksponering.

Hvis en nøgle opdages i en offentlig commit:

  1. Tilbagekald den straks i xAI-konsollen
  2. Gennemgå din brugshistorik for svindelagtig aktivitet
  3. Opret en ny nøgle
  4. Rens din Git-historik (eller bedre: betragt nøglen som kompromitteret og gå videre)

HTTPS er påkrævet

xAI-API’et accepterer kun HTTPS-forbindelser. TLS krypterer dine forespørgsler under overførsel, herunder headern Authorization. Forsøg aldrig at omgå denne beskyttelse: En forespørgsel over ukrypteret HTTP ville eksponere din nøgle på netværket.

Vigtige pointer

  • API’et bruger Bearer token-ordningen via headern Authorization
  • Nøglen er den eneste godkendelsesfaktor: Beskyt den som et adgangskodeord
  • Brug en hemmelighedsbutik i produktion, og hardcod aldrig en nøgle
  • Aktiver registrering af læk i dine Git-repositories
  • Rotér nøgler regelmæssigt, og tilbagekald straks enhver kompromitteret nøgle

Tjek din forståelse

Grundlaget for xAI-API’et: Et sidste tjek, før du begynder at bygge.

1. Hvad skal du gøre med en API-nøgle, så snart du har oprettet den?

Svar: Gem den et sikkert sted (den vises kun én gang), eksponér den via variablen XAI_API_KEY i stedet for at hardcode den, brug én nøgle pr. miljø, og test den straks med et kald til /v1/models.

2. Hvad er base-URL'en, og hvorfor er den så vigtig?

Svar: https://api.x.ai/v1. Det er det, der muliggør kompatibilitet med OpenAI: Det er nok at ændre base_url og nøglen for at pege eksisterende OpenAI-kode mod Grok.

3. Hvilke SDK'er kan du bruge med Grok?

Svar: Det native xAI SDK, OpenAI SDK’et (med xAI’s base_url) og Vercel AI SDK på JavaScript-siden samt cURL til test: Økosystemet er åbent.

4. Hvad er hovedendpointen for generering?

Svar: POST /v1/responses, det moderne format; chat/completions forbliver tilgængelig som en legacy-mulighed for kompatibilitet.

5. Hvordan godkendes hver forespørgsel?

Svar: Med headern Authorization: Bearer og nøglen xai-…: Standard Bearer token-ordningen, den samme uanset SDK eller værktøj.

En sikret nøgle, base-URL’en, dit valg af SDK, Bearer overalt: Fundamentet er på plads, og de næste API-kurser bygger videre på det.