Comment récupérer le mot de passe du fichier keystore / UTC / JSON pour Ethereum

Vous disposez du fichier. Il s’agit d’un fichier keystore au format « .json », souvent nommé par exemple « UTC--2018-03-14T… », qui contient votre portefeuille Ethereum. Ce qui vous manque, c’est le mot de passe qui permet de l’ouvrir. Avant de commencer à tester différentes combinaisons, il est utile de comprendre de quoi il s’agit, car c’est ce qui détermine s’il est possible ou non de récupérer le mot de passe de votre fichier keystore Ethereum.

Qu’est-ce qu’un fichier keystore exactement ?

Un mot de passe de keystore ne disparaît pas de la même manière qu’une phrase de récupération perdue. Le fichier que vous avez sous les yeux, c’est votre clé privée, enfermée dans un fichier JSON chiffré, et c’est votre mot de passe qui le déverrouille. La blockchain ne stocke ce mot de passe nulle part : il ne fait que verrouiller ce seul fichier. Ce qui vous manque, ce n’est donc pas votre clé, mais le mot de passe de la copie que vous avez déjà entre les mains.

Cette distinction change tout. Comme vous disposez du fichier, vous pouvez tester une hypothèse de mot de passe sur votre propre ordinateur, hors ligne, autant de fois que vous le souhaitez. Aucun serveur ne décide si vous avez droit à une nouvelle tentative. Vos ETH restent intacts sur la blockchain, et ce fichier n’est que le moyen d’y accéder à nouveau.

Avant toute chose : ne travaillez que sur une copie

Commencez par le copier. Faites-en deux copies et rangez-en une dans un endroit auquel vous ne touchez jamais, car un keystore est un petit fichier unique qui contient tout, et les vieux disques tombent en panne au pire moment.

Deux erreurs bloquent l’accès pour de bon :

• Conservez le fichier original sans le modifier et n’en retouchez pas le contenu. Un keystore doit rester un JSON valide. Renommer le fichier ou remplacer l’extension .json ne modifie pas les données enregistrées, mais peut empêcher le logiciel de reconnaître le fichier. Modifier ou supprimer les données chiffrées qu’il contient peut le rendre inutilisable.
• Gardez-le hors ligne et ne collez jamais votre fichier keystore, votre mot de passe ou votre clé privée sur un site web qui propose de le déverrouiller. De faux clones de MyEtherWallet et de MyCrypto circulent via les annonces des moteurs de recherche et ressemblent trait pour trait aux vrais. Dès qu’un escroc dispose du fichier et du mot de passe, le portefeuille est vidé. Une véritable récupération se fait sur votre propre ordinateur, jamais dans un onglet de navigateur ouvert depuis une publicité.

Vous connaissez encore le mot de passe : ouvrir le fichier

C’est la meilleure position de départ. Si vous vous souvenez réellement du mot de passe, vous n’avez pas besoin d’une récupération. Il vous faut un outil à jour, car celui que ce guide recommandait auparavant est dépassé.

L’application de bureau MyCrypto n’est plus activement maintenue, comme le reconnaît MyCrypto lui-même ; ne bâtissez donc pas votre récupération sur elle. Utilisez plutôt l’une des solutions suivantes :

• MetaMask. Dans l’extension de navigateur, cliquez sur le sélecteur de comptes, puis sur Ajouter un portefeuille et Importer un compte. Sous Sélectionner le type, choisissez Fichier JSON, sélectionnez votre keystore, saisissez le mot de passe propre au fichier (et non votre mot de passe MetaMask), puis cliquez sur Importer (guide d’importation de MetaMask). L’import JSON n’existe que dans l’extension. Dans les versions plus anciennes, cette option s’appelait « Import account » dans l’interface anglaise. C’est aujourd’hui la méthode la plus simple.
• MyEtherWallet (MEW). MEW peut ouvrir un keystore, mais téléchargez MEW et utilisez-le hors ligne plutôt que de saisir votre mot de passe sur le site en ligne. Un guide distinct traite des problèmes de connexion à MEW.
• geth (go-ethereum). Pour qui utilise la ligne de commande, geth lit les fichiers keystore dans son répertoire keystore. Les versions actuelles gèrent les comptes via Clef, un outil de signature distinct, et l’ancienne option --unlock est marquée comme obsolète (gestion des comptes dans geth).

Une fois l’accès retrouvé, abandonnez l’ancien portefeuille. Un keystore ne contient qu’une seule clé, et vous venez de saisir son mot de passe dans un logiciel : transférez donc tout vers un nouveau portefeuille dont vous avez le contrôle. La section « Après l’accès », plus bas, explique comment procéder en toute sécurité.

Vous avez oublié le mot de passe : comment fonctionne vraiment la récupération ?

Que le mot de passe soit récupérable ou non dépend de ce dont vous vous souvenez, et il vaut mieux en comprendre la raison avant de dépenser le moindre centime. Le mot de passe n’est pas écrit dans le fichier, lisible par n’importe qui : on le trouve en testant des candidats jusqu’à ce que l’un d’eux déchiffre la clé. Comme le fichier est à vous et que vous pouvez y confronter vos essais, cette recherche s’effectue hors ligne, sans blocage ni limite du nombre de tentatives. C’est une liberté qu’une phrase de récupération complètement perdue ne vous offre jamais.

Il y a toutefois un vrai hic. Un keystore protège votre clé par une fonction délibérément lente, scrypt ou PBKDF2, associée à un chiffrement AES-128-CTR (définition de Web3 Secret Storage). Le facteur de travail est enregistré dans le fichier lui-même ; le réglage scrypt standard de geth est de 262 144. Cette lenteur est une mesure de sécurité : chaque tentative coûte un temps de calcul réel, et c’est voulu. Tester quelques milliers de mots de passe plausibles se fait rapidement. Tester toutes les chaînes aléatoires possibles de dix caractères, en revanche, non. Cet espace de recherche est bien trop vaste pour être épuisé au cours d’une vie humaine, même avec un matériel performant.

La force brute à l’aveugle est donc exclue ; c’est la recherche ciblée qui fonctionne. L’outil open source adapté est BTCRecover, qui prend en charge les fichiers keystore Ethereum au format UTC et fonctionne entièrement hors ligne. Vous ne lui fournissez pas de chaînes aléatoires, mais ce dont vous vous souvenez :

• un mot de passe de base que vous pensez avoir utilisé, avec des règles pour essayer des variantes : une majuscule, une année à la fin, un symbole remplacé par un autre ;
• une courte liste de mots que vous avez tendance à réutiliser, essayés dans différents ordres ;
• la longueur et les types de caractères, si vous vous en souvenez, pour garder la recherche restreinte.

BTCRecover passe ensuite ces candidats en revue de façon systématique. Pour certains formats de portefeuille, les scripts d’extraction de BTCRecover permettent à des spécialistes de travailler à partir d’un petit extrait des données du portefeuille, qui ne peut pas exposer les clés. Il n’existe pas de tel script pour les keystores Ethereum : la recherche s’effectue donc hors ligne sur une copie du keystore lui-même.

Le cas le plus favorable est une base familière dont la fin a été oubliée : le bon mot, mais un doute sur une majuscule, un chiffre ou un symbole à la fin. C’est une recherche réduite et circonscrite. Plus votre incertitude est grande, plus la recherche s’élargit.

Les limites de la récupération

Ne plus se souvenir du mot de passe n’exclut pas automatiquement une recherche. Une copie du keystore permet encore de tester une liste limitée de mots de passe courants et de variantes. L’intérêt de cette recherche dépend des candidats retenus, des paramètres de chiffrement du fichier et de la vitesse mesurée des essais. Un mot de passe long et généré aléatoirement peut être hors de portée en pratique ; le simple fait de l’avoir oublié ne permet pas de connaître sa robustesse.

L’autre impasse, c’est de n’avoir aucun fichier. Sans keystore, sans clé privée enregistrée et sans phrase de récupération, il ne reste rien à déchiffrer et personne ne peut accéder au portefeuille. Nous préférons vous le dire clairement plutôt que d’accepter un dossier dont nous savons d’avance qu’il ne peut pas aboutir.

Fichier keystore ou phrase de récupération : deux sauvegardes différentes

On confond souvent les deux, alors que cette différence détermine vos options. Un fichier keystore, c’est une clé privée, chiffrée par un mot de passe et enregistrée au format JSON. Une phrase de récupération est une liste de mots (généralement 12 ou 24) qui permet de régénérer tout un ensemble de clés selon la norme BIP-39. Ce sont deux sauvegardes distinctes, avec des voies de récupération distinctes.

En pratique : si vous avez le keystore, vous n’avez pas besoin de la phrase de récupération pour y accéder. Il vous faut le mot de passe. Et si quelqu’un vous demande un jour votre phrase de récupération pour « récupérer » un keystore, c’est un schéma d’arnaque, pas une étape légitime.

Après l’accès : ne vous fiez plus au keystore

Tournez la page. Un keystore, c’est une seule clé protégée par un seul mot de passe, et c’est justement un mot de passe oublié qui vous a coupé l’accès. Créez un nouveau portefeuille dont vous avez le contrôle, idéalement un portefeuille matériel, et transférez-y vos ETH et vos jetons. Une configuration basée sur une phrase de récupération vous offre une voie de récupération qu’un keystore à fichier unique n’a jamais eue.

Si vous n’avez plus accès à un keystore, que vous ayez oublié le mot de passe ou que vous ayez un doute sur le fichier, commencez par une évaluation gratuite : un avis honnête sur la possibilité de reconstituer le mot de passe, avant tout engagement. Crypto Recovers a mené à bien plus de 200 récupérations depuis 2019, travaille selon le principe « pas de récupération, pas de frais » et ne touche jamais à votre argent.

Si nous retrouvons le mot de passe, c’est vous qui déverrouillez le keystore et transférez les ETH et les jetons vers le nouveau portefeuille décrit plus haut. Les frais convenus font l’objet d’un paiement séparé prévu par le contrat ; ils ne sont jamais prélevés sur les fonds récupérés.

FAQ

Pourquoi le mot de passe de mon keystore Ethereum est-il signalé comme incorrect alors que j’ai la certitude qu’il est bon ?

Un message indiquant que le mot de passe est incorrect n’est pas toujours dû à un mot de passe oublié. Il se peut que vous ouvriez le mauvais portefeuille, que vous utilisiez une autre disposition de clavier ou que vous ayez fait une petite faute de frappe, par exemple une erreur de majuscule, de symbole ou de chiffre.

Puis-je extraire la clé privée d’un fichier keystore sans le mot de passe ?

Non. Un fichier keystore Ethereum stocke votre clé privée sous forme chiffrée. Sans le bon mot de passe, il est impossible de déchiffrer la clé privée ou d’y accéder.

Puis-je récupérer mon portefeuille si j’ai perdu le fichier keystore ?

Uniquement si vous disposez d’une autre sauvegarde, comme la clé privée ou la phrase de récupération. Si le fichier keystore a été supprimé par inadvertance, un logiciel de récupération de fichiers pourrait le restaurer à partir du support de stockage d’origine.

Peut-on utiliser MyCrypto en toute sécurité pour ouvrir un fichier keystore Ethereum ?

L’application de bureau MyCrypto n’est plus activement maintenue. Il est généralement plus sûr d’utiliser un logiciel de portefeuille encore pris en charge, capable d’importer des fichiers keystore JSON, et de vous en tenir aux applications de portefeuille officielles.

Combien de temps faut-il pour récupérer le mot de passe d’un keystore Ethereum ?

Le délai dépend de la complexité du mot de passe et de la quantité d’informations dont vous vous souvenez. Certains cas se résolvent rapidement, d’autres demandent plusieurs jours de tests ou s’avèrent irrécupérables.

Puis-je procéder à une attaque par force brute sur le mot de passe d’un keystore Ethereum à l’aide de Hashcat ?

Bien que cela soit techniquement possible, les fichiers keystore Ethereum sont conçus pour résister aux attaques par force brute. La récupération de mot de passe est bien plus efficace lorsqu’elle repose sur des indices ou sur une connaissance partielle du mot de passe d’origine.

Est-il encore possible de récupérer d’anciens fichiers du presale Ethereum ou d’anciens fichiers de portefeuille JSON ?

Oui, si le fichier du portefeuille existe encore et que le mot de passe peut être cerné. Les fichiers plus anciens, comme les portefeuilles du presale de 2014, utilisent un format JSON différent, mais ils peuvent tout de même être testés hors ligne avec des outils qui le prennent en charge ; consultez notre guide sur les portefeuilles presale Ethereum.