> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# المصادقة

> اختر مفتاح API أو بيانات اعتماد عميل OAuth لتكاملك، وتعرّف على كيفية استخدام كل منهما لحساب خدمة.

**لا تحتاج إلى OAuth لاستخدام واجهة Public API.** لإنشاء تكامل خاص يعمل من جهة الخادم، ابدأ بمفتاح API محدد النطاق واتبع
[دليل البدء السريع](/ar/developers/v1/quickstart). اختر بيانات اعتماد عميل OAuth عندما
تتطلب سياسة الأمان لديك رموز وصول قصيرة العمر أو عندما تدعم منصة التكامل لديك هذا التدفق بالفعل.

يستخدم الخياران حساب خدمة. حساب الخدمة هو هوية التكامل، وليس طريقة مصادقة ثالثة.

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

| العنصر | الغرض | ما يرسله تكاملك |
| - | - | - |
| **حساب الخدمة** | يحدد اسم حِمل العمل ويحدد الحد الأقصى لأذوناته. | يحدد معرّفه الحساب؛ ولا يُستخدم لمصادقة الطلب. |
| **مفتاح API** | يصادق مباشرة بصفته حساب الخدمة هذا، مع مجموعة أذونات محددة وتاريخ انتهاء صلاحية. | السر الخاص بالمفتاح باستخدام مصادقة HTTP Basic أو `Authorization: Bearer <api_key_secret>`. |
| **عميل OAuth** | يصادق لدى خدمة الرموز للحصول على رموز وصول محددة النطاق لحساب الخدمة هذا. | رمز وصول باستخدام `Authorization: Bearer <access_token>`. |

أنشئ [حساب خدمة](/ar/developers/developer-hub/service-accounts) واحدًا لكل
تكامل. اختر مفتاح API أو عميل OAuth لهذا الحساب؛ فلا
تحتاج إلى الطريقتين معًا في كل طلب API. لا يمكن لأي من بيانات الاعتماد تجاوز
الأذونات الحالية للحساب.

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

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

استخدم مفتاح API للمهام المجدولة الخاصة بك، أو نصوص إعداد التقارير، أو مسارات البيانات،
أو خدمات الواجهة الخلفية الأخرى عندما يلبي سر مخزّن في مدير الأسرار لديك
متطلباتك الأمنية.

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

لا يحتاج التكامل القائم على مفتاح API إلى عميل OAuth. ابدأ بـ
[دليل البدء السريع](/ar/developers/v1/quickstart)، ثم راجع
[مفاتيح API](/ar/developers/developer-hub/api-keys) للاطلاع على الإنشاء والتدوير.

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

استخدم بيانات اعتماد عميل OAuth لخدمة خلفية سرّية عندما
تتطلب مؤسستك رموز وصول تنتهي صلاحيتها أو عندما تتوقع أداة التكامل
منح `client_credentials`.

1. أنشئ عميل OAuth محدد النطاق لحساب الخدمة.
2. صادق العميل لدى نقطة نهاية الرموز الإقليمية الخاصة بك باستخدام طريقة
   مصادقة العميل المقدمة أثناء الإعداد.
3. أرسل رمز الوصول الناتج مع طلبات API الخاصة بك. احصل على رمز جديد
   قبل انتهاء صلاحية الرمز الحالي.

يضيف OAuth إلى تكاملك الحصول على الرموز ومعالجة انتهاء صلاحيتها. ولا يزال سر العميل
بحاجة إلى تخزين آمن وتدوير؛ فالرموز قصيرة العمر
لا تلغي هذه المسؤولية. لا تستخدم بيانات اعتماد العميل رموز تحديث:
صادق العميل مرة أخرى للحصول على رمز وصول جديد.

يجب تمكين وصول OAuth لمؤسستك. إذا لم يكن ممكّنًا،
فاستخدم مفتاح API أو تواصل مع دعم Living Security بشأن متطلباتك.
راجع [بيانات اعتماد عميل OAuth](/ar/developers/v1/oauth) للاطلاع على إنشاء العميل،
والأسرار التي تُعرض لمرة واحدة، والإلغاء، والاسترداد.

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

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

استخدم [مضيف API الإقليمي](/ar/developers/v1/regions) الخاص بمؤسستك مع
أي من الطريقتين. لا يؤدي تغيير طرق المصادقة إلى تغيير عنوان URL للمورد أو إصدار API أو الأذونات التي تتطلبها العملية.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.