BroadRouter
Commencer

Clé d’API (API key)

Mis à jour

Une clé d’API est une chaîne secrète qui identifie et autorise un client qui appelle une API. Les API LLM l’attendent généralement dans un en-tête Authorization: Bearer, et quiconque détient la clé peut envoyer des requêtes facturées au compte qui la possède.

Aussi appelé : clé API, clé d’API, jeton d’API, clé secrète, jeton Bearer, clé d’inférence, API key, API token, secret key, bearer token, inference key

Une clé d’API fonctionne comme un mot de passe pour un programme. C’est aussi un pouvoir de dépense : qui la détient peut utiliser votre solde.

Comment ça marche

Les API LLM traitent la clé comme un jeton Bearer. Le client l’envoie à chaque requête :

curl https://inference.broadnet.ai/v1/models \
  -H "Authorization: Bearer $BROADNET_API_KEY"

La RFC 6750 définit un jeton Bearer comme un jeton que « any party in possession of the token » (traduction : « toute partie en possession du jeton ») peut utiliser. Il n’y a pas de second facteur. C’est pourquoi la même RFC exige que les clients envoient toujours les jetons Bearer via TLS (https://).

Le fournisseur recherche la clé, retrouve le compte, vérifie les limites et les politiques, puis sert ou refuse la requête. Une clé absente ou erronée renvoie généralement un 401 ; une clé refusée par une politique, comme une liste d’IP autorisées, renvoie généralement un 403.

Pourquoi c’est important

Une clé qui fuit est l’une des causes les plus courantes de factures d’API qui s’envolent, car des bots scannent le code public à la recherche de secrets. Elle peut aussi exposer des données si la clé atteint des endpoints qui renvoient des informations de compte. Les bonnes pratiques, conformes aux recommandations de l’OWASP sur les secrets :

  • Chargez les clés depuis des variables d’environnement ou un gestionnaire de secrets. Ne les commitez jamais et ne les intégrez jamais dans des images de conteneur.
  • Donnez à chaque application ou agent sa propre clé, pour pouvoir en révoquer une sans tout arrêter.
  • Faites tourner les clés régulièrement, et immédiatement après tout soupçon de fuite.
  • Limitez les endroits où une clé fonctionne, par exemple avec une liste d’IP de serveurs autorisées.

Sur BroadNet Inference

BroadNet sépare deux identifiants. Une clé d’inférence appelle les modèles sur /v1/*. Un identifiant de portail automatise le compte : clés, IP autorisées et achats. Traitez ce dernier comme un pouvoir complet sur le compte.

Les deux ne sont affichés qu’une fois. BroadNet ne conserve qu’un hash SHA-256 et ne peut donc pas réafficher la clé. Une clé à l’usage est valable un an, et un compte peut détenir jusqu’à dix clés actives. Chaque clé peut avoir sa propre liste d’IP autorisées. Après une révocation ou une modification de la liste, les nouvelles requêtes sont bloquées en moins de cinq secondes.

Les clés de forfait des forfaits sont distinctes et ne sont jamais débitées de votre solde. La configuration est décrite dans clés d’API et listes d’IP autorisées, et les codes de statut dans erreurs et nouvelles tentatives.

Erreurs fréquentes

  • Journaliser les en-têtes de requête complets. La clé se retrouve alors dans vos logs.
  • Partager une seule clé dans une équipe. Vous perdez la possibilité de révoquer l’accès d’une seule personne.
  • Envoyer la clé au support. Envoyez plutôt la valeur de l’en-tête X-Request-ID.

Questions fréquentes

Puis-je mettre une clé d’API LLM dans un navigateur ou une application mobile ?

Non. Tout ce qui est livré à un client peut être extrait. Gardez la clé sur un serveur et faites appeler votre serveur par votre application ; c’est lui qui appelle ensuite l’API LLM.

Que faire si une clé a fuité ?

Révoquez-la immédiatement, créez-en une nouvelle et vérifiez l’usage sur la période d’exposition. Cherchez ensuite comment elle a fuité, par exemple via un commit, une ligne de log ou une capture d’écran.

Combien de clés puis-je avoir sur BroadNet Inference ?

Jusqu’à dix clés à l’usage actives par compte. Chacune est valable un an à partir de sa création. Les clés de forfait sont distinctes.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity