الواجهة الخلفية والبيانات
المفاتيح السرية ومفاتيح API
خزّن المفاتيح الخاصة التي يحتاجها تطبيقك ليتصل بالخدمات الأخرى، واحفظها بأمان، وتعرّف على كيفية وصولها إلى المعاينة وإلى تطبيقك المنشور.
المفتاح السري قيمة خاصة يحتاجها تطبيقك، ولا ينبغي أن يراها أحد غيرك. غالبًا يكون مفتاح API أو رمزًا (token): رمزًا يشبه كلمة المرور، تعطيك إياه خدمة مثل الخرائط أو الطقس أو الرسائل النصية ليستخدمها تطبيقك.
المفاتيح السرية ليست جزءًا من كود تطبيقك. يخزّنها Buildliy بشكل منفصل ومشفّر، ويسلّمها إلى خادم تطبيقك عند تشغيله. بهذه الطريقة لا تظهر أبدًا في الكود، ولا في GitHub، ولا في الصفحات التي يحمّلها الزوار.
كيف تُحفظ المفاتيح السرية بأمان
- مشفّرة عند التخزين. يشفّر Buildliy كل مفتاح سري قبل حفظه.
- للخادم فقط. كود الخادم في تطبيقك وحده يستطيع قراءة المفتاح السري. ولا يُرسل أبدًا إلى متصفحات الزوار.
- لا يُعرض مرة أخرى. بعد حفظ المفتاح السري، لا يمكنك رؤية قيمته مجددًا، بل يمكنك استبداله فقط.
- للمالك فقط. مالك المشروع وحده يستطيع رؤية المفاتيح السرية وتغييرها في إدارة ← المفاتيح السرية. يمكن لأي عضو في الفريق أن يجيب عن بطاقة المفتاح التي يعرضها الذكاء الاصطناعي في تطبيق مشترك، لكنه لا يستطيع استبدال مفتاح حفظه شخص آخر من قبل.
عندما يطلب الذكاء الاصطناعي مفتاحًا
إذا كانت ميزة طلبتها تحتاج إلى مفتاح، يتوقف الذكاء الاصطناعي ويعرض بطاقة في المحادثة. هناك نوعان من البطاقات.
بطاقة ربط، للخدمات الموجودة في قائمة الموصّلات في Buildliy، مثل Resend وTwilio وAirtable وSendGrid. انقر على ربط مع اسم الخدمة لإضافة مفتاحك. يتحقق Buildliy من أن المفتاح يعمل مع الخدمة قبل حفظه، ويحفظه مشفّرًا، ويضيفه إلى حسابك لتستخدمه في تطبيقاتك الأخرى أيضًا. وبمجرد اكتمال الربط، يستأنف الذكاء الاصطناعي عملية الإنشاء. إذا سبق أن ربطت الخدمة لكنها غير مفعّلة بعد لهذا التطبيق، يظهر على الزر المتابعة مع واسم الخدمة بدلًا من ذلك. وإذا كانت الخدمة مربوطة ومفعّلة لهذا التطبيق، يستخدمها الذكاء الاصطناعي مباشرة ولا تظهر لك أي بطاقة. أما تخطي مؤقتًا فيغلق البطاقة دون ربط أي شيء: يرد الذكاء الاصطناعي بأن بإمكانك ربط الخدمة في أي وقت من صفحة الموصّلات، وينتظر رسالتك التالية. راجع الموصّلات.
بطاقة مفتاح، لأي مفتاح آخر. تعرض سؤال الذكاء الاصطناعي، والاسم الذي سيُحفظ به المفتاح بعد عبارة تم الحفظ باسم (مثل WEATHER_API_KEY)، ومربعًا تلصق فيه المفتاح.
احصل على المفتاح من الخدمة
سجّل الدخول إلى موقع الخدمة وانسخ مفتاح API الخاص بك. يوضح سؤال البطاقة عادةً سبب الحاجة إلى المفتاح.
الصقه في البطاقة
الصق المفتاح في المربع. انقر على أيقونة العين إذا أردت التأكد مما لصقته، وأخفِه مرة أخرى قبل مشاركة شاشتك.
انقر على حفظ
يُحفظ المفتاح مشفّرًا. وكما تقول البطاقة: «تم الحفظ بأمان وبتشفير. لن يظهر أبدًا في المحادثة أو في كود تطبيقك. يمكنك تغييره لاحقًا من إدارة ← المفاتيح السرية.» (يرى أعضاء الفريق عبارة «يمكن لمالك المشروع تغييره لاحقًا.») بعد ذلك يواصل الذكاء الاصطناعي الإنشاء باستخدامه.
إذا نقرت على تخطي، لا يُحفظ شيء ويواصل الذكاء الاصطناعي عمله دون المفتاح. ولن تعمل الميزة التي تحتاج إليه حتى تضيف المفتاح في إدارة ← المفاتيح السرية.
أما قبول المدفوعات فيُعدّ بطريقة مختلفة. راجع قبول المدفوعات.
لا تلصق المفاتيح في المحادثة
كل ما تكتبه في مربع المحادثة يُحفظ في محادثتك ويقرؤه الذكاء الاصطناعي، وهو غير مخفي ولا مشفّر مثل المفتاح السري. استخدم دائمًا بطاقة المفتاح أو إدارة ← المفاتيح السرية بدلًا من ذلك.
إذا لصقت مفتاحًا عن طريق الخطأ
يراقب Buildliy مربع المحادثة بحثًا عن المفاتيح السرية، مثل مفتاح Stripe السري، أو رمز GitHub، أو عنوان قاعدة بيانات مع كلمة المرور الخاصة بها. لا تُرسل الرسالة التي تحتوي على مفتاح. بدلًا من ذلك، تظهر فوق مربع المحادثة بطاقة بعنوان يبدو أن هذا مفتاح سري، فور لصق المفتاح أو الضغط على إرسال. تعرض البطاقة نوع المفتاح مع إخفاء معظمه، وتقدّم لك الخيارات التالية:
- حفظ كمفتاح سري: يحفظه في إدارة ← المفاتيح السرية باسم يظهر في الحفظ باسم، مثل
STRIPE_SECRET_KEY. يمكنك تغيير الاسم. وعندما يكون المفتاح تابعًا لخدمة في قائمة الموصّلات، يمكنك الاختيار بين حفظ كموصّل … الخاص بك (يتحقق Buildliy من أنه يعمل ويحفظه في حسابك لتستخدمه تطبيقاتك الأخرى أيضًا) وحفظ كمفتاح سري لهذا التطبيق. في مساحة عمل مشتركة، عليك أولًا تحديد مربع للتأكيد على أن أعضاء الفريق الذين ينشئون في هذا التطبيق يمكنهم استخدام هذا الاتصال. - تعديل الرسالة: يضع المؤشر عند المفتاح لتتمكن من حذفه. ولن تُرسل الرسالة ما دام المفتاح فيها.
- ليس مفتاحًا — إرسال على أي حال: يرسل رسالتك كما هي، للحالات النادرة التي تخطئ فيها البطاقة.
بعد الحفظ، يتحول المفتاح في رسالتك إلى [saved as STRIPE_SECRET_KEY]، فتستطيع إرسال بقية رسالتك بأمان. مالك المشروع وحده يستطيع حفظه: يرى أعضاء الفريق إزالة المفتاح بدلًا من ذلك، وتطلب منهم البطاقة أن يضيف المالك المفتاح في إدارة ← المفاتيح السرية. أما في الصفحة الرئيسية، قبل أن يوجد تطبيقك، فتعرض عليك البطاقة إزالة المفتاح مؤقتًا.
المفاتيح المخصصة لتكون عامة، مثل مفتاح Stripe العام (pk_…)، لا يُنبَّه إليها. وإذا أرفقت ملف Word أو Excel أو ملفًا نصيًا يحتوي على مفتاح سري، فإن المفتاح يُخفى عن الذكاء الاصطناعي.
إذا أُرسل مفتاح في المحادثة رغم ذلك، فاعتبره مكشوفًا. انتقل إلى موقع الخدمة، وأنشئ مفتاحًا جديدًا واحذف القديم، ثم احفظ المفتاح الجديد في إدارة ← المفاتيح السرية.
إضافة المفاتيح السرية أو تغييرها أو إزالتها بنفسك
فتح المفاتيح السرية
افتح تبويب إدارة واختر المفاتيح السرية.
ملء إضافة مفتاح سري جديد
تحت إضافة مفتاح سري جديد، أدخل الاسم بأحرف كبيرة تفصل بينها شرطات سفلية، مثل
WEATHER_API_KEY، ثم القيمة، ثم الوصف إن شئت لتتذكر فائدة المفتاح.حفظه
انقر على حفظ. سيظهر تحت المفاتيح السرية المحفوظة.
يجب أن يطابق الاسم الاسم الذي يستخدمه كود تطبيقك. وإذا لم تكن متأكدًا، اسأل الذكاء الاصطناعي عن الاسم الذي يتوقعه.
ما اسم المفتاح السري الذي تقرأ منه أداة الطقس مفتاحها؟
- تغيير مفتاح سري. انقر على أيقونة السهم الدائري (تبديل هذا المفتاح السري)، والصق القيمة الجديدة، وانقر على تبديل. على الشاشات الأوسع، يعرض عمود مرات التبديل عدد المرات التي بُدّل فيها المفتاح السري.
- الحفظ فوق اسم موجود. حفظ مفتاح سري باسم محفوظ مسبقًا يستبدل القيمة القديمة. يسألك Buildliy أولًا: تنتقل معاينتك إلى القيمة الجديدة فورًا، بينما يحتفظ تطبيقك المنشور بالقيمة القديمة إلى أن تنشر مرة أخرى. وتختار بين الإبقاء على القديم أو استبدال.
- إزالة مفتاح سري. انقر على أيقونة سلة المهملات (حذف هذا المفتاح السري) وأكّد. لن يعود تطبيقك قادرًا على استخدامه: في المعاينة فورًا، وفي تطبيقك المنشور عند النشر التالي.
المفاتيح السرية في المعاينة وفي تطبيقك المنشور
- المعاينة تلتقط المفتاح السري الجديد أو المعدّل أو المحذوف تلقائيًا. لا تحتاج إلى إعادة الإنشاء.
- تطبيقك المنشور يحصل على مفاتيحه السرية عند النشر. بعد تغيير مفتاح سري، انشر مرة أخرى ليستخدم موقعك المنشور القيمة الجديدة. وعندما يكون تطبيقك منشورًا، تذكّرك الرسالة التي تراها بعد أي تغيير في إدارة ← المفاتيح السرية، أو بعد حفظ مفتاح من بطاقة في المحادثة، بإعادة النشر.
المفاتيح السرية والموصّلات
كلاهما يحفظ المفاتيح بأمان. الفرق في مكان حفظها ومن يستطيع استخدامها.
| موصّل | مفتاح سري | |
|---|---|---|
| مكان الحفظ | في حسابك على Buildliy | في تطبيق واحد |
| من يستخدمه | كل تطبيقاتك الخاصة افتراضيًا (يمكنك إيقافه لتطبيق واحد من إدارة ← الموصّلات)؛ أما التطبيق المشترك مع فريقك فلا يستخدمه إلا بعد أن تفعّله هناك | هذا التطبيق فقط |
| التحقق قبل الحفظ | نعم، يختبر Buildliy المفتاح مع الخدمة | لا |
| الأنسب لـ | الخدمات الموجودة في قائمة الموصّلات التي تستخدمها في عدة تطبيقات | أي مفتاح آخر، أو مفتاح مختلف لتطبيق واحد فقط |
إذا كان لمفتاح سري وموصّل الاسم نفسه، فإن المفتاح السري هو الذي يُعتمد في ذلك التطبيق. وهذه طريقة سهلة لاستخدام مفتاح مختلف في تطبيق واحد.
المفاتيح التي يضيفها Buildliy لك
بعض الميزات تضيف مفاتيح سرية نيابة عنك. إذا كان تطبيقك يستخدم الذكاء الاصطناعي في تطبيقك، فسترى BUILDLIY_API_KEY وBUILDLIY_API_URL. وإذا كان يقبل المدفوعات، فسترى BUILDLIY_API_KEY وBUILDLIY_WEBHOOK_SECRET. وإذا كان يتيح للزوار رفع الملفات أو يبلّغ عن أخطائه، فسترى BUILDLIY_API_KEY وBUILDLIY_API_URL. وإذا كانت فيه مهام مجدولة، فسترى BUILDLIY_CRON_SECRET. لا تغيّرها ولا تحذفها، وإلا توقفت تلك الميزات عن العمل.
مواضيع ذات صلة
ما زلت عالقًا؟ اقرأ الأسئلة الشائعة أو تواصل معنا.