كيف تضيف مفاتيح API والأسرار في ChanTan Studio

خزّن مفتاح خدمة مثل Stripe أو Resend ليستعمله تطبيقك بأمان — يُلصق مرة واحدة، ويُحفظ مشفّرًا، ولا يظهر في المحادثة ولا في الكود. إليك مكانه بالضبط.

بعض الميزات تحتاج مفتاحًا من خدمة خارجية — بوابة دفع، أو خدمة إرسال بريد، أو خدمة خرائط. والمفتاح أشبه بكلمة مرور تسمح لتطبيقك بالتحدث إلى تلك الشركة.

فلو أردت لموقع "دار زيتون" أن يستقبل الدفع أونلاين، سيحتاج مفتاحًا من Stripe.

ويحفظ ChanTan هذه المفاتيح في "الأسرار" — "أضف المعلومات الحساسة، مثل مفاتيح API، التي يحتاجها تطبيقك ليعمل بأمان."

وأسهل طريق هو ألا تفعل شيئًا. فحين تحتاج ميزةٌ مفتاحك، يعرض الذكاء الاصطناعي بطاقة "الصق مفتاحك" مُقنَّعة أسفل رسالته مباشرة في المحادثة. ويذهب المفتاح مباشرةً إلى تخزين مشفّر، ويُستعمل على الخادم فقط، ولا يظهر أبدًا في المحادثة ولا في كودك.

وهذه الصفحة مخصصة لحين ترغب أن تضيف مفتاحًا أو تغيّره بنفسك.

1. افتح "الإدارة ▾" ← "قاعدة البيانات"

أعلى مشروعك، اضغط "الإدارة ▾"، ثم "قاعدة البيانات".

2. اذهب إلى "متقدم" ← "الأسرار"

من "غرفة محرك تطبيقك"، ابحث عن الصف الأهدأ "متقدم" وافتح "الأسرار".

3. اضغط "إضافة سر جديد"

سيظهر نموذج يطلب منك اسمًا وقيمة.

4. اكتب الاسم، والصق القيمة

الاسم مجرد تسمية (مثلًا الاسم الذي طلبته منك الخدمة). أما القيمة فهي المفتاح نفسه — الصقه كما هو تمامًا، بلا مسافات زائدة.

⚠️ الأسماء التي تبدأ بـ CHANTAN_ مرفوضة. فهي محجوزة: "يدير Chantan بعض الأسرار نيابةً عنك خلف الكواليس ليتمكن تطبيقك من استخدام الذكاء الاصطناعي. تُحفظ آمنة ومخفية هنا." ولا يمكنك تغييرها أو حذفها، ولا تحتاج إلى ذلك أصلًا.

5. اضغط "إنشاء الأسرار"

✅ تم! يظهر مفتاحك الآن في القائمة باسمه وتاريخه فقط — لا بقيمته أبدًا. وهذا مقصود: بعد الحفظ لا تُعرض القيمة عليك مرة أخرى، ولا حتى لك أنت.

استبدال مفتاح تغيّر

اطلب ذلك في المحادثة — قل شيئًا مثل "مفتاح Stripe عندي تغيّر" — فتظهر لك بطاقة "استبدال المفتاح" لتلصق فيها الجديد.

حذف مفتاح

الحذف يفرض عليك كتابة كلمة delete أولًا، لأن إزالة مفتاح قد توقف جزءًا من تطبيقك عن العمل.

⚠️ دوّن مفاتيحك في مكان آمن خاص بك. فـChanTan لا يعرض قيمة محفوظة مرة أخرى أبدًا؛ وإن حذفت مفتاحًا ولم يكن لديك نسخة منه في مكان آخر، فسيلزمك أن تطلب مفتاحًا جديدًا من الخدمة نفسها.

الحدود

موضوع متصل: كود الخادم الذي يستعمل مفاتيحك

الـWebhooks والتكاملات من جهة الخادم (استدعاءات الدفع الراجعة مثلًا) تعمل بوصفها "دوال Edge" — "أجزاء صغيرة من كود الخادم تشغّل أشياء مثل Webhooks المدفوعات والتكاملات. اطلب من الذكاء الاصطناعي في المحادثة إضافة واحدة."

وتلك الشاشة قائمة للقراءة فقط — وليس فيها زر إنشاء عن قصد. ولإضافة واحدة، اشرح ما تحتاجه في المحادثة.

حدود وأمان نقولها لك بصراحة

• مفاتيحك لا تُرفع إلى GitHub أبدًا. فإن استعملت "رفع إلى GitHub"، يُقال لك: "تم استبدال مفاتيح قاعدة بياناتك بعناصر نائبة — لا تُرفع أبدًا إلى GitHub."
• المفاتيح تُستعمل على الخادم فقط — ولا تصل إلى متصفحات زوّار تطبيقك.
• ميزات الذكاء الاصطناعي داخل تطبيقك لا تحتاج أي مفتاح. روبوتات المحادثة وتوليد الصور وفهم الصور تعمل مباشرةً، وتُحاسب من محفظة رصيدك.
• لا يستطيع ChanTan أن يجلب لك مفتاحًا. إن ضاع منك، احصل على مفتاح جديد من الخدمة التي أصدرته، ثم الصق الجديد.

إذا حدث خطأ