Đăng nhập vào ERPC CLI và xem các khóa của bạn được lưu ở đâu

Hãy đăng nhập trên máy này, và ERPC CLI sẽ giữ phiên trong chuỗi khóa của bạn hoặc 1Password. Trang này cũng cho biết khóa node được lưu ở đâu và erpc giữ những tệp nào.

Trang này mô tả ERPC CLI v0.1.0-rc.4, một bản 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 lấy phiên thông qua OAuth device authorization grant. Trên máy không có trình duyệt, erpc login --no-browser in ra URL và mã thay vì mở trình duyệt, và erpc signup --no-browser in ra URL đăng ký. erpc whoami cho biết phiên đã lưu thuộc về ai, và erpc logout đăng xuất và xóa phiên đã lưu.

Khi chạy trong terminal, erpc login hỏi dùng nơi lưu nào: chuỗi khóa của hệ điều hành, vốn là lựa chọn mặc định, hoặc 1Password khi nó phản hồi. --store và --vault chọn mà không hỏi, và lựa chọn được ghi vào config.toml, nơi các lệnh khác đọc nó.

Khi không có lựa chọn nào, dù được chỉ định hay đã ghi lại, erpc dùng tài khoản dịch vụ 1Password khi OP_SERVICE_ACCOUNT_TOKEN được đặt, nếu không thì dùng chuỗi khóa của hệ điều hành khi có, nếu không nữa thì dùng một tệp trong thư mục trạng thái của nó. erpc doctor cho biết nơi lưu nào đang được dùng và lý do. Với tài khoản dịch vụ, erpc chỉ truyền OP_SERVICE_ACCOUNT_TOKEN cho các tiến trình op mà nó khởi chạy, và không ghi token đó vào bất cứ đâu.

Mục 1Password được đặt tiêu đề theo tên của máy, để hai máy không bao giờ dùng chung một phiên. ERPC_HOST_LABEL ghi đè tên này.

Chuỗi khóa là Secret Service ở nơi có Secret Service phản hồi. Nếu không, đó là keyring bền vững của kernel dành cho người dùng của bạn, nằm trong bộ nhớ và không bao giờ nằm trên ổ đĩa: phiên tồn tại cho đến lần khởi động lại hoặc đến khi không được dùng trong vài ngày, sau đó erpc login sẽ được yêu cầu lại. Một shell được khởi động mà không có phiên đăng nhập riêng (su không có -, sudo -E) không thể dùng keyring đó, và erpc sẽ từ chối và báo rõ điều này.

erpc truy cập chuỗi khóa qua /usr/bin/security. Bất kỳ chương trình nào khác chạy dưới tài khoản của bạn cũng có thể đọc phiên bằng cách chạy security, trong khi chuỗi khóa vẫn giữ phiên ở dạng mã hóa khi lưu trữ và tách biệt khỏi những người dùng khác.

erpc ghi phiên vào thư mục trạng thái của nó trong ba trường hợp: với nơi lưu file, với một phiên được giữ tạm (một refresh token đã được xoay vòng nhưng không đến được nơi lưu), và sau một lần ghi bị gián đoạn. erpc doctor báo cáo từng tệp như vậy chừng nào tệp đó còn tồn tại. Trên Unix, các tệp này được tạo với mode 0600; trên Windows, erpc không tự đặt quyền nào.

Danh mục node, và các bản sao lưu khóa gốc mà hướng dẫn của từng chain nêu tên, được lưu trong 1Password. Không phải khóa nào cũng nằm trong 1Password, và một node có thể giữ khóa mà nó cần để chạy. Hãy tự sao lưu những gì nằm trên host: dựng lại host đó mà không có bản sao lưu sẽ làm mất chúng. Một Sui validator đang hoạt động hoặc một TRON witness đã được bầu cũng từ chối chuyển sang host mới.

Các RPC node khác không giữ khóa ký nào cho validator, nhưng host của chúng giữ những gì client tự tạo cho mình, chẳng hạn engine JWT, peer identity hoặc RPC cookie.

Chỉ riêng một bản sao lưu khóa không làm cho việc khôi phục validator trở nên an toàn. Hãy làm theo quy trình khôi phục của chain trước khi bạn thay server hoặc khôi phục dữ liệu của nó; hướng dẫn của từng chain cho biết cách khôi phục khóa của chain đó (Node).

Chỉ có một lệnh ghi khóa node ra ổ đĩa trên máy của bạn: erpc validator vote-account ghi khóa identity và khóa vote vào các tệp 0600 trong thư mục trạng thái trong khi Solana CLI chạy, rồi xóa sạch chúng sau đó. Một tiến trình bị dừng đột ngột có thể để lại tệp cho đến khi một lần chạy sau dọn nó đi.

Khóa trading và các secret của một ứng dụng erpc worker được giữ riêng với những khóa này: Khóa và secret.