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_ipspropre à 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.

