يجب تفعيل الوصول عبر OAuth لمؤسستك. يوفر الإعداد الخاص بك
نقطة نهاية الرمز الإقليمية والجهة المصدِرة والجمهور المستهدف
وطريقة مصادقة العميل. إذا كنت بحاجة إلى هذه الإعدادات أو لا يمكنك الوصول إلى إدارة العملاء،
فاتصل بدعم
Living Security.
قبل البدء
- أنشئ حساب خدمة بالأذونات التي يحتاج إليها التكامل فقط.
- استخدم بيانات اعتماد إدارية مع
service_account:manageوكل إذن تريد منحه للعميل الجديد. يجب أن يملك الحساب المستهدف هذه الأذونات أيضًا. لا يمكن للعميل توسيع صلاحيات أي من الحسابين. - اختر المنطقة الخاصة بالمؤسسة. يجب استخدام بيانات اعتماد API ورموز الوصول عبر OAuth على مضيف API الإقليمي المطابق.
- احتفظ بسر العميل والرموز في مخزن الأسرار على جانب الخادم لديك. لا تضعها أبدًا في شيفرة المتصفح أو تطبيقات الجوال أو التحكم في المصدر أو سجلات الطلبات.
إنشاء عميل
يتطلبPOST /v1/oauth_clients service_account_id، وقائمة غير فارغة من
scopes الصريحة، وIdempotency-Key. لا تُقبل الأحرف البديلة. يدعم العميل
ما يصل إلى 100 نطاق، بطول إجمالي لا يزيد على 4,096 حرفًا. يمكن أن يكون لكل حساب
خدمة 20 عميلًا على الأكثر أو عمليات إنشاء/تنظيف غير محسومة. يؤدي
الإبطال إلى رفض الوصول إلى API فورًا. ويستمر احتساب العميل أو عملية إنشاء غير مؤكدة لدى
المزوّد ضمن الحد إلى أن يتم تأكيد التنظيف عن بُعد.
ويمكن تحرير موضع الحجز المهجور أو عملية إنشاء ثبت فشلها قبل بدء عمل المزوّد
بأمان. يظل مفتاح إعادة المحاولة الخاص بها مرتبطًا بالمحاولة الأصلية؛
لذا استرجع إيصالها قبل أن تقرر إنشاء بديل.
اختر مفتاح إعادة محاولة واحدًا لمحاولة الإنشاء هذه واحفظه قبل إرسال
الطلب. استخدم من 1 إلى 255 حرف ASCII مرئيًا، بدون مسافات. أعد استخدامه مع
الحساب والنطاقات والجهة الإدارية والمنطقة وإصدار API نفسها بعد فقدان
الاستجابة. لا يؤدي تدوير بيانات الاعتماد الإدارية ضمن حساب الخدمة نفسه
إلى إنشاء هوية إعادة محاولة جديدة.
ثبّت حزمة requests الخاصة بـ Python. حمّل قيم البيئة التالية عبر
إدارة الأسرار والتكوين المعتادة لديك:
Python
201 وتحتوي على مورد oauth_client
مع id وservice_account_id وclient_id وscopes وstatus وcreated_at و
client_secret. تُوسَم الاستجابات بـ Cache-Control: no-store.
idيحدد مورد المنصة. احفظه للاسترجاع والإبطال.client_idيحدد العميل أثناء تبادل الرموز. وليس معرّف مورد المنصة. ويمكن أن يكونnullأثناء انتظار الإنشاء.client_secretيُعاد فقط للطلب الذي يُكمل الإنشاء. كل طلب إنشاء مكرر يعيدnull، بما في ذلك إعادة المحاولة بعد فقدان استجابة النجاح. ولا يعيد الاسترجاع أي سر.
الاسترداد بعد فقدان الاستجابة أو انقطاعها
كرر طلب الإنشاء نفسه باستخدام مفتاح إعادة المحاولة المحفوظ لاسترجاع إيصال المورد. يعكس الإيصال الحالة الراهنة، لذا يبقى العميل المُبطَل مُبطَلًا. لا تستخدم هذه العملية عقد إعادة تشغيل الاستجابة المخزنة مؤقتًا العام لمدة 24 ساعة ولا تعيد ترويسةIdempotent-Replayed.
راجع الأخطاء لمعرفة معرّفات الطلبات وتفاصيل الاسترداد.
لا ترسل أبدًا سر العميل أو رمز الوصول مع طلب دعم.
الفحص والإبطال
استخدم بيانات الاعتماد الإدارية لديك وid الخاص بمورد المنصة:
يحظر الإبطال طلبات API اللاحقة الخاصة بالعميل، بما في ذلك الطلبات التي تستخدم
رموزًا صادرة مسبقًا. ولا يلغي العمل الذي قبله API بالفعل.
قد يكتمل تنظيف بيانات الاعتماد عن بُعد لاحقًا. تكرار الإبطال آمن
ولا يتطلب مفتاح إعادة محاولة. واصل استخدام بيانات الاعتماد الإدارية إذا كان العميل
الذي يجري إبطاله هو نفسه مستدعي API.

