Pour sécuriser une clé d’API LLM, conservez-la dans un gestionnaire de secrets et n’appelez le modèle que depuis votre serveur, jamais depuis un navigateur ou une application. Donnez à chaque charge de travail sa propre clé, faites tourner les clés selon un calendrier, liez-les aux IP de vos serveurs avec une liste d’autorisation, et révoquez d’abord une clé divulguée : l’enquête vient ensuite.
Cet article présente les habitudes qui protègent les clés, avec les contrôles concrets que fournit BroadNet Inference. Pour le pas-à-pas dans le portail, voir le guide des clés d’API et des listes d’IP autorisées ; pour les budgets et la protection contre les boucles incontrôlées, voir maîtriser les dépenses d’une API LLM.
Où stocker une clé d’API LLM ?
Stockez les clés dans un gestionnaire de secrets ou dans les secrets chiffrés de votre plateforme, jamais dans le code. L’OWASP Secrets Management Cheat Sheet détaille les options. Notez sa mise en garde : les variables d’environnement « are generally accessible to all processes and may be included in logs or system dumps » (traduction : « sont généralement accessibles à tous les processus et peuvent se retrouver dans des logs ou des dumps système ») ; l’OWASP préfère donc, quand vous avez le choix, des fichiers de secrets montés ou la récupération des secrets depuis un coffre. Une variable d’environnement alimentée au démarrage par un gestionnaire de secrets est le compromis courant.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://inference.broadnet.ai/v1",
api_key=os.environ["BROADNET_API_KEY"], # fails loudly if missing
)
Utilisez os.environ[...], pas os.getenv(...) avec une valeur de repli codée en dur : c’est par ces valeurs de repli que les clés finissent dans Git. En développement local, un fichier .env convient s’il figure dans .gitignore dès le premier commit. Activez le secret scanning et la push protection de votre hébergeur Git. Sur GitHub, la push protection bloque les push contenant des formats de secrets connus avant qu’ils n’atteignent le dépôt ; la push protection pour les utilisateurs est activée par défaut, mais celle au niveau du dépôt est désactivée par défaut et doit être activée par un administrateur du dépôt ou un propriétaire de l’organisation.
Peut-on mettre une clé d’API dans un navigateur ou une application mobile ?
Non. Tout ce qui est livré à un client peut être extrait. Le code front-end et les bundles d’application sont publics, qu’ils soient minifiés ou obfusqués. Appelez le LLM depuis votre serveur, authentifiez-y vos propres utilisateurs et appliquez vos propres limites par utilisateur avant de transmettre.
Il en va de même pour les outils de bureau que vous confiez à d’autres. Si un membre de l’équipe a besoin d’un agent de code, donnez-lui sa propre clé sur son propre compte plutôt que d’en partager une.
Pourquoi une clé par charge de travail ?
Sur BroadNet Inference, un compte peut détenir jusqu’à dix clés actives. Utilisez-les :
| Libellé de la clé | Utilisée par |
|---|---|
prod-api |
Back-end de production |
prod-worker |
Traitements par lots |
staging |
Environnement de préproduction |
agent-ci |
Agent de code en CI |
dev-laptop-<name> |
Développement local |
Quand l’une fuit, vous ne révoquez que celle-là, et les autres continuent de fonctionner. Les libellés rendent aussi l’usage lisible : vous voyez quelle charge de travail dépense quoi. Nommez les clés d’après ce qui les utilise, pas d’après la personne qui les a créées.
Comment une liste d’IP autorisées protège-t-elle une clé ?
Avec une liste d’IP autorisées, une clé volée échoue partout ailleurs que sur votre propre infrastructure. Sur BroadNet Inference :
- La liste du compte accepte jusqu’à 32 entrées, une adresse IPv4 ou IPv6 ou une plage CIDR par ligne.
- Une liste vide signifie aucune restriction.
- Les nouvelles clés héritent de la liste du compte, sauf si vous créez une clé avec ses propres
allowed_ips, qui remplacent alors la liste héritée pour cette clé. - Une requête provenant d’une adresse hors liste est refusée avec un 403 (« refused by model, route or IP policy » ; traduction : « refusée par la politique de modèle, de route ou d’IP »).
Créez une clé avec sa propre liste via l’API du portail :
curl -X POST https://inference.broadnet.ai/portal/keys \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
-H "Content-Type: application/json" \
-d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
La réponse contient la clé brute une seule fois. Rangez-la immédiatement dans votre gestionnaire de secrets : elle ne peut pas être relue. Toutes les étapes sont dans le guide des listes d’IP autorisées.
Les listes d’IP conviennent aux serveurs dont l’IP sortante est stable : un VPS, une passerelle NAT, l’IP fixe d’un bureau. Pour les ordinateurs portables sur des réseaux changeants, utilisez une clé distincte sans liste et limitez le solde qu’elle peut consommer.
Pourquoi séparer clés d’inférence et identifiants d’administration ?
BroadNet utilise deux types d’identifiants :
| Identifiant | Permet de | Où le stocker |
|---|---|---|
| Clé d’inférence | Requêtes de modèle vers /v1/* |
Là où tourne l’application |
| Identifiant du portail | Créer et révoquer des clés, modifier les IP autorisées, effectuer des achats | Uniquement dans votre automatisation ou vos outils d’administration |
La documentation demande de traiter chaque identifiant du portail comme une autorité complète sur le compte. Ne déployez jamais un identifiant du portail à côté de votre application. Si votre serveur applicatif est compromis, l’attaquant doit obtenir une clé d’inférence, pas le contrôle du compte.
À quelle fréquence faire tourner les clés d’API ?
L’OWASP recommande une rotation régulière « so that any stolen credentials will only work for a short time » (traduction : « afin que des identifiants volés ne fonctionnent que peu de temps »). Les clés BroadNet durent un an à partir de leur création : chaque clé devra donc être remplacée de toute façon. Faites de la rotation une routine :
- Créez une nouvelle clé avec le même modèle de libellé et la même liste d’IP.
- Déployez-la à côté de l’ancienne, ou remplacez le secret et redémarrez.
- Observez le trafic basculer vers la nouvelle clé.
- Révoquez l’ancienne clé avec
DELETE /portal/keys/{alias}.
Comme un compte peut détenir jusqu’à dix clés actives, l’ancienne et la nouvelle peuvent coexister quelques minutes sans interruption de service. Faites tourner plus tôt les clés auxquelles un membre de l’équipe sur le départ avait accès.
Que faire en cas de fuite d’une clé ?
Quand une clé fuit, révoquez-la d’abord et enquêtez ensuite. Sur BroadNet Inference, les nouvelles requêtes s’arrêtent en moins de cinq secondes après une révocation ou une modification de la liste d’IP ; la documentation explique que les décisions d’autorisation peuvent rester dans un cache répliqué pendant cet intervalle borné.
Après la révocation :
- vérifiez l’usage de la clé sur la page du compte ou avec
GET /portal/usage; - trouvez comment elle a fuité (historique des commits, logs de CI, capture d’écran partagée) ;
- faites tourner les autres secrets stockés au même endroit.
Une clé révoquée ou bloquée renvoie 401 ou 403 ; consultez le guide des erreurs pour que votre supervision ne les traite pas comme des erreurs passagères.
Comment les clés fuient-elles par les logs ?
Les logs sont une fuite facile à manquer. Masquez l’en-tête Authorization dans les logs de débogage HTTP, les outils de remontée d’erreurs et les logs d’accès des proxys. Lorsque vous contactez le support, envoyez le X-Request-ID, l’horodatage, la route, le statut et l’alias de la clé, jamais la clé elle-même. D’après la documentation de BroadNet, le portail ne stocke qu’une empreinte de chaque clé : il ne peut donc pas non plus vous montrer une clé perdue.
Comment limiter les dégâts d’une fuite que vous n’avez pas encore repérée ?
Même avec toutes les habitudes ci-dessus, partez du principe qu’une clé peut fuir un jour. Réduisez le rayon d’impact :
- Maintenez le solde à l’usage à un niveau dont la perte vous serait supportable, et rechargez au besoin.
- Utilisez un forfait pour les agents intensifs : une session de forfait a un prix fixe, donc une clé de forfait volée ne peut pas faire exploser une facture au token. Voir ce que « illimité » veut vraiment dire.
- Déclenchez des alertes sur des dépenses ou des débits de requêtes inhabituels par clé ; le calculateur de coût d’API LLM vous donne un montant mensuel normal comme référence. Notre article sur la maîtrise des dépenses d’une API LLM couvre budgets et alertes.
Quels contrôles de clés BroadNet Inference propose-t-il ?
| Contrôle | BroadNet Inference |
|---|---|
| Clé affichée une fois, stockée sous forme d’empreinte | Oui |
| Clés actives par compte | Jusqu’à 10 |
| Durée de vie d’une clé | Un an |
| Liste d’IP autorisées | Jusqu’à 32 entrées IPv4, IPv6 ou CIDR |
| Liste d’IP par clé | Oui, allowed_ips à la création |
| Délai d’effet d’une révocation | En moins de cinq secondes |
| Identifiant d’administration distinct | Identifiant du portail |
Les clés protègent votre compte ; la conservation zéro des données protège ce que vous envoyez à travers lui. Lisez les deux avant de mettre en production.
