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.

Publié le 2026-07-08 · Environ 24 min de lecture · Paramètres de sécurité

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 :

  1. 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.
  2. Si la clé a la permission « retrait » sans liste blanche d'IP, l'attaquant peut retirer directement vers son adresse.
  3. 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 :

  1. Attachez un NAT Gateway au VPC de la fonction cloud.
  2. Attachez au NAT Gateway 1 à 4 IP publiques élastiques (EIP).
  3. Ajoutez ces 1 à 4 EIP à la liste blanche API Binance.
  4. 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

  1. Connectez-vous à Binance → avatar → gestion API.
  2. Cliquez sur « Créer API », sélectionnez « System generated » (évitez de fournir une clé faible).
  3. Nommez-la « usage+date » (ex. spot-grid-20260707) pour faciliter la maintenance ultérieure.
  4. Renseignez le code 2FA + code e-mail.
  5. Une fois la clé créée, activez immédiatement « Restrict access to trusted IPs only » et remplissez la liste blanche, puis cochez les permissions.
  6. 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 :

  1. Le 1er de chaque mois, parcourez la page de gestion API et marquez « à faire tourner » toute clé de plus de 60 jours.
  2. Créez 5 jours à l'avance une nouvelle clé avec les mêmes permissions.
  3. Bascule progressive dans la configuration stratégique : la nouvelle clé prend 10 % → 50 % → 100 % du trafic.
  4. Après 24 heures sans anomalie, retournez à la gestion API pour supprimer l'ancienne clé.
  5. 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) :

  1. Chaque jour à 09h00, récupérer /sapi/v1/account/apiTradingStatus et vérifier le score de contrôle des risques.
  2. Chaque jour à 09h00, récupérer /api/v3/account, diff des soldes spot ; alerte si variation > 5 %.
  3. Chaque jour à 09h00, récupérer la liste des IP whitelistées et comparer au fichier de configuration ; alerte en cas de divergence.
  4. 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

  1. Supprimez immédiatement cette clé API sur le Site Officiel de Binance (prioritaire, même par rapport au changement de mot de passe).
  2. Désactivez le commutateur global « API Trading » du compte, ce qui invalide toutes les clés d'un coup.
  3. Vérifiez les 24 dernières heures de passages d'ordres, retraits et transferts internes.
  4. 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