Skip to main content
لا تحتاج إلى OAuth لاستخدام واجهة Public API. لإنشاء تكامل خاص يعمل من جهة الخادم، ابدأ بمفتاح API محدد النطاق واتبع دليل البدء السريع. اختر بيانات اعتماد عميل OAuth عندما تتطلب سياسة الأمان لديك رموز وصول قصيرة العمر أو عندما تدعم منصة التكامل لديك هذا التدفق بالفعل. يستخدم الخياران حساب خدمة. حساب الخدمة هو هوية التكامل، وليس طريقة مصادقة ثالثة.

​
كيف تترابط العناصر

أنشئ حساب خدمة واحدًا لكل تكامل. اختر مفتاح API أو عميل OAuth لهذا الحساب؛ فلا تحتاج إلى الطريقتين معًا في كل طلب API. لا يمكن لأي من بيانات الاعتماد تجاوز الأذونات الحالية للحساب. يستخدم دليل البدء السريع مصادقة Basic. كما يُدعم ترويسة Bearer لمفاتيح API؛ ولا يعني استخدام هذه الترويسة أنك بحاجة إلى عميل OAuth.

​
اختر مفتاح API لتكامل بسيط

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

​
اختر OAuth لرموز وصول قصيرة العمر

استخدم بيانات اعتماد عميل OAuth لخدمة خلفية سرّية عندما تتطلب مؤسستك رموز وصول تنتهي صلاحيتها أو عندما تتوقع أداة التكامل منح client_credentials.
  1. أنشئ عميل OAuth محدد النطاق لحساب الخدمة.
  2. صادق العميل لدى نقطة نهاية الرموز الإقليمية الخاصة بك باستخدام طريقة مصادقة العميل المقدمة أثناء الإعداد.
  3. أرسل رمز الوصول الناتج مع طلبات API الخاصة بك. احصل على رمز جديد قبل انتهاء صلاحية الرمز الحالي.
يضيف OAuth إلى تكاملك الحصول على الرموز ومعالجة انتهاء صلاحيتها. ولا يزال سر العميل بحاجة إلى تخزين آمن وتدوير؛ فالرموز قصيرة العمر لا تلغي هذه المسؤولية. لا تستخدم بيانات اعتماد العميل رموز تحديث: صادق العميل مرة أخرى للحصول على رمز وصول جديد. يجب تمكين وصول OAuth لمؤسستك. إذا لم يكن ممكّنًا، فاستخدم مفتاح API أو تواصل مع دعم Living Security بشأن متطلباتك. راجع بيانات اعتماد عميل OAuth للاطلاع على إنشاء العميل، والأسرار التي تُعرض لمرة واحدة، والإلغاء، والاسترداد.

​
أبقِ بيانات الاعتماد على الواجهة الخلفية

تنتمي مفاتيح API لحسابات الخدمة وأسرار عملاء OAuth إلى تخزين الأسرار من جهة الخادم. لا تضعها في شيفرة المتصفح أو تطبيقات الجوال أو نظام التحكم في المصدر أو السجلات. تعمل بيانات اعتماد حساب الخدمة بصفتها حِمل العمل نفسه؛ فهي لا تسجّل دخول شخص ولا توفر تدفق موافقة للعملاء. استخدم مضيف API الإقليمي الخاص بمؤسستك مع أي من الطريقتين. لا يؤدي تغيير طرق المصادقة إلى تغيير عنوان URL للمورد أو إصدار API أو الأذونات التي تتطلبها العملية.