إنشاء مفاتيح API وتدويرها وإلغاؤها
استخدم مفتاحاً مسمى واحداً لكل تكامل وبيئة. تظهر بيانات الاعتماد الكاملة مرة واحدة، ثم يعرض وقار بيانات تعريف ودورة حياة آمنة فقط.
إنشاء مفتاح
Section titled “إنشاء مفتاح”- بصفتك مشرف المدرسة، افتح الإعدادات.
- ابحث عن إدارة مفاتيح API وتحقق من إتاحة API.
- افتح توثيق API المعروض واتفق مع مطوّر التكامل على أقل النطاقات.
- أدخل اسماً يحدد النظام والبيئة والمالك.
- اضبط تاريخ انتهاء عندما تسمح دورة حياة التكامل.
- حدد النطاقات المطلوبة فقط.
- اختر إنشاء مفتاح API.
- انسخ بيانات الاعتماد المعروضة فوراً إلى مدير الأسرار المعتمد.
- أغلق العرض وتحقق من اسم المفتاح ومعرّفه الآمن ونطاقاته ووقت إنشائه وانتهائه وحالة آخر استخدام في القائمة.
لا تظهر بيانات الاعتماد الكاملة بعد تحديث الصفحة. إذا فقدتها فأنشئ بديلاً؛ فلا يمكن استعادتها.
لا يجوز أن يظهر النطاق نفسه أكثر من مرة في الطلب. تُرفض القيم المكررة، بما فيها نسخة مكررة باختلاف حالة الأحرف، قبل إنشاء المفتاح أو حدث التدقيق أو بيانات الاعتماد. كما تعيد ضوابط المفاتيح ترتيبها في العرض الضيق وعند تكبير المتصفح، وتلتف القيمة التي تظهر مرة واحدة داخل صندوقها المحمي بدلاً من توسيع الصفحة.
تسليم بيانات الاعتماد بأمان
Section titled “تسليم بيانات الاعتماد بأمان”- يفضل إدخالها مباشرة في مدير أسرار التكامل.
- لا ترسلها في محادثة أو بريد أو تذكرة أو مستودع أو صورة أو صفحة دليل.
- لا تمنح مفتاح إنتاج لشيفرة متصفح أو جهاز مطوّر.
- سجل المالك البشري والخدمة المقصودة منفصلين عن السر.
التدوير بلا توقف
Section titled “التدوير بلا توقف”- أنشئ بديلاً بالنطاقات الحالية المطلوبة.
- ثبته في التكامل من دون إزالة المفتاح القديم.
- نفّذ طلباً مصادقاً صغيراً وتحقق من المدرسة المتوقعة.
- راقب بيانات آخر استخدام للمفتاح الجديد.
- ألغِ المفتاح القديم.
- تحقق من استمرار التكامل بالبديل.
النطاقات والانتهاء غير قابلين للتعديل. والتدوير هو أيضاً طريقة إضافة نطاق صدر حديثاً؛ فلا تحصل عليه المفاتيح الموجودة تلقائياً.
إلغاء مفتاح
Section titled “إلغاء مفتاح”اختر إلغاء للمفتاح الدقيق وتحقق من معرّفه الآمن ثم من وسمه ملغى. يسري الإلغاء فوراً ولا يمكن التراجع عنه. أنشئ بديلاً إذا لزم الوصول مجدداً. وإذا أعاد المتصفح إرسال طلب الإلغاء نفسه، يعامله وقار كإعادة آمنة: يبقى المفتاح ملغى ولا يُنشأ حدث تدقيق انتقالي مكرر. ويعرض مرجع المفتاح غير الصالح أو غير المتاح صفحة «غير موجود» المترجمة من دون تغيير مفتاح تابع لمدرسة أخرى.
عند رفض الطلبات
Section titled “عند رفض الطلبات”افحص الانتهاء والإلغاء والنطاق المطلوب وأهلية المدرسة والتعليق والحصة والإطلاق وأي قيد شبكة مصدر مُعدّ. وإذا كان قيد CIDR نشطاً فنسق قبل تغيير مخرج شبكة التكامل.
راجع المصادقة والنطاقات و الأخطاء والحصص.