وثائق

مفاتيح المزود

أدخل بيانات اعتماد مزود النماذج الخاصة بك واطلع على طريقة تخزينها وتحديد نطاقها.

تتيح لك مفاتيح المزود استخدام حسابات مزود النماذج الخاصة بك بدلاً من النماذج التي يتم توجيهها عبر Coroid. ويتم فوترة الاستخدام مباشرةً من قبل ذلك المزود وفقًا للأسعار التي اتفقت عليها معه.

يمكنك إدارتها ضمن إعدادات → مفاتيح المزود.

متى يجدر بك استخدام مفاتيح المزود الخاصة بك؟

يكون خيار BYOK مفيدًا عندما يكون لديك اتفاقيات مسبقة مع المزود، أو إنفاق ملزم، أو متطلبات شراء تقتضي أن يكون المزود موردًا مباشرًا.

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

كيف يتم التعامل مع المفاتيح؟

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

هذه الخاصية للكتابة فقط تم تصميمها بهذا الشكل عمدًا؛ فأي بيانات اعتماد يمكن قراءتها تعني أنها قد تُسرق بواسطة أي طرف لديه صلاحيات قراءة.

تحديث المفاتيح

قم باستبدال المفتاح بقيمة جديدة. تستمر العمليات الجارية على الاتصال الذي بدأت به؛ بينما تستخدم العمليات الجديدة المفتاح الجديد.

قم بتحديث المفتاح وفقًا لجدول زمني محدد من قبل المزود، وكلما غادر شخص لديه صلاحيات مسؤول. لا يمكن لـ Coroid تحديد ما إذا تم استخدام المفتاح في أماكن أخرى؛ فهذا ما تقوم به سجلات المراجعة الخاصة بالمزود.

تحديد نطاق المفاتيح

عندما يدعم المزود مفاتيح ذات نطاق محدد أو مقيدة، فاستخدم واحدة منها. فالمفتاح المحدود للنماذج وحدود الإنفاق المخصصة لـ Coroid يمثل مشكلة أقل خطورة في حال تم الكشف عنه.

حدد حد الإنفاق لدى المزود؛ فهو الحد الأقصى الفعلي الوحيد — أما حدود Coroid فتتحكم في السعة وليس في فاتورة المزود.

العودة إلى الخيار الافتراضي

إذا كان المفتاح غير صالح أو منتهي الصلاحية أو تجاوز حد المزود، فإن عمليات استدعاء النماذج باستخدامه ستفشل. ولا تستمر العمليات بشكل تلقائي عبر مزود آخر؛ فذلك سيكون تصرفًا مفاجئًا باستخدام أموال شخص آخر.

قم بإصلاح المفتاح، وستستأنف العمليات المعلقة.