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.