Authentification par jeton Bearer
Šiame puslapyje
Sécurise tes appels API
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_KEYest 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 :
- Crée une nouvelle clé dans la console xAI
- Mets à jour la clé dans ton coffre-fort de secrets
- Redéploie ton application
- Vérifie que tout fonctionne avec la nouvelle clé
- 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 :
- Révoque-la immédiatement dans la console xAI
- Vérifie ton historique d’utilisation pour détecter toute utilisation frauduleuse
- Crée une nouvelle clé
- 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.