Godkendelse med Bearer-token
På denne side
Sikr dine API-kald
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_KEYer 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:
- Opret en ny nøgle i xAI-konsollen
- Opdater nøglen i din hemmelighedsbutik
- Genudrul din applikation
- Tjek at alt fungerer med den nye nøgle
- 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:
- Tilbagekald den straks i xAI-konsollen
- Gennemgå din brugshistorik for svindelagtig aktivitet
- Opret en ny nøgle
- 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.