احفظ مفاتيح API بأمان في الأسرار
باختصارالأسرار هي الخزنة المقفلة لتطبيقك، تحفظ فيها مفاتيح API والإعدادات الخاصة. أضفها من الخدمات السحابية ← الأسرار باسم مثل WEATHER_API_KEY، فتُحفظ مشفّرة، ولا تظهر مجددًا، ولا تقرؤها إلا شفرة الخادم في تطبيقك. انقر على «تطبيق على المعاينة» لاستخدامها فورًا، ويحصل عليها التطبيق المنشور في المرة التالية التي تنشر فيها. لا تلصق مفتاحًا في المحادثة أبدًا.
عندما يستخدم تطبيقك خدمة من شركة أخرى، كتوقعات الطقس أو قاعدة بيانات للوصفات أو مزوّد للمدفوعات، تمنحك تلك الخدمة مفتاح API: كلمة مرور سرية طويلة تتيح لتطبيقك استخدام حسابك. من يملك المفتاح يستطيع استخدام حسابك ورفع فاتورتك. لذلك تحتاج المفاتيح إلى مكان آمن.
هذا المكان هو الأسرار. لكل تطبيق أسراره الخاصة، محفوظة مشفّرة. تقرأ شفرة تطبيقك المفتاح عندما تحتاج إليه، ولا يستطيع أحد رؤيته، لا مستخدمو تطبيقك ولا الأشخاص الذين تشاركهم المشروع.
كيف أضيف سرًا؟
Section titled “كيف أضيف سرًا؟”-
افتح مشروعك وانقر على الخدمات السحابيةالأسرار.
-
في حقل الاسم، اكتب اسمًا للمفتاح، مثل
SPOONACULAR_API_KEY. استخدم الحروف الإنجليزية الكبيرة والأرقام والشرطة السفلية، ويحوّل MonstarX الحروف الصغيرة إلى كبيرة نيابةً عنك. -
في حقل القيمة، الصق المفتاح. يظهر على شكل نقاط أثناء الكتابة.
-
انقر على إضافة.
-
انقر على تطبيق على المعاينة، الذي يظهر في الأعلى على اليسار بعد الحفظ. يُعاد تشغيل المعاينة بالمفتاح الجديد لتجربه فورًا.
-
أخبر MonstarX في المحادثة بالميزة التي يجب أن تستخدمه: «استخدم SPOONACULAR_API_KEY لجلب القيم الغذائية لكل وصفة».
يحصل تطبيقك المنشور على الأسرار الجديدة والمعدّلة في المرة التالية التي تنشر فيها. راجع انشر تطبيقك.
لماذا يجب ألا ألصق مفتاحًا في المحادثة أبدًا؟
Section titled “لماذا يجب ألا ألصق مفتاحًا في المحادثة أبدًا؟”تُحفظ المحادثة مع مشروعك. يراها كل من تشاركه المشروع، وتقرؤها نماذج الذكاء الاصطناعي التي تنشئ تطبيقك، وتبقى في سجل مشروعك. المفتاح الذي يُلصق هناك لم يعد سرًا. والشفرة التي كُتب فيها مفتاح مكشوفة بالقدر نفسه، إذ ينتهي بها الأمر في ملفات مشروعك وفي ملفات التصدير وعلى GitHub إن ربطته.
إذا لصقت مفتاحًا في مكان ما عن طريق الخطأ، فأنشئ مفتاحًا جديدًا من لوحة تحكم تلك الخدمة، واحذف القديم هناك، واحفظ الجديد في الأسرار.
كيف أغيّر سرًا أو أحذفه؟
Section titled “كيف أغيّر سرًا أو أحذفه؟”- لتغييره: اكتب الاسم نفسه مجددًا بالقيمة الجديدة. يصبح الزر تحديث بدلًا من إضافة. انقر عليه، ثم على تطبيق على المعاينة.
- لحذفه: انقر على سلة المهملات بجانبه وأكّد. تتوقف أجزاء تطبيقك التي كانت تستخدمه عن العمل إلى أن تضيفه مجددًا.
لا يستطيع أحد قراءة القيمة المحفوظة مرة أخرى، ولا حتى أنت. تظهر كل قيمة على شكل نقاط مع تاريخ الإضافة. وإن احتجت إلى المفتاح، فاحصل عليه من الخدمة التي أصدرته.
ما الأسماء التي لا يمكنني استخدامها؟
Section titled “ما الأسماء التي لا يمكنني استخدامها؟”بعض الأسماء محجوزة لـ MonstarX أو للنظام الذي يعمل عليه تطبيقك، لذا يرفضها قسم الأسرار:
- الأسماء التي تبدأ بـ
MONSTARX_أوBETTER_AUTH_أوCLOUDFLARE_أوCF_أوGCP_أوRAILWAY_أوNODE_أوNPM_. - الأسماء
PATHوHOMEوPORTوNODE_ENVوTMPDIRوUSERوSHELLوPWDوCIوHOSTNAMEوFORCE_COLORوNO_COLOR. - الأسماء التي تبدأ بـ
VITE_، لأنها تُضمَّن في الصفحة حيث يستطيع كل زائر قراءتها. (ويمكن للتطبيق المستورد الذي يستخدم أسماءVITE_مسبقًا الاحتفاظ بها.)
يجب أن يبدأ الاسم بحرف، وألا يتجاوز 64 حرفًا.
ما إعدادات PUBLIC_؟
Section titled “ما إعدادات PUBLIC_؟”بعض القيم معدّة لتكون مرئية، مثل اسم الموقع أو مفتاح قابل للنشر تقول الخدمة إنه آمن في المتصفح. اجعل أسماء هذه القيم تبدأ بـ PUBLIC_. يمكن أن تصل إلى الصفحة، ويحذّرك MonstarX أثناء كتابة الاسم.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”من يستطيع رؤية أسراري؟
لا يستطيع أحد قراءة القيمة المحفوظة، بمن فيهم أنت. والأشخاص الذين تشاركهم المشروع لا يرون تبويب الخدمات السحابية إطلاقًا. لا تقرأ القيم إلا شفرة الخادم في تطبيقك.
أضفت مفتاحًا لكن تطبيقي ما زال يقول إنه مفقود.
انقر على تطبيق على المعاينة ليُعاد تشغيل المعاينة به. وللتطبيق المنشور، انشر مجددًا. وتحقق أيضًا من أن الاسم يطابق تمامًا ما يقرؤه التطبيق.
لماذا لا أرى القيمة التي حفظتها؟
لا تظهر القيم مجددًا بعد حفظها أبدًا، حتى لا تتسرب من شاشتك. لتغيير قيمة، احفظ الاسم نفسه بقيمة جديدة.
هل يستطيع تطبيقي استخدام سر في المتصفح؟
لا. لا تقرأ الأسرار إلا شفرة الخادم في تطبيقك، فلا تصل أبدًا إلى متصفح الزائر. أما القيمة التي تحتاج إليها الصفحة نفسها، مثل المفتاح القابل للنشر، فتحصل على اسم يبدأ بـ PUBLIC_.
ما الفرق بين الأسرار والموصلات؟
الموصلات نماذج جاهزة لخدمات معروفة، تحفظ مفاتيحها في الأسرار بأسماء ثابتة وتعلّم MonstarX كيف يستخدمها. أما الأسرار فلكل ما عدا ذلك.