Créer une clé API Binance et lier la liste blanche d'IP : mise en pratique
Procédure complète pour créer une clé API Binance à partir de zéro et la lier à une liste blanche d'IP : cochage des permissions, syntaxe des plages IPv4 comme 203.0.113.0/24, mécanisme d'expiration et de rotation à 90 jours, étapes d'urgence en cas de fuite. Tout en un seul passage.
La bonne séquence pour créer une clé API sur Binance est la suivante : se connecter d'abord au Site Officiel de Binance et valider la 2FA, entrer dans « Compte → Gestion des API », créer une nouvelle clé et la nommer, puis cocher immédiatement la liste blanche d'IP en y renseignant la plage IPv4 fixe de sortie (par exemple 203.0.113.0/24). On sélectionne ensuite selon les besoins les permissions lecture seule / trading spot / retrait (par défaut, il est recommandé de n'activer que la lecture seule), avant de sauvegarder l'API Secret hors ligne. Chaque nouvelle clé possède une durée de validité de 90 jours et doit obligatoirement être renouvelée à l'expiration. Pour interagir avec ces mêmes fonctions en mobilité, utilisez l'App Officielle de Binance.
Du point de vue d'un développeur web, une clé API est la « vraie clé physique » qui ouvre les capacités du compte à un script, à un bot de trading ou à un tableau de bord analytique. La divulguer revient à céder à quelqu'un une partie du pouvoir sur le compte. Restreindre les permissions au strict minimum, verrouiller la liste blanche d'IP au plus étroit et raccourcir au maximum le cycle de rotation constituent les trois règles absolues. Le reste de l'article détaille chaque étape, ainsi que les règles d'écriture d'une plage IPv4, la hiérarchie des permissions et la procédure d'urgence en cas de fuite.
Préparation avant la création
Identifier précisément l'IP de sortie
Un préalable à la liste blanche est de disposer d'un IPv4 sortant stable pour vous ou votre programme ; sinon, chaque changement d'IP oblige à revenir modifier la liste blanche. Trois situations typiques :
- Ligne fibre résidentielle : IP le plus souvent dynamique ; nécessite un DDNS ou un VPN pour la fixer. Il est déconseillé de lier directement l'IP domestique.
- Serveur cloud : l'IP de sortie est en général fixe ; utilisez l'IPv4 publique attribuée par le fournisseur cloud.
- Réseau d'entreprise : demandez à l'administrateur si la sortie est en IP unique ou passe par un pool NAT.
En l'absence temporaire d'IP fixe, vous pouvez créer la clé API sans activer les permissions de trading, en la limitant à la lecture seule, puis élargir progressivement les droits après avoir borné les IP.
Un nom et un usage univoques
À chaque usage sa clé : évitez qu'une même clé serve plusieurs scénarios. Exemple de nommage :
| Nom de clé | Usage | Permissions | Remarque |
|---|---|---|---|
read-only-portfolio |
Tableau de bord des actifs, lecture du solde | Lecture seule | Polling horaire |
spot-bot-btc-usdt |
Bot spot en grille | Trading spot | Un seul couple |
data-export |
Export quotidien des transactions | Lecture seule | Un seul run |
treasury-withdraw |
Retrait périodique vers cold wallet | Retrait | Interdiction de trader |
Cette séparation permet, en cas de fuite d'une clé, de la révoquer sans impacter les autres scripts et facilite l'audit du dernier appel de chaque clé.
Préparer la 2FA et la vérification e-mail
Toutes les étapes — création, édition, suppression d'une clé API — requièrent un code 2FA et une confirmation par e-mail. Si vous avez récemment effectué une migration 2FA (voir /posts/biabaweb-2fa-migration/), assurez-vous d'abord que le nouvel authentificateur est stable.
Comment cocher les niveaux de permission
Les permissions de la clé API Binance s'échelonnent en plusieurs paliers ; il est recommandé de suivre le principe du moindre privilège.
Repère rapide des permissions
| Permission | Ce qu'elle autorise | Risque | Cas d'usage recommandé |
|---|---|---|---|
| Lecture seule | Consulter solde, ordres, historiques | Faible | Tableau de bord, export fiscal |
| Trading spot | Passer et annuler des ordres | Moyen | Bots grille / arbitrage |
| Trading contrats | Ouvrir, clôturer, ajuster le levier | Élevé | Stratégies sur contrats |
| Emprunt sur marge | Emprunter, rembourser | Élevé | Stratégies avec levier |
| Retrait | Initier un retrait on-chain | Extrême | Scripts trésorerie |
| Portefeuille universel | Permission composite | Extrême | Déconseillé |
Le comportement par défaut de la lecture seule
Cochée seule, la lecture seule limite la clé aux endpoints GET. Même en cas de fuite, l'attaquant ne peut consulter que le solde et l'historique, sans toucher aux fonds ; couplée à la liste blanche, la perte d'actifs est quasi nulle. Toutes les analyses de données devraient se limiter à ce niveau.
Exigences supplémentaires pour la permission de retrait
Dès que la permission de retrait est cochée, Binance impose : d'avoir au préalable lié une liste blanche d'IP ; d'utiliser conjointement la liste blanche de retrait au niveau du compte (voir /posts/biabaweb-withdrawal-whitelist/) ; et de partager les plafonds par transaction et sur 24 h avec ceux du compte. Tout script pratiquant le « retrait automatique » doit activer simultanément les deux listes blanches.
Q : Peut-on n'activer que la lecture seule, puis passer au trading après validation ? R : Oui, et c'est fortement recommandé. Restez une semaine en lecture seule, observez la stabilité de l'IP et du script, puis élargissez les droits palier par palier. Chaque élévation redemande une confirmation 2FA + e-mail.
Q : Si l'on coche lecture seule et trading spot sur la même clé, sont-elles cumulatives ou substituables ? R : Cumulatives. La lecture seule est de facto acquise pour toute clé ; cocher le trading superpose la capacité de passer des ordres.
Écrire correctement la liste blanche d'IP
La liste blanche accepte plusieurs entrées séparées par des virgules ; chaque entrée peut être une IP unique, plusieurs IP ou une plage CIDR.
Exemples courants
- IPv4 unique :
203.0.113.55 - Plusieurs IPv4 :
203.0.113.55,203.0.113.56 - Plage IPv4 :
203.0.113.0/24(soit de 203.0.113.0 à 203.0.113.255) - Petite plage :
203.0.113.0/29(soit 8 IP consécutives)
Précautions d'écriture :
- Plus le masque est large (chiffre plus petit), plus la couverture d'IP est vaste, plus le risque est élevé ; ne dépassez généralement pas /24.
- Il n'y a pas de compatibilité croisée : on n'inscrit pas d'IPv4 dans une liste IPv6 ni l'inverse ; adaptez au protocole de sortie effectif.
- Ni les noms de domaine ni les hôtes DDNS ne sont acceptés ; il faut des IP numériques.
- Les segments se séparent par une virgule ASCII, sans espace intermédiaire.
Vérifier l'IP de sortie d'un serveur cloud
Sur un serveur cloud, une fois connecté en SSH, vérifiez la sortie via un service tiers de détection d'IP publique (par exemple un endpoint texte qui renvoie l'IP appelante). Ne vous fiez pas à l'« IP publique » affichée dans la console : chez certains fournisseurs, l'IP d'entrée et celle de sortie diffèrent.
Recommandations sur le choix de la plage CIDR
Privilégiez le /32 de la machine hôte (IP unique) ou un /29 (8 IP, en cas d'autoscaling cloud). Évitez le /24 sauf besoin réel de mise à l'échelle massive. N'utilisez jamais 0.0.0.0/0 et ne laissez jamais la liste blanche vide : une liste vide équivaut à autoriser toutes les IP, ce qui est un risque extrême.
Vérifier que la liste blanche est active
Une fois la clé bindée, tentez un appel depuis une machine hors liste : vous devez recevoir une erreur explicite du type -2015 ou « Invalid API-key, IP, or permissions ». Ce message confirme que la liste blanche est active. Si l'appel réussit, la configuration n'a pas été sauvegardée ou l'IP n'est pas correctement liée.
Expiration à 90 jours et rotation
Depuis 2023, Binance impose une durée de validité de 90 jours à toute clé API dotée de permissions de trading ou de retrait. Passé ce délai, la clé est automatiquement rétrogradée en lecture seule et doit être prolongée ou renouvelée manuellement.
La bonne posture de rotation
- Sept jours avant l'échéance, créez une nouvelle clé aux permissions, IP et notes identiques.
- Déployez l'Access Key / Secret Key sur le script en changeant les variables d'environnement.
- Observez pendant 24 h pour valider le bon fonctionnement de la nouvelle clé.
- Sitôt l'échéance atteinte, supprimez l'ancienne clé, sans la conserver « au cas où ».
Avantage : les deux clés cohabitent pendant 24 h, le basculement se fait sans interruption ; l'ancienne est détruite dès l'échéance, réduisant la surface d'exposition.
Ne comptez pas sur le renouvellement automatique
Bien que Binance propose un bouton « prolonger la validité », s'appuyer dessus signifie que l'Access Key / Secret Key ne change jamais : toute fuite passée reste un risque permanent. Une rotation régulière reste la meilleure hygiène de clé.
Coordination avec la liste blanche de retrait
Si la clé implique le retrait, la rotation ne nécessite pas de reconstruire la liste blanche de retrait : le carnet d'adresses de niveau compte est indépendant de la clé. Il convient néanmoins de rejouer une répétition complète : la nouvelle clé effectue un petit retrait vers une adresse déjà en liste blanche pour vérifier la chaîne avant de scaler.
Urgence en cas de fuite
Si une fuite est constatée ou suspectée, exécutez les étapes suivantes dans l'ordre : en cinq minutes, la perte peut être minimisée.
- Ouvrez « Compte → Gestion des API » et supprimez la clé suspecte.
- Déconnectez toutes les sessions (case « Déconnecter les autres appareils » sur la page de connexion).
- Changez immédiatement le mot de passe de connexion du compte.
- Vérifiez « Sécurité → Historique de connexion » et « Sécurité → Journal des opérations » à la recherche d'anomalies.
- Contrôlez « Historique des fonds » pour repérer une transaction ou un retrait non autorisé.
- Réinitialisez la 2FA (optionnel, si vous soupçonnez une intrusion du compte).
- Ouvrez un ticket officiel expliquant la situation via le site Binance.
- Dans la semaine, procédez à un audit complet : liste blanche, 2FA, API, e-mail lié.
Analyse post-incident
Comment la clé a-t-elle fuité ? Canaux fréquents :
- Push involontaire vers un dépôt GitHub public.
- Écriture dans un fichier de configuration ensuite envoyé sur une messagerie.
- Scripts de déploiement contenant la clé et propagés sur plusieurs machines.
- Départ d'un employé sans révocation des accès.
- Utilisation d'outils de développement disposant de fonctions de capture d'écran ou d'upload des logs.
Analysez chaque incident jusqu'à la racine, améliorez le processus pour la fois suivante.
Avertissement de risque : tous les comptes qui vous ajoutent spontanément sur les réseaux sociaux en promettant de « faire tourner votre grille API » sont des tentatives de phishing. Toute demande de vous faire envoyer en message privé votre Access Key ou Secret Key est, sans exception, une arnaque. Ne téléchargez jamais l'App Binance ailleurs que depuis les canaux officiels ; les règles d'identification du vrai et du faux figurent dans /posts/binance-anti-phishing-real-fake/.
Questions fréquentes
Combien de clés API un compte peut-il créer au maximum ?
Le compte principal permet actuellement de créer jusqu'à 30 clés API ; les sous-comptes sont comptabilisés séparément. En pratique, on recommande de ne conserver qu'un maximum de cinq clés actives simultanément ; nettoyez régulièrement le reste pour réduire la charge opérationnelle.
Un sous-compte peut-il créer ses propres clés API ?
Oui. Un sous-compte gère indépendamment sa liste d'API et sa liste blanche d'IP, avec des permissions totalement isolées du compte principal. Cette segmentation est très utile pour l'isolation de type institutionnel : un sous-compte par stratégie, une clé par IP.
Que faire si l'on oublie la Secret Key ?
Elle n'est pas récupérable. La Secret Key API n'est affichée qu'une seule fois lors de la création ; Binance n'en conserve pas de version en clair. Sa perte n'a d'autre issue que la suppression et la recréation. Raison de plus pour la consigner immédiatement dans un gestionnaire de mots de passe ou un fichier chiffré.
Une clé API peut-elle être utilisée depuis l'IP d'une autre personne ?
Non, dès lors que la liste blanche est bindée. Même avec Access Key + Secret Key en main, l'attaquant se heurte à un refus immédiat depuis toute machine hors liste. C'est la valeur centrale de la liste blanche d'IP.
Peut-on continuer à utiliser une ancienne clé après son expiration ?
Oui, mais elle est rétrogradée en lecture seule. Pour restaurer les permissions de trading ou de retrait, il faut cliquer manuellement sur « Prolonger » et rejouer la vérification 2FA. Ce n'est pas recommandé en production : mieux vaut renouveler activement la clé.
La liste blanche d'IP change-t-elle les limites de taux des requêtes ?
Non. Le rate limiting repose sur les quotas de compte, indépendamment de la liste blanche d'IP. Un rate limiting fréquent nécessite d'optimiser la fréquence des appels ou de demander un relèvement du quota, pas d'ajouter des IP.
Peut-on écrire une plage CIDR dans la liste blanche ?
Oui, avec une syntaxe comme 203.0.113.0/24. Mais plus la plage est large, plus elle est risquée : préférez /32 à /24, /29 à /24.
Comment gérer la liste blanche en déploiement multi-régions cloud ?
La recommandation est une clé API distincte par région, liée à l'IP de sortie de cette région. Ainsi, changer de région n'implique que la clé correspondante et facilite l'investigation en cas d'incident. Éviter d'associer une seule clé à plusieurs segments cloud : dépannage compliqué et surface d'attaque agrandie.
En résumé, la maîtrise des clés API passe par trois principes stables : permissions minimales, IP verrouillées, rotation régulière. Pour toute opération sur ces clés, connectez-vous exclusivement depuis le Site Officiel de Binance ou installez l'App Officielle de Binance depuis un canal officiel afin d'écarter tout risque d'interception par un site tiers.
Document publié le 2026-07-01, prochaine révision prévue le 2026-10-01.