Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Authentification par jeton Bearer

Paskaita 14 iš 14 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Sécurise tes appels API
  2. Le schéma Bearer token
  3. Erreurs d’authentification
  4. Bonnes pratiques de sécurité
  5. Détection des fuites
  6. HTTPS obligatoire
  7. Svarbiausi punktai
  8. Vérifie tes connaissances

Sécurise tes appels API

Guide de démarrage dans la documentation xAI Chaque requête envoyée à l’API xAI doit être authentifiée. L’API utilise le schéma Bearer token, une norme largement adoptée pour les API REST. Cette leçon explique comment fonctionne ce mécanisme et les bonnes pratiques pour protéger tes clés en production.

Le schéma Bearer token

Comme son nom l’indique, quiconque détient (« porte ») le jeton peut accéder à l’API. C’est pourquoi la protection de ta clé est fondamentale : il n’y a aucune vérification d’identité au-delà du jeton lui-même.

Format de l’en-tête

Chaque requête HTTP doit inclure l’en-tête Authorization avec le préfixe Bearer suivi de ta clé :

Authorization: Bearer xai-your-api-key

Avec cURL, cela donne :

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

En Python, les SDK gèrent cet en-tête automatiquement lorsque tu passes la clé au constructeur du client.

Erreurs d’authentification

HTTP 401 Unauthorized

Cette erreur signifie que ta clé est manquante, invalide ou révoquée. Vérifie :

  • Que la variable d’environnement XAI_API_KEY est définie
  • Que la clé commence par xai-
  • Que la clé n’a pas été révoquée dans la console

HTTP 403 Forbidden

Ta clé est valide, mais elle ne dispose pas des permissions requises pour l’action demandée. Cela peut survenir avec des restrictions d’équipe sur certaines opérations.

Bonnes pratiques de sécurité

N’expose jamais une clé dans le code

Les clés ne doivent jamais apparaître en clair dans :

  • Le code source versionné (Git)
  • Les journaux d’application (logs)
  • Les URL ou les paramètres de requête
  • Les messages d’erreur affichés aux utilisateurs
  • Les issues et pull requests GitHub

Utilise un coffre-fort de secrets

En production, stocke tes clés dans un système dédié :

  • AWS Secrets Manager ou Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Les secrets de ta plateforme CI/CD (GitHub Actions, GitLab CI)

Rotation des clés

Change tes clés régulièrement, et immédiatement si tu soupçonnes une fuite :

  1. Crée une nouvelle clé dans la console xAI
  2. Mets à jour la clé dans ton coffre-fort de secrets
  3. Redéploie ton application
  4. Vérifie que tout fonctionne avec la nouvelle clé
  5. Révoque l’ancienne clé dans la console

Limite les permissions

Si tu travailles en équipe, crée des clés séparées pour chaque service et environnement. Si l’une d’elles est compromise, l’impact reste limité à un seul contexte.

Détection des fuites

Le préfixe xai- permet aux outils de détection (analyse de secrets GitHub, GitGuardian, TruffleHog) d’identifier automatiquement les clés dans le code source. Active ces outils dans tes dépôts pour être alerté immédiatement en cas d’exposition accidentelle.

Si une clé est détectée dans un commit public :

  1. Révoque-la immédiatement dans la console xAI
  2. Vérifie ton historique d’utilisation pour détecter toute utilisation frauduleuse
  3. Crée une nouvelle clé
  4. Nettoie ton historique Git (ou mieux, considère la clé comme compromise et passe à autre chose)

HTTPS obligatoire

L’API xAI n’accepte que les connexions HTTPS. TLS chiffre tes requêtes en transit, y compris l’en-tête Authorization. N’essaie jamais de contourner cette protection : une requête via HTTP non chiffré exposerait ta clé sur le réseau.

Svarbiausi punktai

  • L’API utilise le schéma Bearer token via l’en-tête Authorization
  • La clé est le seul facteur d’authentification : protège-la comme un mot de passe
  • Utilise un coffre-fort de secrets en production et ne code jamais une clé en dur
  • Active la détection de fuites dans tes dépôts Git
  • Fais tourner tes clés régulièrement et révoque immédiatement toute clé compromise

Vérifie tes connaissances

Les fondations de l’API xAI : une dernière vérification avant de construire.

1. Que dois-tu faire d'une clé API dès sa création ?

Réponse : Stocke-la dans un endroit sûr (elle n’est affichée qu’une seule fois), expose-la via la variable XAI_API_KEY plutôt que de la coder en dur, utilise une clé par environnement et teste-la immédiatement avec un appel à /v1/models.

2. Quelle est l'URL de base et pourquoi est-elle si importante ?

Réponse : https://api.x.ai/v1. C’est ce qui rend la compatibilité OpenAI possible : changer base_url et la clé suffit à rediriger le code OpenAI existant vers Grok.

3. Quels SDK peux-tu utiliser avec Grok ?

Réponse : Le SDK natif xAI, le SDK OpenAI (avec le base_url xAI) et le SDK Vercel AI côté JavaScript, plus cURL pour les tests : l’écosystème est ouvert.

4. Quel est le principal point de terminaison de génération ?

Réponse : POST /v1/responses, le format moderne ; chat/completions reste disponible comme option héritée pour la compatibilité.

5. Comment chaque requête est-elle authentifiée ?

Réponse : Avec l’en-tête Authorization: Bearer et la clé xai-… : le schéma standard Bearer token, identique quel que soit le SDK ou l’outil.

Une clé sécurisée, l’URL de base, ton choix de SDK, Bearer partout : les fondations sont en place, et les prochains cours sur l’API s’appuieront dessus.