BroadRouter
Commencer

Liste d’IP autorisées (IP allow list)

Mis à jour

Une liste d’IP autorisées est un contrôle de sécurité qui n’accepte que les requêtes provenant d’adresses IP ou de plages CIDR listées et refuse toutes les autres. Sur une API, elle limite les dégâts d’une clé divulguée, car la clé ne fonctionne pas depuis des réseaux absents de la liste.

Aussi appelé : liste d’IP autorisées, liste blanche d’IP, whitelist IP, IP autorisées, restriction par IP, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed_ips

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 /8 couvre plus de 16 millions d’adresses.

Questions fréquentes

Une liste d’IP autorisées suffit-elle à protéger une clé d’API ?

Non. C’est une couche parmi d’autres. Gardez quand même les clés sur des serveurs, hors du code et des logs, donnez à chaque application sa propre clé et révoquez vite les clés qui fuient.

Mes serveurs tournent en serverless ou en autoscaling. Puis-je utiliser une liste d’IP autorisées ?

Seulement si le trafic sortant part d’adresses connues. Faites-le passer par une passerelle NAT ou un proxy de sortie avec des IP fixes, puis listez celles-ci.

Quelle erreur reçois-je depuis une IP absente de la liste ?

Sur BroadNet Inference, une 403. Les autres API renvoient généralement aussi une 403.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity