> ## 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.

# إعداد تكامل

> جهّز بيانات اعتماد المزوّد، واربط نظامًا مدعومًا، وفعّل تدفقات بياناته، وتحقق من نجاح أول مزامنة.

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

## المتطلبات الأساسية

| الدور | المسؤولية |
| - | - |
| [**مالك البرنامج**](/ar/reference/glossary#%D9%85%D8%A7%D9%84%D9%83-%D8%A7%D9%84%D8%A8%D8%B1%D9%86%D8%A7%D9%85%D8%AC) | يحدد المصدر، ويربطه في Living Security، ويفعّل التدفقات، ويتحقق من النتيجة |
| [**مسؤول النظام**](/ar/reference/glossary#%D9%85%D8%B3%D8%A4%D9%88%D9%84-%D8%A7%D9%84%D9%86%D8%B8%D8%A7%D9%85) | ينشئ بيانات الاعتماد والنطاقات في النظام المصدر أو يعتمدها |

يجوز أن يشغل الشخص نفسه هذين الدورين. يجب أن يكون لدى الشخص الذي يدخل بيانات الاعتماد في Living Security دور مسؤول يسمح بإدارة التكاملات؛ لا تدعُ مسؤول النظام المصدر إلى Living Security لمجرد افتراض وجود دور إعداد محدود النطاق.

قبل البدء:

* اختر مؤسسة Living Security والبيئة التي ينتمي إليها الاتصال.
* افتح دليل المزوّد في كتالوج واجمع النطاقات المطلوبة وعناوين URL لإعادة التوجيه ومتطلبات قائمة السماح.
* استخدم عملية مشاركة الأسرار المعتمدة في مؤسستك إذا كان أشخاص مختلفون ينشئون بيانات الاعتماد ويدخلونها.
* لا ترسل كلمات المرور أو أسرار العميل أو المفاتيح الخاصة أو قيم مفاتيح الوصول عبر البريد الإلكتروني أو تذكرة دعم.

## 1. تجهيز بيانات اعتماد المزوّد

افتح **الإعدادات → التكاملات → كتالوج**، وابحث عن المزوّد، واقرأ دليل الإعداد الخاص به قبل إنشاء بيانات الاعتماد.

قد تستخدم مصادقة المزوّد موافقة OAuth أو رمز API أو معرّف عميل وسرًّا أو حساب خدمة أو طريقة أخرى يدعمها المزوّد. أنشئ فقط بيانات الاعتماد والنطاقات المذكورة في دليل ذلك المزوّد.

<Warning>
  لا تنسخ الأذونات من مزوّد مختلف ولا تمنح صلاحيات كتابة واسعة
  «تحسبًا». عادةً ما يؤدي نقص الأذونات إلى ظهور خطأ 401 أو 403 واضح
  يمكن تصحيحه، بينما تؤدي الأذونات المفرطة إلى مخاطر يمكن تجنبها.
</Warning>

## 2. ربط المزوّد

<Steps>
  <Step title="فتح كتالوج">
    انتقل إلى **الإعدادات → التكاملات → كتالوج** وحدد المزوّد.
  </Step>

  <Step title="بدء الاتصال">
    حدد **اتصال**. أكمل تدفق OAuth أو أدخل الحقول المطلوبة في
    مربع حوار الاتصال. يوضح دليل المزوّد مصدر كل قيمة.
  </Step>

  <Step title="إنهاء المصادقة">
    وافق على شاشة موافقة المزوّد عند الاقتضاء. بعد نجاح المصادقة، يفتح Living Security الاتصال الجديد أو يدرجه ضمن **متصل**.
  </Step>
</Steps>

إذا رفض المزوّد المصادقة، فتوقف وصحّح بيانات الاعتماد أو المستأجر أو المنطقة أو عنوان URL لإعادة التوجيه أو أذونات النظام المصدر قبل المتابعة.

## 3. تفعيل تدفقات البيانات

افتح الاتصال ضمن **الإعدادات → التكاملات → متصل**. يكتشف Living Security قوالب المزامنة المتاحة لذلك المزوّد ويعرضها كتدفقات.

1. راجع اسم كل تدفق والغرض منه.
2. فعّل فقط التدفقات التي يحتاجها برنامجك.
3. أبقِ التدفقات غير ذات الصلة متوقفة مؤقتًا.
4. استخدم **مزامنة الآن** عند توفرها لطلب التشغيل الأول.

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

## 4. التحقق من التشغيل الأول

لا تثبت مصادقة الاتصال وحدها أن البيانات تتدفق.

<Steps>
  <Step title="التحقق من سلامة الاتصال">
    تأكد من أن الاتصال سليم ولا يطلب إعادة التفويض.
  </Step>

  <Step title="التحقق من حالة التدفق">
    تأكد من أن التدفق المطلوب مفعّل وليس متوقفًا مؤقتًا.
  </Step>

  <Step title="فحص آخر تشغيل">
    افتح التدفق أو رابط المزامنة الخاص بالاتصال أو **الإعدادات** → **التكاملات** → **المزامنات**. انتظر حتى تظهر نتيجة نهائية ناجحة، وراجع أخطاء المزوّد وأعداد السجلات عند توفرها.
  </Step>

  <Step title="تأكيد البيانات اللاحقة">
    افتح واجهة Living Security ذات الصلة. يجب أن تنتج بيانات الهوية الأشخاص والهويات المتوقعة في القوى العاملة؛ ويجب أن تظهر بيانات مصدر الأمان في الميزة الموثقة لدى ذلك المزوّد.
  </Step>
</Steps>

بالنسبة إلى التهيئة، تكتمل مهمتا **Verify Identity Data Flowing** و**Verify Integration Data Flowing** في خريطة الرحلة (Journey Map) من البيانات المستوردة. لا تستبدل نتائج التحقق هذه باتصال محفوظ.

## صفحة تفاصيل المزامنة

من **الإعدادات** → **التكاملات** → **المزامنات**، افتح أي مزامنة لعرض إعداداتها وسجل تشغيلها في مكان واحد.

تعرض صفحة التفاصيل ما يلي:

| القسم | ما يتضمنه |
| - | - |
| **الرأس** | اسم المزامنة وشارة الحالة ومزوّد التكامل |
| **الإحصاءات** | النموذج وآخر مزامنة وعمليات التشغيل المكتملة وإجمالي السجلات |
| **سجل التشغيل** | عمليات التشغيل الأخيرة مع الحالة والتوقيت وأعداد السجلات |
| **إجراءات** | **تحديث** و**وقفة** / **استئناف** و**مزامنة الآن** |

استخدم **مزامنة الآن** لتشغيل مزامنة فورية عندما تكون المزامنة نشطة. يجب استئناف المزامنات الموقوفة قبل بدء أي عمليات تشغيل مجدولة أو يدوية جديدة.

يمكنك أيضًا فتح مزامنة من صفحة تفاصيل الاتصال الخاصة بها عندما يعرض التكامل تدفقات نشطة.

## عمليات الاتصال

تعرض صفحة تفاصيل الاتصال العمليات التي يدعمها ذلك التكامل:

| العملية | التأثير |
| - | - |
| **مزامنة الآن** | يطلب تشغيلًا فوريًا للتدفق المحدد |
| **إيقاف التدفق** | يوقف عمليات التشغيل الجديدة لذلك التدفق مع الاحتفاظ بالاتصال |
| **إيقاف الاتصال** | يوقف نشاط الاتصال المدعوم دون حذف الإعدادات |
| **استئناف** | يعيد تشغيل تدفق أو اتصال موقوف |
| **إعادة التفويض** | يكرر المصادقة بعد تغيّر بيانات الاعتماد أو الموافقة |
| **إزالة** | يحذف إعدادات الاتصال بعد التأكيد |

إزالة اتصال لا تعني حذف البيانات التي تم استيرادها منه بالفعل. راجع دليل المزوّد أو تواصل مع الدعم إذا كان سلوك الاحتفاظ بالبيانات يؤثر في قرارك.

## مصادر الدفع المخصصة

استخدم **مصدر الدفع المخصص** عندما يرسل نظام ما البيانات إلى Living Security بدلًا من استعلامها عبر موصّل في كتالوج.

1. أنشئ المصدر من أسفل **كتالوج**.
2. افتح صفحة تفاصيله ضمن منطقة الدفع المخصص.
3. حدد تدفق الوجهة.
4. استخدم **رفع CSV** لدفعة يدوية أو **الدفع عبر API** لمرسل آلي.
5. اعرض الملف أو الحمولة مسبقًا وراجع سجل تشغيل المصدر بعد الإرسال.

للاطلاع على العقد الكامل لنقطة النهاية والمصادقة والحمولة وإعادة المحاولة والتحقق، راجع [واجهة API لمصدر الدفع المخصص](/ar/integrations/custom-push-source). لا تستنتج تلك التفاصيل من دليل تكامل Unify أقدم.

تقبل أداة الرفع في تفاصيل المصدر ملف CSV للمصدر بحجم يصل إلى 100 MB. قبل الرفع، تقسمه لوحة التحكم من جهة العميل إلى طلبات لا يزيد كل منها على 10 MB و10,000 صف. وتنفصل أداة الرفع الخاصة بالمصدر هذه عن صفحة **التكاملات → رفع** العامة لقوالب الهوية والنشاط.

## استكشاف الأخطاء وإصلاحها

| العرض | ما يجب التحقق منه |
| - | - |
| `401 Unauthorized` | قيمة بيانات الاعتماد وانتهاء صلاحيتها وإلغاؤها ومستأجر المزوّد وحالة إعادة التفويض |
| `403 Forbidden` | دور المزوّد المطلوب والنطاقات وموافقة المسؤول وسياسة الوصول في النظام المصدر |
| يفشل الاتصال فورًا | عنوان URL لإعادة التوجيه والمنطقة وعنوان URL للمصدر ومتطلبات قائمة السماح للشبكة أو IP |
| الاتصال سليم ولكن لا تحدث عمليات تشغيل | التدفق المطلوب مفعّل ويتيح المزوّد ذلك التدفق |
| يعيد التشغيل الناجح صفر سجلات | يستطيع حساب المصدر رؤية المجموعة المتوقعة وعوامل التصفية لدى المزوّد صحيحة |
| تظهر البيانات تحت الشخص الخطأ | اتساق سمات الهوية والأسماء المستعارة عبر المصادر المتصلة |
| تتوقف البيانات عن التحديث | التدفق أو الاتصال موقوف مؤقتًا، أو انتهت صلاحية بيانات الاعتماد، أو فشل آخر تشغيل |

عند التواصل مع [دعم Living Security](mailto:support@livingsecurity.com)، أرفق المؤسسة والمزوّد واسم الاتصال والتدفق ووقت آخر تشغيل والخطأ الظاهر. لا تُدرج أي أسرار.

## ذو صلة

<CardGroup cols={2}>
  <Card title="نظرة عامة على التكاملات" icon="grid-2" href="/ar/integrations/overview">
    مرجع لـ متصل وكتالوج والمزامنات وإجراءات ورفع.
  </Card>

  <Card title="تعيين البيانات" icon="arrows-left-right" href="/ar/integrations/managing/data-mapping">
    تعرّف على السمات والتعيينات المدعومة عند توفرها.
  </Card>

  <Card title="دورة حياة التكامل" icon="route" href="/ar/integrations/managing/lifecycle">
    أدِر تكاملًا قائمًا، بدءًا من إعادة التفويض وحتى الإزالة.
  </Card>

  <Card title="تهيئة المسؤول" icon="circle-check" href="/ar/getting-started/onboarding">
    أكمل مهام التحقق من بيانات الهوية وبيانات الأمان.
  </Card>
</CardGroup>


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