إدارة المتغيرات السرية بيئة وواجهة
المسار: تطوير نظام إدارة الأعراس ودعوات QR الوحدة: النشر والإنتاج
مدخل إلى الدرس: إدارة المتغيرات السرية بيئة وواجهة
إدارة المتغيرات السرية بيئة وواجهة — نظام إدارة الأعراس والمناسبات ودعوات QR | Next.js وPrisma | أديب الصلوي
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
أهداف هذا الدرس
- فصل .env.dev عن .env.production واضحة القيم.
- ضبط SIGNING_SECRET وقيم hit بقوة الفدية.
- دورة المفاتيح: توليد، تحرّك، بطأة، محو.
مثال
# توليد سر التوقيع بقوة عالية (محلياً)
openssl rand -base64 48
# أو عبر node
node -e "console.log(require('crypto').randomBytes(48).toString('base64'))المخطط: سفر المتغيرات من التطوير إلى الإنتاج
flowchart LR
L[".env (محلي)"] -->|DEV| VS["Vercel Settings"]
PR[".env.production (لا يُرفع)"] --> VS
VS -->|متغيرات كل env| SG["SIGNING_SECRET"]
VS -->|متغيرات كل env| DB["DATABASE_URL"]
قاعدة السريّة الوسطـى
- كل سر (SIGNING_SECRET، DB، API مفتاح الثالث) مدخل في منصة Vercel وليس في الملفات.
- اسم واحد ثابت SIGNING_SECRET؛ تتغيّر قيمته فقط — لا نعتمد على تغيير الأسماء في الكود.
- توليد بكثافة: 48 بايت base64 > 192 بت يكفي؛ ثم ندور المفتاح دورياً لحالات الطوارئ.
سياسة التدوير
عند قسم السر (rotation): نعيد توليد روابط الدعوات (token+hash) لأن تغيير SECRET يبطل قُبْل القديمة تلقائياً — صيّراها لدينا خاصية إبطال واحد.
تمرين تطبيقي: تولّد سر 48 بايت، ضعه في منصّة المتغيرات، ثم اقطع النصوص: حدد doct to else? ثم احذف أي نسخة تحرص من المحلي.
أخطاء شائعة يجب تفاديها
- نسخ .env.production إلى الحافظة ويتسرب— الناشر يرى سطر البيئة أحياناً.
- مشاركة سر الجهاز الواحد عبر عدة خدمات يربك البطالة.
- ترك SECRET في repo بغفلة من.gitignore ثم الحذف من repo هو بداية وليس نهاية.
معجم مصطلحات الدرس
- تدوير السر
- استبدال قيمة Secur بحيوية دون تغيير الكود.
- environments في Vercel
- فصل الثابتن dev/prev/prod لكل متغير.
- base64
- تمثيل بايتات عشوائية في نص سهل التوثيق.
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «إدارة المتغيرات السرية بيئة وواجهة»، ثم بيّن أين ستستخدمه داخل نظام تسجيل حضور دعوات مناسبة عبر رمز QR، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
الدرس التالي: قائمة الفحص النهائي قبل الإطلاق. من الأفضل إنهاء التجربة الحالية قبل متابعة الدرس التالي.
