Inloggen bij ERPC CLI en zien waar uw sleutels worden bewaard

Log deze machine in, en ERPC CLI bewaart de sessie in uw sleutelhanger of in 1Password. Deze pagina laat ook zien waar nodesleutels worden bewaard en welke bestanden erpc bijhoudt.

Deze pagina beschrijft ERPC CLI v0.1.0-rc.4, een pre-release.

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 verkrijgt de sessie via de OAuth device authorization grant. Op een machine zonder browser drukt erpc login --no-browser de URL en de code af in plaats van een browser te openen, en drukt erpc signup --no-browser de inschrijvings-URL af. erpc whoami toont van wie de opgeslagen sessie is, en erpc logout logt uit en verwijdert de opgeslagen sessie.

Aan een terminal vraagt erpc login welke opslagplaats moet worden gebruikt: de sleutelhanger van het besturingssysteem, de standaardkeuze, of 1Password wanneer dat antwoordt. --store en --vault kiezen zonder te vragen, en de keuze wordt vastgelegd in config.toml, waar de andere commando's ze uitlezen.

Is er geen keuze opgegeven of vastgelegd, dan gebruikt erpc een 1Password-serviceaccount wanneer OP_SERVICE_ACCOUNT_TOKEN is ingesteld, anders de sleutelhanger van het besturingssysteem als die er is, en anders een bestand in de toestandsmap van erpc. erpc doctor meldt welke opslagplaats in gebruik is en waarom. Met een serviceaccount geeft erpc OP_SERVICE_ACCOUNT_TOKEN alleen door aan de op-processen die het zelf start, en schrijft het dat token nergens weg.

Het 1Password-item krijgt de naam van de machine als titel, zodat twee machines nooit één sessie delen. ERPC_HOST_LABEL overschrijft die naam.

De sleutelhanger is de Secret Service als er een antwoordt. Anders is het de persistente keyring van de kernel voor uw gebruiker, die in het geheugen staat en nooit op schijf: de sessie blijft geldig tot een herstart of tot ze een paar dagen niet is gebruikt, en daarna wordt opnieuw om erpc login gevraagd. Een shell die zonder eigen login is gestart (su zonder -, sudo -E) kan die keyring niet gebruiken; erpc weigert dan en meldt dat.

erpc bereikt de sleutelhanger via /usr/bin/security. Elk ander programma dat onder uw gebruiker draait, kan de sessie lezen door ook security uit te voeren, terwijl de sleutelhanger de sessie in rust nog steeds versleuteld en buiten bereik van andere gebruikers houdt.

erpc schrijft de sessie in drie gevallen naar zijn toestandsmap: met de opslagplaats file, voor een geparkeerde sessie (een geroteerd refresh-token dat de opslagplaats niet kon bereiken) en na een onderbroken schrijfactie. erpc doctor meldt elk dergelijk bestand zolang het bestaat. Op Unix worden deze bestanden aangemaakt met modus 0600; op Windows stelt erpc zelf geen rechten in.

De node-inventaris en de back-ups van de originele sleutels die de handleiding van elke chain noemt, worden in 1Password bewaard. Niet elke sleutel staat in 1Password, en een node kan een sleutel bevatten die hij nodig heeft om te draaien. Maak zelf een back-up van wat er op een host staat: wie die host opnieuw opbouwt zonder back-up, raakt het kwijt. Een actieve Sui-validator of een gekozen TRON-witness weigert bovendien te verhuizen naar een nieuwe host.

Andere RPC-nodes bevatten geen ondertekeningssleutel voor een validator, maar hun hosts bewaren wat de client voor zichzelf aanmaakt, zoals een engine-JWT, een peeridentity of een RPC-cookie.

Een sleutelback-up alleen maakt het herstel van een validator niet veilig. Volg de herstelprocedure van de chain voordat u een server vervangt of de gegevens ervan terugzet; de handleiding van elke chain beschrijft hoe u de sleutels terugzet (Nodes).

Slechts één commando schrijft nodesleutels naar de schijf van uw machine: erpc validator vote-account schrijft de identity- en vote-sleutels naar 0600-bestanden in de toestandsmap terwijl de Solana CLI draait, en wist ze daarna. Een proces dat afbreekt, kan een bestand achterlaten totdat een latere run het opruimt.

De tradingsleutel en de secrets van een erpc worker-app worden hier los van bewaard: Sleutels en secrets.