Autorisations de l'API Crypto : une clé réservée au trading peut toujours perdre de l'argent
La désactivation des retraits sur une clé API supprime une voie de transfert de fonds, mais cela ne rend pas une intégration commerciale inoffensive. Une clé capable de soumettre des ordres peut toujours créer des positions indésirables, encourir des frais ou négocier sur un marché illiquide. Évaluez les actions qu'une intégration peut effectuer, ainsi que les informations qu'elle peut lire.
Mapper les autorisations sur une tâche spécifique
Un outil de reporting peut avoir besoin de soldes et d'historiques sans autorisation de négociation. Un outil d'exécution peut nécessiter la soumission et l'annulation d'ordres. Les transferts, les retraits et les modifications de la configuration du compte sont des fonctionnalités distinctes qui ne doivent pas être activées simplement parce qu'un guide de configuration demande un accès large.
Les noms d’autorisation varient selon la plateforme. Vérifiez la documentation actuelle et l'écran d'autorisation actuel. La documentation officielle de l'API d'OrangeX distingue les méthodes publiques et privées et décrit les étendues d'accès demandées. Cela ne signifie pas que tous les contrôles proposés par une autre bourse existent sur OrangeX.
Pourquoi le trading uniquement est toujours conséquent
Prenons un compte hypothétique détenant 1 000 USDT. Une intégration malveillante achète et vend à plusieurs reprises en utilisant des ordres de marché. Même lorsque les retraits sont désactivés, les spreads, les frais et les mouvements de prix défavorables peuvent réduire le solde. Si la clé permet également le trading à effet de levier, les pertes potentielles et le risque de liquidation dépendent des contrôles réels de l'instrument et du compte.
Un deuxième risque est celui d’une vente dans un carnet de commandes restreint ou d’un achat involontaire d’un actif illiquide. Empêcher les retraits externes n’impose pas de prix d’exécution garanti ni de perte maximale sur les transactions. La protection pertinente est un ensemble de limites concernant les actions, tailles et instruments autorisés.
Comparez quatre niveaux de restriction
Tout d’abord, accordez uniquement les autorisations requises par la tâche. Deuxièmement, utilisez les restrictions prises en charge par la plate-forme, telles que les listes d'autorisation IP ou l'expiration là où elles sont réellement disponibles. Troisièmement, configurez la liste d'instruments de l'intégration, la taille maximale de la commande et les limites d'exposition. Quatrièmement, surveillez le compte indépendamment de cette intégration.
Une restriction IP limite l'origine des requêtes ; cela ne sécurise pas un serveur autorisé compromis. Une limite côté logiciel peut échouer si le logiciel lui-même est compromis. Traitez ces contrôles comme complémentaires et vérifiez lesquels sont appliqués par la bourse plutôt que uniquement par le bot.
Protégez les secrets et testez sans accès au trading réel
Ne collez pas de secret API dans un chat, des captures d'écran, des feuilles de calcul partagées ou un référentiel de code public. Conservez les informations d’identification hors des journaux et utilisez un magasin de secrets protégé adapté à l’environnement. Vérifiez le domaine et l'opérateur officiels de l'intégration avant de fournir l'accès.
Lorsqu'un environnement de test documenté est disponible, utilisez-le. Sinon, commencez avec le moins d’autorité nécessaire pour valider la connectivité et vérifiez le comportement avant d’activer des actions supplémentaires. Ne supposez jamais qu'une demande de données publiques nécessite un secret ou qu'une clé de démonstration est interchangeable avec une clé de trading en direct.
Planifiez l'interrupteur d'arrêt à l'avance
Sachez comment révoquer la clé via l'interface du compte officiel avant de la connecter. Examinez séparément les ordres et les positions actifs lors de la déconnexion d'un bot : la révocation des informations d'identification empêche les futures demandes autorisées mais n'annule pas nécessairement les ordres existants ni ne clôture l'exposition.
Si une compromission est suspectée, utilisez l'interface officielle pour révoquer la clé concernée, inspecter les commandes, les positions et l'historique des transferts, et contacter l'assistance vérifiée. Conservez les identifiants pertinents sans publier le secret. Une clé de remplacement doit utiliser des autorisations corrigées et une intégration revue, plutôt que de simplement restaurer la configuration précédente.
Sources
- OrangeX : scopes officiels d'authentification et d'accès à l'API
- Kraken : sécurité des clés API
- Kraken : exemples d'autorisations de clé API
Recherche vérifiée le 5 novembre 2026 (Asie/Shanghai). L'exemple du compte est hypothétique ; la disponibilité du contrôle doit être vérifiée sur la plateforme utilisée.
