BroadRouter
Commencer

Sécuriser une clé d’API LLM : stockage, rotation et listes d’IP

Par l’équipe BroadNet Inference · 6 min de lecture · Publié · Mis à jour

Conservez les clés d’API LLM dans un gestionnaire de secrets, jamais dans le code ni dans le navigateur. Donnez à chaque application ou agent sa propre clé, faites-les tourner selon un calendrier et liez-les à vos serveurs avec une liste d’IP autorisées. BroadNet Inference indique que ses listes acceptent 32 entrées, qu’une révocation bloque les nouvelles requêtes en cinq secondes et que les clés durent un an.

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 :

  1. Créez une nouvelle clé avec le même modèle de libellé et la même liste d’IP.
  2. Déployez-la à côté de l’ancienne, ou remplacez le secret et redémarrez.
  3. Observez le trafic basculer vers la nouvelle clé.
  4. 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.

Questions fréquentes

Où stocker une clé d’API LLM ?

Dans un gestionnaire de secrets ou les secrets chiffrés de votre plateforme, injectée dans le processus sous forme de variable d’environnement comme BROADNET_API_KEY. Pas dans le code source, pas dans un fichier .env commité, et jamais dans le code front-end.

En combien de temps puis-je révoquer une clé BroadNet Inference ?

D’après la documentation de BroadNet, les nouvelles requêtes s’arrêtent dans les cinq secondes qui suivent une révocation ou une modification de la liste d’IP, car les décisions d’autorisation peuvent rester dans un cache répliqué pendant cet intervalle borné.

Combien de temps dure une clé BroadNet Inference ?

Une clé à l’usage dure un an à partir de sa création. Un compte peut détenir jusqu’à dix clés actives : vous pouvez donc créer la remplaçante avant l’expiration de l’ancienne.

BroadNet peut-il me réafficher une clé perdue ?

Non. D’après la documentation de BroadNet, la clé brute n’est renvoyée qu’une fois et le portail n’en stocke que l’empreinte (hash). Créez une nouvelle clé et révoquez l’ancienne.

Que faire si ma clé d’API compatible OpenAI a fuité ?

Révoquez-la d’abord, enquêtez ensuite. Vérifiez l’usage de la clé pour repérer du trafic inconnu, trouvez l’origine de la fuite (historique des commits, logs de CI, captures d’écran), faites tourner les autres secrets stockés au même endroit et émettez une clé de remplacement avec une liste d’IP autorisées.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity