Comment activer la restriction d'adresse IP sur mes clés API Binance ?

Comprendre la restriction d'adresse IP

1. La restriction d'adresse IP est une couche de sécurité qui lie une clé API à des adresses IPv4 ou à des plages CIDR spécifiques.

2. Les demandes provenant de toute adresse IP non répertoriée dans la liste blanche seront rejetées avec le statut HTTP 401 non autorisé.

3. Ce mécanisme empêche l'utilisation non autorisée des informations d'identification divulguées, même si la clé secrète est compromise.

4. La fonctionnalité s'applique exclusivement aux appels d'API REST et WebSocket, et non aux connexions à l'interface Web ou aux sessions d'applications mobiles.

5. Binance applique une validation stricte : des champs vides, des entrées génériques comme 0.0.0.0/0 ou une syntaxe CIDR mal formée déclenchent un rejet immédiat de la configuration.

Navigation dans l'interface de gestion des API

1. Connectez-vous à votre compte Binance en utilisant le 2FA vérifié et accédez à Centre utilisateur → Sécurité → Gestion des API .

2. Localisez la ligne de clé API cible et cliquez sur le bouton Modifier à l'extrême droite.

3. Faites défiler jusqu'à la section Paramètres de la liste blanche IP : cette zone reste masquée sauf si la clé a été créée avec la liste blanche activée.

4. Cliquez sur le commutateur à bascule intitulé Activer la liste blanche IP ; cela révèle le champ de saisie des adresses IPv4.

5. Saisissez une ou plusieurs adresses IPv4 séparées par des virgules (par exemple, 203.0.113.42, 198.51.100.0/24) sans espaces avant ou après les virgules.

Validation de votre configuration IP

1. Utilisez ipinfo.io ou whatismyipaddress.com pour confirmer l'adresse IPv4 publique de votre serveur de trading ou de votre machine locale.

2. Si vous déployez sur une infrastructure cloud, récupérez l'adresse IP NAT sortante (et non l'adresse LAN privée) depuis la console de votre fournisseur.

3. Évitez les adresses IP résidentielles dynamiques ; configurez plutôt une adresse IP statique ou utilisez un VPS avec un routage de sortie fixe.

4. Après avoir enregistré les modifications, testez la connectivité en appelant GET /api/v3/time uniquement à partir de l'hôte sur liste blanche.

5. Une réponse réussie confirme la liaison correcte ; un échec indique une résolution IP ou DNS mal configurée contournant la route prévue.

Gestion de plusieurs environnements de déploiement

1. Pour les environnements de développement, de préparation et de production, créez des clés API distinctes, chacune avec sa propre liste d'adresses IP dédiée.

2. Ne réutilisez jamais une seule clé dans plusieurs environnements ; les fuites entre environnements compromettent les garanties d’isolement.

3. Lors de la rotation des clés, mettez à jour simultanément la liste blanche IP : une synchronisation retardée crée des interruptions d'accès temporaires.

4. Surveillez les journaux de requêtes ayant échoué via l'onglet Historique d'activité de l'API de Binance pour détecter les adresses IP sources inattendues tentant d'accéder.

5. Désactivez les anciennes clés immédiatement après avoir confirmé que les nouvelles fonctionnent correctement : ne maintenez pas les clés actives qui se chevauchent plus longtemps que nécessaire.

Foire aux questions

Q : Puis-je utiliser des adresses IPv6 dans la liste blanche IP de Binance ? Non. Binance prend actuellement en charge uniquement les adresses IPv4 et la notation CIDR. Les entrées IPv6 sont ignorées silencieusement lors de la validation.

Q : Que se passe-t-il si l'adresse IP publique de mon serveur change alors que la liste blanche est active ? Toutes les demandes d'API provenant de la nouvelle adresse IP échoueront avec le code d'erreur -1015 jusqu'à ce que l'adresse mise à jour soit ajoutée manuellement à la liste blanche.

Q : L'activation de la liste blanche IP affecte-t-elle les connexions WebSocket ? Oui. Les points de terminaison WebSocket tels que stream.binance.com:9443 appliquent les mêmes restrictions IP que les points de terminaison REST.

Q : Y a-t-il une limite au nombre d'adresses IP que je peux ajouter à une seule liste blanche ? Binance autorise jusqu'à 20 adresses IPv4 ou blocs CIDR distincts par clé API. Le dépassement de ce nombre déclenche une erreur « Trop d’IP » lors de la sauvegarde.