الأسرار: حفظ مفاتيح التطبيق مشفّرة

الوصول والباقات

افتح «الأسرار» من مجموعة «متقدّم». القسم يحتاج الاستضافة: مقفل في الباقة المجانية، ومتاح في الأساسية والمميزة والاحترافية. الطلب من باقة غير مشمولة يُرفض برمز 402.

إضافة سر

1. في لوحة «سر جديد» اكتب اسم المفتاح (مثل STRIPE_SECRET_KEY). الحروف تتحوّل إلى كبيرة تلقائيًا.
2. اكتب القيمة في حقل «القيمة» (حقل مخفي الأحرف).
3. اضغط «حفظ». تظهر «حُفظ السر مشفّرًا»، ويُفرَّغ الحقلان.

قواعد الاسم: يبدأ بحرف إنجليزي كبير، ويقبل الحروف الكبيرة والأرقام والشرطة السفلية، بطول من ٢ إلى ٦٤ خانة. خلاف ذلك يُرفض برسالة «اسم السر يبدأ بحرف كبير ويقبل الحروف الكبيرة والأرقام والشرطة السفلية». القيمة الفارغة تُرفض بـ«قيمة السر مطلوبة».

التشفير وما يُعرض

تُشفَّر القيمة بـ AES-256-GCM بمفتاح يُحفظ خارج قاعدة البيانات، فقاعدة بيانات مسروقة بلا المفتاح لا تعطي سرًا. الخادم لا يرسل القيمة إلى المتصفح في أي ردّ؛ لوحة «أسرار المشروع» تعرض لكل سر:

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

سجل التدقيق يسجّل أن المفتاح حُفظ أو حُذف، ولا يسجّل القيمة.

إن ظهر التنبيه «تخزين الأسرار غير مهيّأ على الخادم» فمفتاح التشفير غير مضبوط على الخادم، والحفظ مرفوض (زر «حفظ» معطّل والخادم يرد 503) حتى يُضبَط. هذا يتطلّب تواصلاً مع الدعم.

تغيير القيمة أو الحذف

1. لتدوير سر: أضفه من جديد بالاسم نفسه وقيمة جديدة واضغط «حفظ». يُستبدل السر القديم ويتحدّث تلميحه وتاريخه.
2. للحذف: اضغط أيقونة سلة المهملات بجانب السر. الحذف فوري بلا نافذة تأكيد ولا يمكن استرجاع القيمة.

لا توجد طريقة لقراءة قيمة سر محفوظ؛ إن نسيتها فاحصل عليها من مصدرها (مثل لوحة مزوّد الدفع) واحفظها من جديد.

كيف تُستعمل الأسرار

بحسب نص القسم نفسه، تُستعمل الأسرار اليوم في ميزات المنصّة وحدها: طرق الدخول في «المستخدمون» (مفاتيح OAuth) — انظر المستخدمون والوصول — وتوقيع حزم المتجر حين يتوفّر بانيها.

حقن الأسرار في بيئة تشغيل تطبيقك غير متاح بعد: شيفرة الخادم في تطبيقك لا تقرأها باسمها حتى يُوصَل مُشغّل الحاويات بهذا القسم.

لا تضع الأسرار في ملفات تُرسَل إلى المتصفح؛ قسم التدقيق (الأمان) يفحص ذلك تحديدًا.