Par défaut, une clé d’API fonctionne depuis n’importe où. Une liste d’IP autorisées la lie aux endroits où votre code tourne réellement.
Comment ça marche
La périphérie de l’API compare l’IP source de chaque requête à une liste. Si l’adresse figure dans la liste, ou dans une plage listée, la requête passe à la vérification normale de la clé. Sinon, elle est refusée.
Les plages s’écrivent en notation CIDR : une adresse, une barre oblique et une longueur de préfixe. La RFC 4632 explique que la longueur de préfixe indique combien de bits de tête sont fixés. En IPv4 :
| Entrée | Couvre |
|---|---|
203.0.113.7 |
une adresse |
198.51.100.0/24 |
256 adresses, de 198.51.100.0 à 198.51.100.255 |
10.0.0.0/16 |
65 536 adresses |
IPv6 suit le même principe avec des adresses de 128 bits, comme 2001:db8::/48.
L’adresse qui compte est votre IP de sortie (egress) : l’adresse publique depuis laquelle part le trafic de votre serveur. Derrière un NAT, un load balancer ou un proxy d’entreprise, ce n’est souvent pas l’adresse que la machine affiche pour elle-même.
Pourquoi c’est important
Les clés d’API sont des jetons au porteur : quiconque en détient une peut l’utiliser. Les clés fuient par des commits, des logs, des captures d’écran et des ordinateurs portables. Avec une liste d’IP autorisées, une clé volée échoue depuis le réseau de l’attaquant, et une fuite qui aurait coûté de l’argent devient un non-événement. GitHub, par exemple, applique sa liste d’IP autorisées aux appels d’API et aux personal access tokens autant qu’aux connexions web.
La contrepartie, c’est un peu de travail d’exploitation. Chaque nouveau serveur, chaque région et chaque runner de CI doit voir son IP de sortie ajoutée, et les IP dynamiques ont besoin d’un chemin de sortie fixe.
Sur BroadNet Inference
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. Les nouvelles clés héritent de la liste du compte. Un allowed_ips propre à une clé la remplace pour cette clé :
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"]}'
Les requêtes provenant d’autres adresses reçoivent une 403. Après une modification ou la révocation d’une clé, les nouvelles requêtes sont bloquées en moins de cinq secondes. Toutes les étapes figurent dans clés d’API et listes d’IP autorisées, et le tableau des erreurs dans erreurs et retries. Pour une vue d’ensemble de la protection des données, voir la checklist ZDR.
Erreurs courantes
- Lister l’adresse privée d’un serveur, comme
10.x.x.x, au lieu de son IP publique de sortie. - Utiliser une plage très large pour faire disparaître les erreurs. Un
/8couvre plus de 16 millions d’adresses.