أبقِ مفتاح التداول والأسرار الخاصة بالتطبيق بعيدًا عن قرص الخادم

كيف يصل مفتاح التداول إلى التطبيق

• مكان الحفظ: ينشئ erpc worker key new المفتاح في 1Password عندما يحفظ erpc login الجلسة هناك، وإلا ففي سلسلة المفاتيح، وإلا ففي مخزن المفاتيح. ويسجّل erpc.toml مرجع المفتاح ومفتاحه العام.
• على الخادم: يحتفظ وكيل erpc worker بالمفتاح في الذاكرة فقط. فهو يجعل نفسه غير قابل للتفريغ ويقفل ذاكرته، ويسلّم المفتاح إلى التطبيق عبر واصف ملف؛ ويمسحه التطبيق بعد قراءته.
• بعد إعادة تشغيل الخادم، يعود الـ worker مقفلًا: لا يعمل التطبيق حتى يرسل erpc worker start المفتاح مرة أخرى. والوكيل الذي يفشل أو يُقتل يبدؤه systemd من جديد، ويعود مقفلًا بالطريقة نفسها.
• تحديث الحزم لا يعيد تشغيل الـ worker. يطلب deploy من needrestart أن يترك وحدات الـ worker وشأنها: في وضعه التلقائي يؤجلها، وعند سؤاله في الطرفية تكون إجابته الافتراضية بشأنها لا، لذا فإن تحديث الأمان الذي يجري دون إشراف لا يعيد تشغيل التطبيق. وعندما يتعذر كتابة تلك القاعدة، يذكر النشر ذلك ويستمر، ويعمل الـ worker حينها دون هذه الحماية.

اختيار مكان حفظ القيم

1. 1Password، عندما يحفظ erpc login الجلسة هناك أو عند تمرير --vault.
2. سلسلة مفاتيح نظام التشغيل، حيث تبقى القيمة محفوظة بعد إعادة تشغيل الجهاز: macOS وWindows وLinux مع حلقة مفاتيح سطح المكتب في جلسة مسجَّل الدخول إليها.
3. مخزن مفاتيح erpc، على جهاز Linux لا يحتوي على حلقة مفاتيح كهذه: خادم بلا واجهة رسومية، أو WSL، أو تسجيل دخول عبر SSH. ويُرفض --store keychain على جهاز كهذا.

حفظ سر

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 ينشئ القيمة: 32 بايتًا عشوائيًا، في صورة 64 حرفًا بالصيغة السداسية العشرية.
• --from-account يحفظ أول مفتاح من مفاتيح RPC في حسابك يقبله RPC المشترك. تُجرَّب المفاتيح بالترتيب، بدءًا بالمفتاح الأساسي، باستدعاء getHealth واحد لكل مفتاح، مع مهلة 8 ثوانٍ للرد. والمفتاح الذي يُجاب عنه بـ 401 أو 403 يُرفض ويُجرَّب التالي، ولا يُحفظ إلا المفتاح الذي قَبِله RPC. ويذكر الأمر ما إذا كان هو المفتاح الأساسي للحساب أم مفتاحًا آخر (account_key مع --json).
• لا تُطبع أي من القيمتين، ولا حتى مع --json. وأول استخدام لمخزن المفاتيح، أو استخدام مخزن مفاتيح مقفل، يحتاج إلى شخص أمام الطرفية.
• تُجرَّب المفاتيح من هذا الجهاز، لذا فإن المفتاح المقيَّد بعنوان الخادم يُرفض هنا رغم أنه يعمل هناك. وعندما تُرفض كل المفاتيح، لا يحفظ --from-account شيئًا، وتحفظ أنت المفتاح الذي تقصده يدويًا، بكتابته دون أن يظهر أو بتمريره عبر أنبوب. وعندما يتعذر سؤال RPC، لا يحفظ شيئًا ويبقى erpc.toml كما كان؛ شغّل الأمر نفسه مرة أخرى.

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 قيمة جديدة لاسم مضبوط مسبقًا. ويسرد erpc worker secret list الإعدادات السرية بأسمائها ومكان حفظ كل منها.
• الإعداد الذي يوفره خط بيانات (GRPC_ENDPOINT وSHREDS_ENDPOINT وSOLANA_SEND_RPC_ENDPOINT) ليس سرًّا أبدًا: يضبطه --grpc و--shreds و--unlimited.

مخزن المفاتيح

• يحتوي master.json على مفتاح رئيسي عشوائي بطول 32 بايتًا، مختوم بمفتاح يشتقه PBKDF2-HMAC-SHA256 (600,000 تكرار) من عبارة المرور الخاصة بك. ويحتوي كل مُدخل على قيمة واحدة، مختومة بـ ChaCha20-Poly1305 بمفتاح خاص به.
• عبارة المرور: أول key new أو secret put يستخدم مخزن المفاتيح يطلب منك اختيارها، بكتابتها مرتين في الطرفية، بطول 12 حرفًا أو أكثر. ولا يأخذها erpc إلا من ذلك الموجّه المخفي، ولا يأخذها أبدًا من وسيط أو متغير بيئة أو أنبوب.
• فتح القفل على Linux: بعد أن تفتح عبارة المرور مخزن المفاتيح، يُحفظ فتح القفل في حلقة المفاتيح الدائمة في النواة، في الذاكرة، حتى يُعاد تشغيل الجهاز، أو تبقى حلقة المفاتيح دون استخدام طوال مدة انتهاء الخمول الخاصة بها (ثلاثة أيام، ما لم يحدد النظام غير ذلك)، أو حتى تشغيل erpc worker secret lock. ويطلب erpc worker secret unlock عبارة المرور مسبقًا ويذكر حتى متى يبقى فتح القفل. وفي صدفة بُدئت دون تسجيل دخول خاص بها (su بدون -، وsudo -E)، لا يُحفظ أي فتح للقفل ويسأل كل أمر.
• عندما لا يوجد أحد أمام الطرفية، يستخدم الأمر الذي يحتاج إلى مخزن المفاتيح فتح القفل إن وُجد، وإلا يفشل، مع ذكر erpc worker secret unlock. ومخزن المفاتيح الذي فُتح قفله يسلّم الأسرار، لا مفتاح التداول.
• على macOS وWindows (--store keystore)، لا يُحفظ أي فتح للقفل: كل أمر يحتاج إلى مخزن المفاتيح يطلب عبارة المرور مرة واحدة، ولذلك يحتاج إلى طرفية.

ما يحميه مخزن المفاتيح، وما لا يحميه

• انسخ مجلد keystore احتياطيًا وتذكّر عبارة المرور. لا يستطيع erpc استعادة أي منهما، ودون وجودهما معًا يضيع ما يحتويه مخزن المفاتيح.
• من يملك ملفات مخزن المفاتيح وعبارة المرور يملك المفتاح. يجعل PBKDF2 كل تخمين بطيئًا، لكنه لا يجعل عبارة المرور القابلة للتخمين آمنة.
• ما دام قفل مخزن المفاتيح مفتوحًا، يستطيع أي برنامج يعمل باسمك قراءة المفتاح الرئيسي من حلقة المفاتيح في النواة (والبرنامج الذي لا تضم جلستُه حلقةَ مفاتيحك يستطيع أن يربطها بجلسته) وفتح كل مُدخل، بما في ذلك مُدخلات المفاتيح. وقواعد erpc الخاصة (ألا يقرأ المفتاح الذي يذكره [wallet] إلا لشخص أمام الطرفية، وألا يقرأه أبدًا لأداة ذكاء اصطناعي؛ وألا يفتح أبدًا مفتاحًا محفوظًا في مخزن المفاتيح بوصفه سرًّا) هي ما يفعله erpc؛ ولا تُلزم البرامج الأخرى التي تعمل باسمك. شغّل erpc worker secret lock عندما تنتهي.
• أسماء المُدخلات ليست مخفية، وحجم المُدخل يكشف طول القيمة.
• الملف الذي تغيّر لا يُفتح؛ أما النسخة الأقدم من المُدخل نفسه إذا أُعيدت إلى مكانه فتُفتح.
• يحذف erpc worker secret rm مُدخل السر في مخزن المفاتيح مع سطره في erpc.toml (ما لم يذكر إعداد آخر للتطبيق المُدخل نفسه)، ويترك القيمة الموجودة في 1Password أو سلسلة المفاتيح في مكانها. ولا يمسح القرص، وتبقى النسخ الموجودة في نسخك الاحتياطية.
• لا يحذف erpc مُدخل مفتاح التداول ولا يكتب فوقه أبدًا. لاستبدال مفتاح، انقل الأموال، ثم أزل ملفه و[wallet] بنفسك.
• لا يمكن تسمية إعداد WALLET، بأي حالة أحرف، في مخزن المفاتيح أو سلسلة المفاتيح؛ أما --store 1password فيقبل هذا الاسم.

العمل مع مفتاح التداول