إنشاء مفاتيح API وحمايتها
أنشئ بيانات اعتماد مباشرة أو تجريبية بأقل صلاحيات لازمة، وقيد عناوين IP عند الحاجة، ودوّر المفاتيح أو ألغها بأمان.
- اختر السياقحدد مساحة العمل الشخصية أو مساحة المؤسسة.
- حدد الصلاحياتسمِّ المفتاح واختر النطاقات الضرورية فقط.
- قيّد المصادرأدخل اختيارياً عناوين IP أو الشبكات المسموح بها.
- احفظه مرة واحدةخزّن السر الظاهر في مدير أسرار محمي.
- أدر الوصولدوّر المفتاح للاستبدال وألغ بيانات الاعتماد المتوقفة.
النطاقات والأدوار
يعرض قسم مفاتيح API وصف النطاقات المدعومة، ومنها قراءة الحساب واستدلال الذكاء الاصطناعي وتدريبه ومهام استضافة AI وتحويل النماذج وخدمات البلوك تشين وصلاحيات تذاكر الدعم. في المؤسسة، يدير المالك والمسؤول المفاتيح، ويمكن للأعضاء عرضها دون إدارتها. اختر السياق الذي ينبغي أن يتبع له المفتاح، لأن الرؤية والصلاحية مرتبطتان بالسياق.
- حدد المؤسسة المطلوبة قبل فتح مفاتيح API.
- اقرأ وصف النطاقات واختر العمليات اللازمة فقط.
- اطلب المساعدة من المالك أو المسؤول إن تعذرت الإدارة.
إنشاء مفتاح مباشر
يتطلب المفتاح القياسي اسماً من 2 إلى 120 محرفاً ونطاقاً واحداً على الأقل من القائمة وقائمة IP اختيارية. أدخل عناوين IP صحيحة أو شبكات CIDR، عنواناً واحداً في كل سطر، ضمن الحد الظاهر. تسمح القائمة الفارغة بالاتصال من أي عنوان IP. تظهر القيمة النصية الكاملة مرة واحدة بعد الإنشاء، ولا يخزن سوى تجزئتها، لذا لا يمكن استرجاعها لاحقاً.
- استخدم اسماً يصف التطبيق أو البيئة.
- اختر أقل النطاقات اللازمة وعناوين المصدر الثابتة المطلوبة.
- احفظ القيمة الظاهرة مباشرة في مخزن أسرار معتمد.
مفتاح استدلال تجريبي
تتيح لوحة التحكم إنشاء مفتاح تجريبي يقتصر على استدلال الذكاء الاصطناعي والحصة الشهرية للطلبات الظاهرة فيها. يسمح بمفتاح تجريبي نشط واحد فقط لكل سياق حساب أو مؤسسة. إذا وجد مفتاح، فاستخدمه أو ألغِه قبل الاستبدال. افصل بيانات الاعتماد التجريبية عن المباشرة ولا تعتبر الحصة ضماناً لخدمة الإنتاج.
- تحقق من وجود مفتاح تجريبي نشط في هذا السياق.
- أنشئ مفتاحاً لاختبار الاستدلال وخزّنه منفصلاً.
- راقب حصته وألغِه عند انتهاء الحاجة إليه.
حماية السر
انسخ المفتاح كاملاً فقط عندما تعرضه شاشة الإنشاء أو التدوير. خزّنه في مدير أسرار مشفر، واقصر الوصول على الخدمة التي تستخدمه. لا تضعه في الشيفرة المصدرية أو شيفرة المتصفح أو السجلات أو لقطات الشاشة أو التذاكر أو المحادثات. إذا فاتك العرض لمرة واحدة أو لم تجد القيمة، فدوّر المفتاح؛ إذ لا يستطيع الدعم استرجاع النص الأصلي.
- انقل القيمة الظاهرة مباشرة إلى مخزن محمي.
- اضبط التطبيق المستهلك وفق إعداداته الموثقة.
- دوّر المفتاح فور الاشتباه بتسربه أو فقده.
تدوير المفتاح أو إلغاؤه
يستبدل التدوير بيانات الاعتماد القديمة بمفتاح جديد ويلغي القديم. حدّث التطبيق المستهلك بعد حفظ القيمة الجديدة بأمان، وتحقق من نجاحه قبل إيقاف أي تكامل آخر. الإلغاء يوقف استخدام المفتاح ولا يمكن التراجع عنه. راجع السجلات والأنظمة التي تعتمد عليه أولاً لتجنب انقطاع غير متوقع.
- حدد الخدمات التي تستخدم المفتاح الحالي.
- دوّره ثم خزّن القيمة الجديدة وحدّث المستهلكين.
- تحقق من التشغيل وألغ المفاتيح التي لم تعد مستخدمة.
معالجة رفض الطلبات
قد يفشل الطلب بسبب مفتاح ملغى أو نطاق مفقود أو عنوان IP خارج القائمة أو استخدام سياق خاطئ أو تجاوز الحصة التجريبية. افحص رمز الاستجابة ومرجع الطلب دون نشر السر. تحقق من قيمة الترويسة والسياق والنطاق والحدود، ثم دوّر المفتاح إذا ظهرت القيمة في سجل أو صورة.
- تحقق من حالة المفتاح وسياق الحساب والنطاق المطلوب.
- قارن عنوان المصدر بقائمة IP والحصة المعروضة.
- أرسل للدعم وقت الخطأ ومرجعاً آمناً دون المفتاح.
الأسئلة الشائعة
هل يمكن استعادة مفتاح لم أنسخه؟
لا. دوّره لإنشاء قيمة جديدة.
هل تسمح قائمة IP الفارغة بالاتصال؟
نعم، فهي لا تقيد عنوان المصدر.
هل يمكن للأعضاء إدارة مفاتيح المؤسسة؟
لا. الإدارة للمالك والمسؤول، ويمكن للأعضاء العرض.
هل يصلح المفتاح التجريبي للإنتاج؟
لا. فهو مخصص للاستدلال التجريبي ضمن الحصة المعروضة.
أين أخزن المفتاح؟
في مدير أسرار محمي ومتاح للخدمة المستهلكة فقط.
ماذا أفعل عند الاشتباه بالتسرب؟
ألغِ المفتاح أو دوّره وحدّث التطبيقات المستهلكة.