De tradingsleutel en secrets van een app weghouden van de schijf van de server

Hoe de tradingsleutel de app bereikt

• Waar hij wordt bewaard: erpc worker key new maakt de sleutel in 1Password als erpc login de sessie daar bewaart, anders in de sleutelhanger, anders in de keystore. erpc.toml legt de verwijzing naar de sleutel en de publieke sleutel vast.
• Op de server: de agent van erpc worker houdt de sleutel alleen in het geheugen. Hij maakt zichzelf ondumpbaar, vergrendelt zijn geheugen en geeft de sleutel via een file descriptor aan de app; de app wist hem na het lezen.
• Na een herstart komt de worker vergrendeld terug: de app draait pas als erpc worker start de sleutel opnieuw stuurt. Een agent die faalt of geforceerd wordt beëindigd, wordt door systemd opnieuw gestart en komt op dezelfde manier vergrendeld terug.
• Een pakketupdate herstart een worker niet. deploy vertelt needrestart de worker-units met rust te laten: in de automatische modus stelt het ze uit, en als het aan een terminal wordt gevraagd, is het standaardantwoord voor die units nee, zodat een beveiligingsupdate zonder toezicht de app niet herstart. Als die regel niet kon worden geschreven, meldt de uitrol dat en gaat hij door, en draait de worker daarna zonder deze bescherming.

Kiezen waar waarden worden bewaard

1. 1Password, als erpc login de sessie daar bewaart of als --vault is opgegeven.
2. De OS-sleutelhanger, waar die een waarde over een herstart heen bewaart: macOS, Windows, en Linux met een desktop-keyring in een ingelogde sessie.
3. De keystore van erpc, op een Linux-machine zonder zo'n keyring: een headless server, WSL, een SSH-login. --store keychain wordt op zo'n machine geweigerd.

Een secret bewaren

erpc worker secret put API_TOKEN --generate          # the bot's own API token, made for you and shown to nobody
erpc worker secret put ERPC_API_KEY --from-account   # the account's RPC key, read from your account (or SOLANA_RPC_ENDPOINT in [vars])

erpc worker secret put API_TOKEN --generate          # the bot's own API token, made for you and shown to nobody
erpc worker secret put ERPC_API_KEY --from-account   # the account's RPC key, read from your account (or SOLANA_RPC_ENDPOINT in [vars])

• --generate maakt de waarde: 32 willekeurige bytes, als 64 hexadecimale tekens.
• --from-account bewaart de eerste RPC-key van uw account die de shared RPC accepteert. De keys worden op volgorde geprobeerd, de primaire eerst, met één getHealth per key, die 8 seconden krijgt om te antwoorden. Een key die met 401 of 403 wordt beantwoord, wordt geweigerd en de volgende wordt geprobeerd, en alleen een key die de RPC heeft geaccepteerd, wordt bewaard. Het commando meldt of het de primaire key van het account is of een andere (account_key met --json).
• Geen van beide waarden wordt afgedrukt, ook niet met --json. Het eerste gebruik van de keystore, of een vergrendelde keystore, vereist iemand aan de terminal.
• De keys worden vanaf deze machine geprobeerd, dus een key die beperkt is tot het adres van de server, wordt hier geweigerd, ook al werkt hij daar. Als elke key wordt geweigerd, bewaart --from-account niets, en bewaart u de bedoelde key zelf, onzichtbaar getypt of via een pipe ingevoerd. Als de RPC niet kon worden gevraagd, bewaart het niets en is erpc.toml ongewijzigd; voer hetzelfde commando opnieuw uit.

erpc worker secret put ERPC_API_KEY        # asks for the value, unseen

erpc worker secret put ERPC_API_KEY        # asks for the value, unseen

• --replace bewaart een nieuwe waarde voor een naam die al is ingesteld. erpc worker secret list toont de secret-instellingen op naam en waar elke instelling wordt bewaard.
• Een instelling die een datalijn levert (GRPC_ENDPOINT, SHREDS_ENDPOINT, SOLANA_SEND_RPC_ENDPOINT), is nooit een secret: --grpc, --shreds en --unlimited stellen die in.

De keystore

• master.json bevat een willekeurige hoofdsleutel van 32 bytes, verzegeld onder een sleutel die PBKDF2-HMAC-SHA256 (600.000 iteraties) uit uw wachtzin afleidt. Elk item bevat één waarde, verzegeld met ChaCha20-Poly1305 onder een eigen sleutel.
• De wachtzin: de eerste key new of secret put die de keystore gebruikt, laat u die kiezen, twee keer getypt aan een terminal, 12 tekens of meer. erpc accepteert hem alleen via die verborgen prompt, nooit via een argument, een omgevingsvariabele of een pipe.
• Ontgrendelen op Linux: zodra de wachtzin de keystore heeft geopend, wordt de ontgrendeling in de persistente keyring van de kernel bewaard, in het geheugen, totdat de machine herstart, de keyring ongebruikt blijft gedurende zijn verlooptijd bij inactiviteit (drie dagen, tenzij het systeem iets anders zegt) of erpc worker secret lock wordt uitgevoerd. erpc worker secret unlock vraagt vooraf om de wachtzin en meldt tot wanneer de ontgrendeling geldt. In een shell die zonder eigen login is gestart (su zonder -, sudo -E), wordt geen ontgrendeling bewaard en vraagt elk commando erom.
• Als er niemand aan een terminal zit, gebruikt een commando dat de keystore nodig heeft de ontgrendeling als die er is, en mislukt het anders, en noemt het daarbij erpc worker secret unlock. Een ontgrendelde keystore geeft secrets af, niet de tradingsleutel.
• Op macOS en Windows (--store keystore) wordt geen ontgrendeling bewaard: elk commando dat de keystore nodig heeft, vraagt één keer om de wachtzin en heeft dus een terminal nodig.

Wat de keystore beschermt, en wat niet

• Maak een back-up van de map keystore en onthoud de wachtzin. erpc kan geen van beide herstellen, en zonder een van beide is wat de keystore bevat verloren.
• Wie de keystore-bestanden en de wachtzin heeft, heeft de sleutel. PBKDF2 maakt elke gok traag, maar maakt een te raden wachtzin niet veilig.
• Zolang de keystore ontgrendeld is, kan elk programma dat onder uw gebruiker draait de hoofdsleutel uit de keyring van de kernel lezen (een programma waarvan de sessie uw keyring niet bevat, kan hem eraan koppelen) en elk item openen, ook dat van een sleutel. De eigen regels van erpc (de door [wallet] genoemde sleutel alleen lezen voor iemand aan de terminal, nooit voor een AI-tool; een sleutel die in de keystore is bewaard nooit als secret openen) zijn wat erpc doet; ze binden geen andere programma's die onder uw gebruiker draaien. Voer erpc worker secret lock uit als u klaar bent.
• Itemnamen worden niet verborgen, en de grootte van een item laat zien hoe lang de waarde is.
• Een gewijzigd bestand gaat niet open; een oudere kopie van hetzelfde item die op zijn plaats is teruggezet, wel.
• erpc worker secret rm verwijdert het keystore-item van een secret samen met de regel ervan in erpc.toml (tenzij een andere instelling van de app hetzelfde item noemt), en laat een waarde in 1Password of de sleutelhanger staan waar die is. Het maakt de schijf niet veilig schoon, en kopieën in uw back-ups blijven bestaan.
• erpc verwijdert of overschrijft nooit het item van een tradingsleutel. Om een sleutel te vervangen, verplaatst u eerst het geld en verwijdert u daarna zelf het bestand van de sleutel en [wallet].
• Een instelling kan niet WALLET heten, ongeacht hoofdletters of kleine letters, in de keystore of de sleutelhanger; --store 1password accepteert die naam.

Werken met de tradingsleutel