BroadRouter
Commencer

Limiter vos clés API à vos serveurs avec une liste d’IP autorisées

Mis à jour

Ajoutez les adresses IPv4 ou IPv6 sortantes de vos serveurs, ou des plages CIDR, à la liste d’IP autorisées du compte, jusqu’à 32 entrées. Les nouvelles clés héritent de cette liste, sauf si vous passez allowed_ips à leur création. Les requêtes d’autres adresses reçoivent un 403, et les changements de liste ou révocations prennent effet en cinq secondes.

Une clé qui fuit est la cause la plus courante d’une facture d’API qui s’emballe. BroadNet Inference vous donne deux protections : une liste d’IP autorisées et une révocation rapide.

Deux types d’identifiants

Identifiant À utiliser pour À traiter comme
Clé d’inférence Requêtes de modèles vers /v1/* Un secret propre à une application ou un agent
Identifiant du portail Automatisation du compte : clés, IP autorisées, achats Tous les droits sur le compte

Les deux ne s’affichent qu’une fois. Le portail ne conserve qu’un hash SHA-256 et ne peut donc pas réafficher la clé. Une clé d’inférence à l’usage est valable un an après sa création, et un compte peut détenir jusqu’à dix clés actives.

Définir une liste d’IP autorisées

Sur la page du compte, ajoutez une adresse IPv4 ou IPv6 ou une plage CIDR par ligne, jusqu’à 32 entrées. Une liste vide signifie aucune restriction d’IP. Les nouvelles clés héritent de cette liste du compte. L’edge vérifie, à chaque requête API, l’IP client transmise par Cloudflare.

Pour gérer la liste du compte depuis un script, PUT /portal/allowed_ips la remplace en un seul appel (identifiant du portail requis).

Pour donner à une clé sa propre liste, indiquez-la à la création avec un identifiant du portail :

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

Un allowed_ips propre à la clé remplace, pour cette clé, la liste héritée du compte. La réponse contient la clé en clair une seule fois ; enregistrez-la immédiatement.

Révoquer vite une clé divulguée

DELETE /portal/keys/{alias} révoque une clé à l’usage, et DELETE /portal/keys/hourly/{alias} révoque une clé horaire (le montant de l’achat initial reste dû). Après une révocation ou un changement de liste, les nouvelles requêtes s’arrêtent en cinq secondes.

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

Définissez KEY_ALIAS sur l’alias affiché pour la clé sur la page du compte ou dans GET /portal/keys. L’alias n’est pas la clé secrète. Si un identifiant du portail fuit, révoquez-le avec DELETE /portal/credentials/{id} : il peut faire tout ce que votre compte peut faire.

Dépannage

  • 403 depuis un serveur que vous avez listé. L’edge voit votre adresse publique sortante, pas l’IP privée du serveur. Les serveurs derrière une passerelle NAT, un proxy ou un répartiteur de charge sortent par l’adresse de cet équipement. Un serveur doté d’IPv6 peut sortir en IPv6 même si vous n’avez listé que son adresse IPv4. Listez l’adresse par laquelle la requête sort réellement, ou une plage CIDR qui la couvre.
  • Une nouvelle clé ignore la liste du compte. Un tableau allowed_ips propre à la clé remplace, pour cette clé, la liste héritée du compte. Vérifiez ce que vous avez passé à la création.
  • 409 key_limit_reached. Le compte a déjà dix clés actives. Révoquez-en une que vous n’utilisez plus.
  • Des requêtes passent encore quelques secondes après la révocation. C’est normal pendant cinq secondes au plus, le temps que le cache se mette à jour.

Une requête provenant d’une adresse absente de la liste reçoit un 403. Voir tous les codes d’erreur de BroadNet et quand réessayer. Pour envoyer une première requête avec une nouvelle clé, suivez le guide du SDK Python d’OpenAI. L’entrée du glossaire sur les listes d’IP autorisées explique le principe de façon générale.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

Questions fréquentes

Comment restreindre une clé API LLM à l’adresse IP de mon serveur ?

Ajoutez l’adresse publique sortante du serveur, ou une plage CIDR, à la liste d’IP autorisées du compte sur la page du compte BroadNet, ou passez allowed_ips lorsque vous créez la clé via POST /portal/keys. Les requêtes de toute autre adresse sont refusées avec un 403.

Une liste vide bloque-t-elle tout ?

Non. Une liste vide signifie aucune restriction d’IP : la clé fonctionne depuis n’importe quelle adresse. Ajoutez au moins une entrée pour activer la restriction.

Puis-je utiliser une clé d’inférence pour créer d’autres clés ?

Non. Les clés d’inférence n’appellent que les routes de modèles /v1/*. Créer et révoquer des clés, modifier les IP autorisées et acheter des clés horaires exige un identifiant du portail, qui a tous les droits sur le compte.

En combien de temps la révocation d’une clé divulguée prend-elle effet ?

Selon la documentation de BroadNet, les nouvelles requêtes s’arrêtent dans les cinq secondes suivant une révocation ou un changement de liste, car les décisions d’autorisation peuvent rester aussi longtemps dans un cache répliqué.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity