Se connecter à ERPC CLI et voir où sont conservées vos clés

Connectez cette machine, et ERPC CLI conserve la session dans votre trousseau ou dans 1Password. Cette page indique aussi où se trouvent les clés des nœuds et quels fichiers erpc conserve.

Cette page décrit ERPC CLI v0.1.0-rc.4, une préversion.

erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami

erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami

erpc login obtient la session par le flux OAuth device authorization grant. Sur une machine sans navigateur, erpc login --no-browser affiche l'URL et le code au lieu d'ouvrir un navigateur, et erpc signup --no-browser affiche l'URL d'inscription. erpc whoami indique à qui appartient la session stockée, et erpc logout vous déconnecte et supprime la session stockée.

Dans un terminal, erpc login demande quel emplacement de stockage utiliser : le trousseau du système d'exploitation, qui est le choix par défaut, ou 1Password lorsqu'il répond. --store et --vault font ce choix sans poser de question, et le choix est inscrit dans config.toml, où les autres commandes le lisent.

Si aucun choix n'est indiqué ni inscrit, erpc utilise un compte de service 1Password lorsque OP_SERVICE_ACCOUNT_TOKEN est défini, sinon le trousseau du système d'exploitation s'il en existe un, sinon un fichier dans son répertoire d'état. erpc doctor indique quel emplacement de stockage est utilisé et pourquoi. Avec un compte de service, erpc ne transmet OP_SERVICE_ACCOUNT_TOKEN qu'aux processus op qu'il lance, et n'écrit ce token nulle part.

L'élément 1Password porte le nom de la machine, afin que deux machines ne partagent jamais une même session. ERPC_HOST_LABEL remplace ce nom.

Le trousseau est le Secret Service là où un service répond. Sinon, c'est le keyring persistant du noyau pour votre utilisateur, qui réside en mémoire et jamais sur le disque : la session dure jusqu'à un redémarrage ou quelques jours sans utilisation, après quoi erpc login est de nouveau demandé. Un shell lancé sans connexion propre (su sans -, sudo -E) ne peut pas utiliser ce keyring, et erpc refuse et le signale.

erpc accède au trousseau via /usr/bin/security. Tout autre programme qui s'exécute sous votre identité peut lire la session en exécutant lui aussi security, tandis que le trousseau garde toujours la session chiffrée au repos et hors de portée des autres utilisateurs.

erpc écrit la session dans son répertoire d'état dans trois cas : avec le stockage file, pour une session mise de côté (un refresh token renouvelé par rotation qui n'a pas pu atteindre le stockage), et après une écriture interrompue. erpc doctor signale chacun de ces fichiers tant qu'il existe. Sous Unix, ces fichiers sont créés avec le mode 0600 ; sous Windows, erpc ne définit lui-même aucune permission.

L'inventaire des nœuds, ainsi que les sauvegardes des clés d'origine que nomme le guide de chaque chaîne, sont conservés dans 1Password. Toutes les clés ne sont pas dans 1Password, et un nœud peut détenir une clé dont il a besoin pour fonctionner. Sauvegardez vous-même ce qui se trouve sur un hôte : reconstruire cet hôte sans sauvegarde fait perdre ce contenu. Par ailleurs, un validateur Sui actif ou un witness TRON élu refuse de passer sur un nouvel hôte.

Les autres nœuds RPC ne détiennent aucune clé de signature de validateur, mais leurs hôtes conservent ce que le client crée pour lui-même, comme un JWT de l'engine, une identité de pair ou un cookie RPC.

Une sauvegarde de clé ne suffit pas, à elle seule, à rendre sûre la récupération d'un validateur. Suivez la procédure de récupération de la chaîne avant de remplacer un serveur ou de restaurer ses données ; le guide de chaque chaîne indique comment restaurer ses clés (Nœuds).

Une seule commande écrit des clés de nœud sur le disque de votre machine : erpc validator vote-account écrit les clés d'identité et de vote dans des fichiers 0600 sous le répertoire d'état pendant l'exécution de la Solana CLI, puis les efface. Un processus qui s'interrompt brutalement peut laisser un fichier jusqu'à ce qu'une exécution ultérieure le supprime.

La clé de trading et les secrets d'une application erpc worker sont conservés à part : Clés et secrets.