← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

Sécurité de l'API blockchain : 6 conseils pratiques

Six pratiques de sécurité pour une API blockchain : génération des clés, stockage hors ligne, signature locale, usage des adresses, token API et webhooks.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

La sécurité d’une API blockchain regroupe les pratiques qui protègent les clés privées, les tokens API et le trafic des webhooks contre les attaquants. Le risque se situe dans la gestion de vos clés, de vos identifiants et de votre point de terminaison de webhook, et non dans la blockchain elle-même. Ces six pratiques valent pour Chaingateway comme pour toute API comparable.

Comment générer des clés privées ?

Générez les clés privées avec un générateur de nombres aléatoires cryptographiquement sûr, et faites-le dans un environnement que vous contrôlez. La OWASP Cryptographic Storage Cheat Sheet indique que les clés doivent provenir d’une fonction cryptographiquement sûre, et ne doivent pas être construites à partir de mots courants ni de frappes au hasard sur le clavier. Une clé faible ou prévisible peut être devinée, et quiconque la devine peut dépenser les fonds.

Chaingateway peut créer une adresse pour vous via POST /api/v2/{blockchain}/addresses. Le guide de gestion des portefeuilles décrit deux modes. Avec un password, la clé privée est stockée chiffrée de notre côté, et vous utilisez le mot de passe pour envoyer des transactions. Sans mot de passe, la réponse contient la clé privée en clair, ce qui convient à une adresse temporaire mais pas à une adresse que vous comptez conserver. Si vous voulez un contrôle total, générez la clé sur votre propre machine ou sur un portefeuille matériel, et importez-la seulement si nécessaire.

Comment stocker les clés privées ?

Conservez hors ligne les clés qui détiennent des fonds à long terme, et ne gardez sur les clés installées sur un serveur que les soldes de travail. Une clé sur une machine connectée à Internet peut être volée par tout ce qui compromet cette machine. Les portefeuilles matériels et les sauvegardes hors ligne suppriment cette exposition, même si un portefeuille matériel peut être perdu : gardez donc une sauvegarde de récupération testée.

N’écrivez jamais de clés ou de mots de passe dans le code source, les journaux ou les tickets. La OWASP Secrets Management Cheat Sheet note que de nombreuses organisations codent en dur des secrets en clair dans le code source et les fichiers de configuration, et recommande un stockage centralisé avec contrôle d’accès et rotation automatisée.

Faut-il signer les transactions sur votre propre machine ?

Oui, si vous le pouvez. Une transaction signée localement n’expose jamais la clé privée à un tiers, et l’API n’a qu’à diffuser le résultat. Pour TRON, Chaingateway prend en charge ce flux : les points de terminaison build renvoient une transaction non signée, vous la signez avec les outils TRON décrits dans le guide de signature hors ligne TRON, et POST /api/v2/tron/transactions/broadcast envoie la transaction signée.

Pour les réseaux EVM, les points de terminaison de transaction acceptent soit le password d’une adresse enregistrée, soit une privatekey dans le corps de la requête. Si vous utilisez privatekey, la clé transite dans la requête : n’appelez donc l’API qu’en HTTPS, et ne journalisez jamais les corps de requête. Notre guide de déchiffrement des keystores montre comment ouvrir localement un fichier keystore exporté.

Peut-on utiliser les adresses créées via l’API comme portefeuille froid ?

Non. Une adresse dont la clé a été créée ou stockée par un service en ligne est un portefeuille chaud, quel que soit le nom qu’on lui donne. Utilisez les adresses créées via l’API comme adresses de dépôt, transférez les fonds entrants vers un portefeuille froid que vous avez généré hors ligne, et traitez l’adresse de dépôt comme une adresse de courte durée.

Transférer régulièrement les dépôts et utiliser une nouvelle adresse pour chaque client ou chaque commande limite ce qu’un attaquant gagne avec une clé divulguée. Si vous avez utilisé le mode sans mot de passe, la clé privée vous a été renvoyée une seule fois : conservez-la donc comme un mot de passe.

Comment protéger votre token API ?

Envoyez le token dans l’en-tête Authorization, et gardez-le hors des URL, du code front-end et des dépôts. Chaingateway utilise le schéma Bearer, Authorization: Bearer <token>, défini dans la RFC 6750. Cette RFC impose TLS pour chaque requête portant un token Bearer, car quiconque voit le token peut s’en servir.

Trois habitudes limitent les dégâts d’une fuite :

  • Stockez le token dans une variable d’environnement ou un gestionnaire de secrets, pas dans le code.
  • Renouvelez-le selon un calendrier et après toute exposition suspectée, comme décrit dans notre guide de rotation des clés API.
  • Restreignez l’accès par adresse IP si le tableau de bord de votre compte le permet. Notre article sur la fonction liste blanche IP explique son fonctionnement.

Le OWASP API Security Top 10 classe l’authentification défaillante, y compris une gestion faible des tokens, parmi les principaux risques des API.

Comment vérifier les webhooks de l’API ?

Vérifiez l’en-tête X-Signature de chaque webhook avant de faire confiance à la charge utile. Sans contrôle, quiconque connaît l’URL de votre webhook peut envoyer une fausse notification de paiement. Chaingateway signe les webhooks lorsque vous définissez un secret personnel dans les paramètres de votre profil. La signature est un HMAC, tel que spécifié dans la RFC 2104, construit à partir de l’identifiant de transaction et de votre secret.

Le guide de sécurité des webhooks contient du code de vérification en Python, Java, PHP et JavaScript. Comparez les signatures avec une fonction à temps constant, et confirmez la transaction sur la chaîne avant de créditer une commande. Chaingateway ne relance pas automatiquement les webhooks en échec. Les notifications en échec sont listées sous /api/v2/{blockchain}/webhooks/notifications/failed, et vous pouvez en renvoyer chacune via /webhooks/notifications/{id}/retry. Vérifiez donc cette liste lorsqu’un paiement semble manquer.

Faut-il les six ?

Pour tout ce qui détient une valeur réelle, oui. Les pratiques couvrent des points de défaillance différents, et en sauter une laisse ce point ouvert, quoi que vous fassiez ailleurs.

Point de défaillanceQue faireOù vérifier
Création des clésUtiliser un générateur cryptographiquement sûr, ou une adresse protégée par mot de passeGuide de gestion des portefeuilles
Stockage des clésGarder les fonds à long terme hors ligne, les secrets hors du code et des journauxOWASP Secrets Management Cheat Sheet
SignatureSigner localement quand l’API le permet, sinon utiliser uniquement HTTPSPOST /api/v2/tron/transactions/broadcast
Usage des adressesUtiliser les adresses API pour les dépôts et transférer les fonds vers un portefeuille froidVotre propre script de transfert
Accès à l’APIGarder le token Bearer dans un gestionnaire de secrets et le renouvelerGuide de rotation des clés API
NotificationsVérifier X-Signature et confirmer la transaction sur la chaîneGuide de sécurité des webhooks

Relisez le tableau avant de passer du testnet au mainnet. L’en-tête X-Network: testnet permet d’exécuter tout le flux, y compris la vérification des webhooks, sans fonds réels.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Blockchain pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.