Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Authentificatie met bearer-token

Les 14 van 14 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Beveilig uw API-aanroepen
  2. Het bearer-token-schema
  3. Authenticatiefouten
  4. Best practices voor beveiliging
  5. Lekdetectie
  6. HTTPS vereist
  7. Belangrijkste punten
  8. Controleer uw begrip

Beveilig uw API-aanroepen

Handleiding 'Aan de slag' in de xAI-documentatie Elk verzoek dat naar de xAI-API wordt verzonden, moet worden geverifieerd. De API maakt gebruik van het bearer-token-schema, een veelgebruikte standaard voor REST-API’s. Deze les legt uit hoe dit mechanisme werkt en welke best practices u moet volgen om uw sleutels in een productieomgeving te beschermen.

Het bearer-token-schema

Zoals de naam al aangeeft, kan iedereen die het token “bezit” (draagt), toegang krijgen tot de API. Daarom is het beschermen van uw sleutel fundamenteel: er vindt geen identiteitscontrole plaats buiten het token zelf.

Header-indeling

Elk HTTP-verzoek moet de Authorization-header bevatten met het voorvoegsel Bearer, gevolgd door uw sleutel:

Authorization: Bearer xai-your-api-key

Met cURL ziet dit er als volgt uit:

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

In Python verzorgen de SDK’s deze header automatisch wanneer u de sleutel aan de client-constructor doorgeeft.

Authenticatiefouten

HTTP 401 Unauthorized

Deze foutmelding betekent dat uw sleutel ontbreekt, ongeldig is of is ingetrokken. Controleer het volgende:

  • Of de omgevingsvariabele XAI_API_KEY is ingesteld
  • Of de sleutel begint met xai-
  • Of de sleutel niet is ingetrokken in de console

HTTP 403 Forbidden

Uw sleutel is geldig, maar beschikt niet over de machtigingen die vereist zijn voor de gevraagde actie. Dit kan gebeuren bij teambeperkingen voor bepaalde bewerkingen.

Best practices voor beveiliging

Exposeer nooit een sleutel in code

Sleutels mogen nooit als platte tekst voorkomen in:

  • Versiebeheerde broncode (Git)
  • Toepassingslogs
  • URL’s of queryparameters
  • Foutberichten die aan gebruikers worden getoond
  • GitHub-issues en pull-requests

Gebruik een secrets-vault

Sla in een productieomgeving uw sleutels op in een toegewijd systeem:

  • AWS Secrets Manager of Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Secrets van uw CI/CD-platform (GitHub Actions, GitLab CI)

Sleutelrotatie

Wijzig uw sleutels regelmatig, en onmiddellijk als u een lek vermoedt:

  1. Maak een nieuwe sleutel aan in de xAI-console
  2. Werk de sleutel bij in uw secrets-vault
  3. Implementeer uw applicatie opnieuw
  4. Controleer of alles werkt met de nieuwe sleutel
  5. Trek de oude sleutel in via de console

Beperk machtigingen

Als u in een team werkt, maak dan voor elke service en omgeving aparte sleutels aan. Als er één wordt gecompromitteerd, blijft de impact beperkt tot één context.

Lekdetectie

Het voorvoegsel xai- stelt detectietools (GitHub secret scanning, GitGuardian, TruffleHog) in staat om sleutels in broncode automatisch te identificeren. Schakel deze tools in voor uw repositories, zodat u onmiddellijk wordt gewaarschuwd bij per ongeluk blootstelling.

Als er een sleutel wordt gedetecteerd in een openbare commit:

  1. Trek deze onmiddellijk in via de xAI-console
  2. Controleer uw gebruiksgeschiedenis op frauduleus gebruik
  3. Maak een nieuwe sleutel aan
  4. Maak uw Git-geschiedenis schoon (of behandel de sleutel beter als gecompromitteerd en ga verder)

HTTPS vereist

De xAI-API accepteert alleen HTTPS-verbindingen. TLS versleutelt uw verzoeken tijdens transport, inclusief de Authorization-header. Probeer deze beveiliging nooit te omzeilen: een verzoek via niet-versleuteld HTTP zou uw sleutel op het netwerk blootstellen.

Belangrijkste punten

  • De API gebruikt het bearer-token-schema via de Authorization-header
  • De sleutel is de enige authenticatiefactor: bescherm deze als een wachtwoord
  • Gebruik in productie een secrets-vault en hardcode nooit een sleutel
  • Schakel lekdetectie in voor uw Git-repositories
  • Roteer sleutels regelmatig en trek elke gecompromitteerde sleutel onmiddellijk in

Controleer uw begrip

De fundamenten van de xAI-API: één laatste controle voordat u begint met bouwen.

1. Wat moet u doen met een API-sleutel zodra u deze heeft aangemaakt?

Antwoord: Bewaar deze op een veilige plek (deze wordt slechts één keer getoond), exposeer deze via de variabele XAI_API_KEY in plaats van hardcoding, gebruik één sleutel per omgeving en test deze direct met een aanroep naar /v1/models.

2. Wat is de basis-URL en waarom is deze zo belangrijk?

Antwoord: https://api.x.ai/v1. Dit maakt OpenAI-compatibiliteit mogelijk: door base_url en de sleutel te wijzigen, kunt u bestaande OpenAI-code naar Grok laten verwijzen.

3. Welke SDK's kunt u gebruiken met Grok?

Antwoord: De native xAI SDK, de OpenAI SDK (met de xAI base_url) en de Vercel AI SDK aan de JavaScript-kant, plus cURL voor testen: het ecosysteem is open.

4. Wat is het belangrijkste generatie-eindpunt?

Antwoord: POST /v1/responses, het moderne formaat; chat/completions blijft beschikbaar als een legacy-optie voor compatibiliteit.

5. Hoe wordt elk verzoek geverifieerd?

Antwoord: Met de Authorization: Bearer-header en de xai-… sleutel: het standaard bearer-token-schema, hetzelfde ongeacht de SDK of tool.

Een beveiligde sleutel, de basis-URL, uw keuze voor een SDK, overal Bearer: het fundament ligt er, en de volgende API-cursussen bouwen hierop voort.