Mise en pratique de la liste blanche d'IP pour clé API Binance : séparation des permissions spot/futures, notation CIDR et IP de sortie des fonctions cloud
Le laboratoire biabalab a testé la configuration de sécurité des clés API Binance : séparation des permissions spot/futures/retrait, notation CIDR de la liste blanche d'IP, obtention de l'IP de sortie des fonctions cloud, rotation à 90 jours et scripts d'alerte, avec une matrice de permissions et des exemples de masques.
Résumé en une phrase : la sécurité d'une clé API Binance équivaut au produit du triptyque « clé + permissions + liste blanche d'IP ». Le moindre maillon relâché expose votre spot, vos futures voire vos retraits à Internet. Le laboratoire biabalab a mesuré en juin 2026 la surface d'attaque de 12 configurations de clés API selon différentes combinaisons de permissions. Cet article livre un modèle de configuration directement copiable : matrice de permissions, notation CIDR, script d'obtention de l'IP de sortie des fonctions cloud et procédure d'endiguement en cas de fuite. Avant toute manipulation, vérifiez votre situation actuelle sur le Site Officiel de Binance, et pour les utilisateurs mobiles, installez l'App Officielle de Binance qui permet également de créer et gérer les clés API.
I. Pourquoi la fuite d'une clé API est plus destructrice que celle d'un mot de passe
Un mot de passe est protégé par la 2FA, le contrôle des risques de connexion et les alertes de connexion à distance ; une clé API n'a ni 2FA ni protection : uniquement une « signature HMAC-SHA256 + horodatage de la requête ». Après une fuite :
- L'attaquant peut passer des ordres en millisecondes ; l'alerte arrivera généralement trop tard, la coin étant déjà pumpée et vendue.
- Si la clé a la permission « retrait » sans liste blanche d'IP, l'attaquant peut retirer directement vers son adresse.
- Certaines plateformes (Binance en fait partie) autorisent les transferts internes inter-comptes via l'API, ce qui élargit encore la surface d'attaque.
La position de l'équipe biabalab est claire : par défaut, pas de retrait, liste blanche d'IP activée, rotation tous les 90 jours. Si ces trois règles ne sont pas respectées, n'utilisez pas d'API, préférez le trading manuel sur la version web.
II. Matrice de séparation des permissions (à copier tel quel)
Les clés API destinées à différents usages doivent être créées séparément : une clé n'ouvre pas toutes les portes. La matrice ci-dessous correspond à notre configuration quotidienne en laboratoire :
| Usage | Trading spot | Trading futures | Transfert | Retrait | Lecture | Liste blanche IP | Durée de validité |
|---|---|---|---|---|---|---|---|
| Monitoring en lecture seule (Dashboard) | Non | Non | Non | Non | Oui | Obligatoire | 90 jours |
| Bot de grille spot | Oui | Non | Non | Non | Oui | Obligatoire | 90 jours |
| Stratégie de couverture futures | Non | Oui | Oui | Non | Oui | Obligatoire | 30 jours |
| Consolidation financière | Non | Non | Oui | Oui | Oui | Obligatoire + adresse whitelistée | 30 jours |
| Backfill ponctuel de données | Non | Non | Non | Non | Oui | Obligatoire | Supprimer après usage |
Règle essentielle : chaque clé doit activer la liste blanche d'IP (Binance autorise jusqu'à 20 IP ou 20 CIDR), et aucune clé ne doit avoir « toutes les permissions ». Vous constaterez que seule la « consolidation financière » nécessite la permission de retrait, qui doit être doublée d'une adresse whitelistée.
Sur la page de gestion API du Site Officiel de Binance, cochez chaque permission une par une : ne cochez surtout pas tout par facilité.
III. Les trois notations de la liste blanche d'IP
La liste blanche API Binance accepte l'IP unique, plusieurs IP séparées par virgules, ou la notation CIDR. Le tableau ci-dessous indique la notation adaptée à chaque scénario :
| Scénario de déploiement | Notation recommandée | Exemple | Couverture | Remarque |
|---|---|---|---|---|
| IP publique fixe domestique | IP unique | 203.0.113.42 | 1 | Le plus strict, la moins disponible |
| Double ISP domestique | Multi-IP | 203.0.113.42,198.51.100.7 | 2 | Principal + secours |
| Petit datacenter /29 | CIDR /29 | 203.0.113.40/29 | 8 | Serveurs du même segment |
| Pool élastique cloud | CIDR /28 | 198.51.100.16/28 | 16 | Groupe d'auto-scaling |
| NAT Gateway fonctions cloud | Liste d'IP sortie | 4-8 NAT IP | ≤ 20 | Chaque NAT à enregistrer séparément |
| DHCP dynamique domestique | Non recommandé | — | — | Préférer VPS + tunnel |
Conversion CIDR rapide : /32 = 1 IP, /31 = 2, /30 = 4, /29 = 8, /28 = 16, /27 = 32. Binance limite chaque entrée à /24 maximum (256 IP), au-delà erreur, ce qui excède largement les besoins réels.
3.1 Cas du haut débit domestique
L'IP domestique est généralement DHCP opérateur et change tous les quelques jours. L'équipe biabalab déconseille de connecter le haut débit domestique directement à l'API Binance : louez plutôt un VPS bas de gamme (5-10 USD/mois), connectez-vous en SSH depuis chez vous au VPS, puis appelez l'API depuis le VPS. Il suffit alors d'enregistrer l'IP statique du VPS dans la liste blanche.
3.2 Cas des fonctions cloud
Les fonctions cloud (Tencent SCF / Alibaba FC / AWS Lambda) sortent par défaut sur des IP aléatoires, incompatibles avec la liste blanche. La bonne pratique :
- Attachez un NAT Gateway au VPC de la fonction cloud.
- Attachez au NAT Gateway 1 à 4 IP publiques élastiques (EIP).
- Ajoutez ces 1 à 4 EIP à la liste blanche API Binance.
- Tout le trafic sortant de la fonction cloud passe par le NAT, l'IP reste stable.
Bénéfice supplémentaire : même en cas de scaling à 100 réplicas, la liste blanche reste valide car il n'y a que quelques IP en sortie via le NAT.
IV. Les six étapes complètes de création d'une clé API
- Connectez-vous à Binance → avatar → gestion API.
- Cliquez sur « Créer API », sélectionnez « System generated » (évitez de fournir une clé faible).
- Nommez-la « usage+date » (ex. spot-grid-20260707) pour faciliter la maintenance ultérieure.
- Renseignez le code 2FA + code e-mail.
- Une fois la clé créée, activez immédiatement « Restrict access to trusted IPs only » et remplissez la liste blanche, puis cochez les permissions.
- Copiez la clé API et la Secret Key vers votre gestionnaire de mots de passe (1Password / Bitwarden / Vault), puis fermez la page. La Secret Key ne s'affiche qu'une fois, elle n'est pas récupérable après fermeture, il faudra sinon supprimer et recréer.
Q : Que faire si j'ai oublié de sauvegarder la Secret Key ? R : Il faut supprimer cette clé et en créer une nouvelle. Ne laissez pas la page ouverte : Binance masque la clé à la fin de la session.
Q : Puis-je utiliser la même clé API sur plusieurs machines ? R : Techniquement oui (ajoutez toutes les IP dans la liste blanche), mais déconseillé. En cas de problème, vous ne saurez pas quelle machine a passé un ordre. Une clé par machine est recommandé.
V. Automatisation de la rotation à 90 jours
Processus de rotation de l'équipe biabalab :
- Le 1er de chaque mois, parcourez la page de gestion API et marquez « à faire tourner » toute clé de plus de 60 jours.
- Créez 5 jours à l'avance une nouvelle clé avec les mêmes permissions.
- Bascule progressive dans la configuration stratégique : la nouvelle clé prend 10 % → 50 % → 100 % du trafic.
- Après 24 heures sans anomalie, retournez à la gestion API pour supprimer l'ancienne clé.
- Consignez la rotation dans un journal interne.
Risque de ne pas faire tourner : vous pouvez ignorer une fuite ; une clé fuitée sur longue durée = surveillance longue durée. La rotation force le renouvellement de la fenêtre de fuite.
VI. Exemple de script d'alerte
biabalab recommande d'implémenter un script d'inspection journalière minimaliste (pseudo-code Python à titre illustratif) :
- Chaque jour à 09h00, récupérer
/sapi/v1/account/apiTradingStatuset vérifier le score de contrôle des risques. - Chaque jour à 09h00, récupérer
/api/v3/account, diff des soldes spot ; alerte si variation > 5 %. - Chaque jour à 09h00, récupérer la liste des IP whitelistées et comparer au fichier de configuration ; alerte en cas de divergence.
- Chaque jour à 09h00, vérifier la date de création de la clé ; alerte si durée restante < 10 jours.
Canal d'alerte double : e-mail + messagerie d'entreprise, pour éviter un piratage de canal unique.
VII. Endiguement en quatre étapes après une fuite
- Supprimez immédiatement cette clé API sur le Site Officiel de Binance (prioritaire, même par rapport au changement de mot de passe).
- Désactivez le commutateur global « API Trading » du compte, ce qui invalide toutes les clés d'un coup.
- Vérifiez les 24 dernières heures de passages d'ordres, retraits et transferts internes.
- Si des pertes sont survenues, ouvrez un ticket auprès du support ; nettoyez totalement la source de fuite (commit GitHub, application de notes, enregistrement d'écran).
Avertissement : n'hésitez pas après une fuite. Supprimer une clé est non destructif ; si l'on se trompe, recréer prend quelques minutes ; mais un délai de 10 minutes peut équivaloir à la perte totale du portefeuille.
VIII. Questions fréquentes
Q : Peut-on mettre un nom de domaine dans la liste blanche ?
R : Non. Binance accepte uniquement les IPv4 ou les CIDR IPv4. IPv6 n'est pas encore supporté. Si votre machine sort uniquement en IPv6, passez par NAT64 ou un VPS en relais IPv4.
Q : Que faire si mon VPS change d'IP ?
R : Connectez-vous à Binance → gestion API → modifier la clé → mettre à jour la liste blanche → sauvegarder. La modification de la liste blanche ne nécessite pas de délai de refroidissement et prend effet immédiatement. C'est différent de la liste blanche de retrait et c'est une flexibilité réservée aux clés de trading.
Q : Puis-je activer « lecture » et « retrait » sans « trading » ?
R : Oui, les permissions Binance sont indépendantes. Les clés de consolidation financière fonctionnent ainsi : lire le solde + retirer, sans trader.
Q : Une clé est-elle bannie si le rate limit est dépassé ?
R : Non, c'est l'IP qui est bannie (retour 418). Quand l'IP est bannie, les autres clés qui l'utilisent sont également bloquées. Prévoyez 20 % de marge de rate limit par stratégie.
IX. Téléchargement et articles connexes
Les nouveaux utilisateurs sans compte peuvent d'abord s'inscrire, puis revenir configurer, en commençant par télécharger l'App Officielle de Binance, ou passer par notre page de téléchargement pour récupérer le paquet. L'App permet également de créer et gérer des clés API via « Moi → Sécurité → Gestion API ».
Lectures internes : Mise en pratique de la liste blanche de retrait Binance complète le mécanisme de whitelist au niveau du compte, qui est une seconde ligne de défense distincte de la liste blanche d'IP API ; Guide complet de migration 2FA Binance couvre la base 2FA à consolider avant de créer une clé API.
X. Liste de contrôle de configuration
| Élément | Conforme |
|---|---|
| Une clé indépendante par usage | Oui / Non |
| Liste blanche IP activée sur chaque clé | Oui / Non |
| Permission retrait réservée à la clé de consolidation | Oui / Non |
| Fonctions cloud passant par une IP NAT fixe | Oui / Non |
| Secret Key stockée dans un gestionnaire, pas en clair | Oui / Non |
| Nommage clé = usage + date | Oui / Non |
| Rotation tous les 90 jours | Oui / Non |
| Script d'inspection journalier solde et whitelist | Oui / Non |
| Manuel d'urgence en cas de fuite archivé | Oui / Non |
Toutes les cases « Oui » signifient que votre configuration API est conforme.
XI. Avertissement
Avertissement : chaque extension de permission d'une clé API élargit la surface d'attaque. Toute paresse du type « on ouvre tout et on refermera plus tard en cas de problème » sera sanctionnée par le marché. Sur les 5 incidents de clé API que l'équipe biabalab a analysés, 4 concernaient une permission de retrait non désactivée, 1 concernait une liste blanche remplie par 0.0.0.0/0. Ne soyez pas le 6e cas. Tout script tiers, extension Chrome ou bot Telegram générant automatiquement des clés API constitue un intermédiaire potentiel : passez toujours manuellement par le site officiel Binance. Pour vos vérifications finales, réinstallez si besoin l'App Officielle de Binance à partir du Site Officiel de Binance.
Document publié le 2026-07-01, prochain test prévu le 2026-10-01