الأسرار ومتغيرات البيئة
إدارة مفاتيح API ومتغيرات البيئة الخاصة بـ Convex backend.
انقر على زر Settings في شريط أدوات Builder لفتح لوحة الإعدادات. تحتوي على ثلاثة أقسام:
| القسم | الغرض منه |
|---|---|
| General | اسم المشروع وقاعدة المعرفة |
| SEO & sharing | تعيين عنوان الموقع ووصفه وأيقونته |
| Secrets | متغيرات البيئة الخاصة بـ Convex backend |
كيف أضيف سرًّا؟
Section titled “كيف أضيف سرًّا؟”- انقر على زر Settings في شريط أدوات Builder
- افتح تبويب Secrets
- أدخل اسمًا (مثل
STRIPE_SECRET_KEY) والقيمة المقابلة له - انقر على Add
كيف أستخدم الأسرار في تطبيقي؟
Section titled “كيف أستخدم الأسرار في تطبيقي؟”تُزامَن الأسرار مع Convex backend الخاص بتطبيقك. يمكنك الإشارة إليها في كود Convex (action/mutation/query) باستخدام process.env.SECRET_NAME. وهي غير متاحة في كود الـ frontend أو كمتغيرات بيئة على مستوى الـ pod — وهذا يمنع تسرّب الأسرار إلى حزمة المتصفح.
يستخدم الذكاء الاصطناعي أسرارك تلقائيًا عند بناء الميزات:
"Accept payments with Stripe"← يستخدمSTRIPE_SECRET_KEYالخاص بك"Send emails with Resend"← يستخدمRESEND_API_KEYالخاص بك"Add Google OAuth"← يستخدمGOOGLE_CLIENT_IDوGOOGLE_CLIENT_SECRETالخاصَّين بك
الأسرار متاحة فقط في دوال Convex backend (actions وmutations)، وليس في كود React الخاص بالـ frontend. يُنشئ الذكاء الاصطناعي دوال Convex تقرأها عبر process.env.
هل يمكنني عرض/تعديل سرٍّ بعد إنشائه؟
Section titled “هل يمكنني عرض/تعديل سرٍّ بعد إنشائه؟”قيم الأسرار مُخفاة بشكل افتراضي. يمكنك تبديل الرؤية للكشف عن القيم أو تحديثها أو حذفها وإعادة إنشائها.
هل يستطيع الذكاء الاصطناعي رؤية أسراري؟
Section titled “هل يستطيع الذكاء الاصطناعي رؤية أسراري؟”يستطيع الذكاء الاصطناعي رؤية أسماء أسرارك دون قيمها. يتيح له ذلك الإشارة إلى متغير البيئة الصحيح عند بناء الميزات دون الكشف عن البيانات الحساسة.
الكشف عن المفاتيح الحساسة
Section titled “الكشف عن المفاتيح الحساسة”تكشف Proyecta تلقائيًا عن أنماط المفاتيح الحساسة الشائعة (مفاتيح API والرموز المميزة وكلمات المرور) وتخفي قيمها في واجهة المستخدم.
بيانات الموقع التعريفية
Section titled “بيانات الموقع التعريفية”يتيح لك قسم SEO & sharing تعيين ما يلي:
- Site title — يظهر في تبويب المتصفح ونتائج البحث
- Site description — يُستخدم لوصف SEO التعريفي
- Favicon — الأيقونة التي تظهر في تبويبات المتصفح
تُخزَّن هذه الإعدادات في مشروعك وتُطبَّق عند النشر.
قاعدة المعرفة
Section titled “قاعدة المعرفة”يتيح لك قسم Knowledge Base إضافة مواد مرجعية وسياق يستخدمه الذكاء الاصطناعي عند بناء تطبيقك. أضف إرشادات العلامة التجارية أو المواصفات التقنية أو أي توثيق آخر يساعد الذكاء الاصطناعي على اتخاذ قرارات أفضل.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل الأسرار مشفَّرة؟
تُخزَّن الأسرار في مشروعك وتُزامَن مع Convex deployment الخاص بك. ولا تظهر قط في الكود المُودَع (committed code).
هل يمكنني امتلاك أسرار مختلفة للتطوير والإنتاج؟
في الوقت الحالي، تنطبق الأسرار على كل من بيئة التطوير وـ Convex deployment المنشور (production). تُخطَّط إدارة الأسرار لكل بيئة على حدة لإصدار مستقبلي.
ماذا أفعل إذا كشفتُ سرًّا عن طريق الخطأ؟
احذف السر القديم فورًا، وألغِ المفتاح لدى مزود الخدمة الخارجي، ثم أنشئ مفتاحًا جديدًا.
ما الفرق بين الأسرار والموصِّلات؟
الأسرار هي متغيرات بيئة خام تديرها بنفسك. أما الموصِّلات فهي تكاملات مُدارة تتولى فيها Proyecta تخزين بيانات الاعتماد والمصادقة وتحديث الرموز المميزة وتسجيل التدقيق نيابةً عنك. استخدم الموصِّلات حين تتوفر (Stripe وSlack وResend وElevenLabs)، واستخدم الأسرار للخدمات التي لا تمتلك موصِّلًا بعد.