المصادقة وإدارة مفاتيح API

قبل البدء

استخدم صلاحية إدارة التكاملات واختر النشاط والتكامل الصحيحين. توفر المنصة طرق المصادقة ونطاقات المفاتيح حسب النوع. تفويض المزوّد ومفاتيح التكامل وأسرار HMAC وجلسة لوحة التحكم بيانات مختلفة.

إنشاء مفتاح محدد النطاق

1. افتح التكاملات واختر التكامل ثم مفاتيح API.
2. أنشئ مفتاحاً باسم واضح والنطاقات اللازمة وفترة الانتهاء المتاحة.
3. انسخ المفتاح كاملاً عند عرضه؛ تعرض القائمة المعتادة البادئة والبيانات الوصفية لا السر الكامل.
4. خزّنه في مخزن أسرار الخادم لا في أداة عامة أو كود متصفح أو صور أو ملف معرفة.
5. اختبر العملية المقصودة وفق عقد مصادقة التكامل.

التجديد والإلغاء

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

HMAC وOAuth

لا تستخدم HMAC دون عقد خادم مؤكد للترويسات والبايتات والخوارزمية والوقت ومنع الإعادة. لا تثبت الواجهة هذه القواعد ولا يخمّن الدليل وصفة توقيع. استخدم مسار ربط القناة أو التقويم لـOAuth بدلاً من لصق رمز المزوّد في حقل مفتاح API.

معالجة الأخطاء

راجع اقتران النشاط والتكامل والحالة والانتهاء والنطاقات ونص الخطأ. لا ترسل المفتاح الكامل للدعم. راجع مرجع المطوّر لحدود العمليات المفحوصة وعقود API الخارجية.