المفاتيح الافتراضية لبوابة الذكاء الاصطناعي (Virtual Key)

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

لماذا تستخدم المفاتيح الافتراضية

• حماية المفاتيح الحقيقية — لا تتعامل التطبيقات والأدوات إلا مع المفاتيح الافتراضية، ولا يتسرّب المفتاح الحقيقي للمزوّد.
• تقسيم الصلاحيات حسب الغرض — يمكنك إنشاء مفاتيح افتراضية مختلفة لمشاريع / أدوات مختلفة، مع تقييد النماذج والقنوات والمعدل المتاحة لكل منها.
• إمكانية السحب في أي وقت — إذا تسرّب أحد المفاتيح أو أصبح غير مستخدم، فقم بإبطاله أو تبديله مباشرة دون التأثير على بقية المفاتيح.

المتطلبات الأساسية

• أن تكون مسجّل الدخول إلى حساب ServBay.
• أن تكون قد أضفت قناة متاحة واحدة على الأقل في صفحة القنوات.

إنشاء مفتاح افتراضي

انتقل إلى صفحة بوابة الذكاء الاصطناعي → المفاتيح (Keys)، ثم اضغط على إنشاء (Create):

• الاسم — يُستخدم لتحديد الغرض من المفتاح (مثل claude-code، my-app-dev).
• الوصف (اختياري) — ملاحظات إضافية.
• وقت الانتهاء — يمكن ضبطه على عدم الانتهاء أبداً أو على تاريخ محدّد.
• القنوات المسموح بها (اختياري) — استخدام التحديد المتعدد بالوسوم لتقييد توجيه هذا المفتاح إلى قنوات محدّدة فقط؛ وتركه فارغاً يعني عدم التقييد.
• النماذج المسموح بها (اختياري) — تقييد المفتاح باستدعاء نماذج محدّدة فقط؛ وتركه فارغاً يعني عدم التقييد.
• حدود المعدل (اختياري):
  • RPM / TPM — الحد الأقصى لعدد الطلبات / الرموز (Tokens) في الدقيقة.
  • RPD / TPD — الحد الأقصى لعدد الطلبات / الرموز في اليوم.

يمكن استرجاع النص الصريح في أي وقت

بعد إنشاء المفتاح بنجاح، تعرض البوابة النص الصريح للمفتاح (بصيغة servbay-sk-xxxxxxxx...). تحفظ البوابة النص الصريح محلياً، ويمكن استرجاعه لاحقاً من تفاصيل المفتاح؛ أما المفاتيح القديمة التي أُنشئت بطريقة التجزئة (hash) فلا يوجد لها نص صريح قابل للاسترجاع (يعيد الطلب رمز 409 عند محاولة الاسترجاع). وإذا شككت في تسرّب المفتاح، فقم مباشرة بـ"التبديل".

قائمة المفاتيح

تعرض قائمة المفاتيح لكل مفتاح افتراضي:

• البادئة — مثل servbay-sk-abcd...، تُستخدم للتعرّف.
• الحالة — فعّال (active)، مُبطَل (revoked)، منتهي الصلاحية (expired).
• وقت الإنشاء / وقت آخر استخدام.
• وسوم الأذونات — النماذج / القنوات المسموح بها، وحدود المعدل.

إدارة المفاتيح

في قائمة المفاتيح، يمكنك تنفيذ العمليات التالية على كل مفتاح:

العملية	الوصف	التأثير
تعديل (Edit)	تعديل الاسم والوصف والنماذج / القنوات المسموح بها وحدود المعدل	يسري فوراً دون تغيير المفتاح نفسه
تبديل (Renew)	إعادة إنشاء النص الصريح، ويتوقف النص الصريح القديم فوراً، ويمكن استرجاع النص الصريح الجديد في أي وقت	يتطلب تحديث جميع التطبيقات والأدوات التي تستخدم هذا المفتاح
إبطال (Revoke)	تعطيل المفتاح فوراً مع الإبقاء على سجل التدقيق	غير قابل للاستعادة؛ وستُرفض الطلبات التي تستخدم هذا المفتاح
حذف (Delete)	حذف المفتاح نهائياً	غير قابل للاستعادة

تبديل vs إبطال

• تبديل (Renew): يبقى المفتاح نفسه موجوداً، لكن يُستبدل بنص صريح جديد — مناسب للحالات التي تشك فيها بتسرّب المفتاح مع رغبتك في الاستمرار باستخدام إعدادات المفتاح نفسه، وتذكّر تحديث الجهات المستخدمة في الوقت ذاته.
• إبطال (Revoke): يجعل المفتاح عديم الفعالية بشكل دائم مع الإبقاء على السجل، لتسهيل التدقيق — مناسب للحالات التي تتأكد فيها من عدم الحاجة إلى مفتاح معيّن. يتطلب كل من التبديل والإبطال تأكيداً ثانياً.

العلاقة بالنقل بنقرة واحدة

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

الأسئلة الشائعة (FAQ)

• س: نسيت نسخ النص الصريح للمفتاح، ماذا أفعل؟
  • ج: يمكنك استرجاع النص الصريح من تفاصيل المفتاح؛ فقط المفاتيح القديمة التي أُنشئت بطريقة التجزئة لا يمكن استرجاعها، وفي هذه الحالة نفّذ "التبديل".
• س: ما الفرق بين الإبطال والحذف؟
  • ج: يحتفظ الإبطال بسجل المفتاح (لتسهيل التدقيق)، بينما الحذف يزيله نهائياً. وكلاهما يجعل المفتاح عديم الفعالية فوراً.
• س: بعد تقييد "النماذج المسموح بها"، ماذا يحدث عندما يطلب التطبيق نماذج أخرى؟
  • ج: سترفض البوابة طلبات النماذج الخارجة عن صلاحيات هذا المفتاح. تأكد من أن النماذج التي يستخدمها التطبيق ضمن القائمة المسموح بها، أو أزل التقييد.
• س: ماذا يحدث عند تفعيل حدود المعدل؟
  • ج: ستقوم البوابة بتقييد الطلبات التي تتجاوز RPM/TPM/RPD/TPD. يمكنك ملاحظة الاستخدام الفعلي في صفحة الإحصائيات ثم تعديل الحد الأقصى.

الخلاصة

تتيح لك المفاتيح الافتراضية توزيع قدرات الذكاء الاصطناعي على التطبيقات والأدوات بأقل صلاحيات وبطريقة قابلة للإبطال. ومع قيود النماذج / القنوات المسموح بها وحدود المعدل، يمكنك تخصيص بيانات اعتماد مصمّمة خصيصاً لكل حالة استخدام، وتبديلها أو إبطالها في أي وقت عند الحاجة، دون الحاجة إلى لمس مفتاح API الحقيقي للمزوّد.