سجّل الدخول إلى ERPC CLI واعرف أين تُحفظ مفاتيحك

سجّل دخول هذا الجهاز، وسيحفظ ERPC CLI الجلسة في سلسلة مفاتيحك أو في 1Password. تبيّن هذه الصفحة أيضًا أين تُحفظ مفاتيح العُقد وما الملفات التي يحتفظ بها erpc.

تصف هذه الصفحة ERPC CLI v0.1.0-rc.4، وهو إصدار تمهيدي.

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 على الجلسة عبر منح تفويض الجهاز في OAuth (device authorization grant). على جهاز بلا متصفح، يطبع erpc login --no-browser عنوان URL والرمز بدلًا من فتح متصفح، ويطبع erpc signup --no-browser عنوان URL لصفحة التسجيل. يعرض erpc whoami لمن تعود الجلسة المحفوظة، ويسجّل erpc logout الخروج ويحذف الجلسة المحفوظة.

في الطرفية، يسألك erpc login عن مكان الحفظ الذي تريد استخدامه: سلسلة مفاتيح نظام التشغيل، وهي الخيار الافتراضي، أو 1Password عندما يستجيب. يختار --store و--vault دون سؤال، ويُسجَّل الاختيار في config.toml، حيث تقرؤه الأوامر الأخرى.

إذا لم يكن هناك اختيار، لا ممرَّرًا ولا مسجَّلًا، يستخدم erpc حساب خدمة 1Password عند تعيين OP_SERVICE_ACCOUNT_TOKEN، وإلا فسلسلة مفاتيح نظام التشغيل إن وُجدت، وإلا فملفًا في دليل الحالة الخاص به. يبيّن erpc doctor مكان الحفظ المستخدم وسبب اختياره. مع حساب خدمة، لا يمرّر erpc المتغير OP_SERVICE_ACCOUNT_TOKEN إلا إلى عمليات op التي يبدؤها، ولا يكتب ذلك الرمز في أي مكان.

يحمل عنصر 1Password اسم الجهاز عنوانًا له، حتى لا يتشارك جهازان جلسة واحدة أبدًا. ويتجاوز ERPC_HOST_LABEL هذا الاسم.

سلسلة المفاتيح هي Secret Service حيث توجد خدمة منها تستجيب. وإلا فهي حلقة المفاتيح الدائمة الخاصة بمستخدمك في النواة، وهي في الذاكرة ولا تكون على القرص أبدًا: تدوم الجلسة حتى إعادة تشغيل الجهاز أو بضعة أيام دون استخدام، ثم يُطلب erpc login من جديد. لا تستطيع صدفة بُدئت دون تسجيل دخول خاص بها (su دون -، sudo -E) استخدام حلقة المفاتيح تلك، فيرفض erpc ويوضّح ذلك.

يصل erpc إلى سلسلة المفاتيح عبر /usr/bin/security. يستطيع أي برنامج آخر يعمل باسمك قراءة الجلسة بتشغيل security أيضًا، بينما تظل سلسلة المفاتيح تحفظ الجلسة مشفرةً أثناء التخزين وبعيدًا عن المستخدمين الآخرين.

يكتب erpc الجلسة في دليل الحالة الخاص به في ثلاث حالات: مع مكان الحفظ file، وللجلسة المركونة (رمز تحديث جرى تدويره ولم يتمكن من الوصول إلى مكان الحفظ)، وبعد كتابة انقطعت. يبيّن erpc doctor كل ملف من هذا النوع طوال مدة وجوده. على Unix تُنشأ هذه الملفات بالوضع 0600؛ أما على Windows فلا يضبط erpc أي أذونات من عنده.

يُحفظ جرد العُقد، والنسخ الاحتياطية للمفاتيح الأصلية التي يسمّيها دليل كل سلسلة، في 1Password. ليست كل المفاتيح في 1Password، وقد تحتفظ العقدة بمفتاح تحتاجه لتعمل. انسخ ما على المضيف احتياطيًا بنفسك: إعادة بناء ذلك المضيف دون نسخة احتياطية تؤدي إلى فقدان ما عليه. كما يرفض مدقق Sui نشط أو شاهد TRON منتخَب الانتقال إلى مضيف جديد.

لا تحتفظ عُقد RPC الأخرى بأي مفتاح توقيع لمدقق، لكن مضيفاتها تحتفظ بما ينشئه العميل لنفسه، مثل JWT المحرك أو هوية النظير أو ملف تعريف الارتباط (cookie) الخاص بـ RPC.

النسخة الاحتياطية للمفتاح وحدها لا تجعل استعادة المدقق آمنة. اتبع إجراء الاستعادة الخاص بالسلسلة قبل أن تستبدل خادمًا أو تستعيد بياناته؛ يوضّح دليل كل سلسلة كيفية استعادة مفاتيحها (العُقد).

لا يكتب مفاتيحَ العُقد على القرص في جهازك إلا أمرٌ واحد: يكتب erpc validator vote-account مفتاحَي الهوية والتصويت في ملفات بالوضع 0600 داخل دليل الحالة أثناء تشغيل Solana CLI، ثم يمسحها بعد ذلك. قد تترك عملية توقفت فجأة ملفًا إلى أن يزيله تشغيل لاحق.

يُحفظ مفتاح التداول وأسرار تطبيق erpc worker بمعزل عن هذه: المفاتيح والأسرار.