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

# إعداد تكامل Adaptive Security

> اربط Adaptive Security بـ Living Security Platform لاستيراد نتائج محاكاة التصيد الاحتيالي عبر البريد الإلكتروني (phishing) والرسائل النصية (smishing) والاتصالات الصوتية (vishing)، إضافة إلى نتائج التدريب على الوعي الأمني لدى القوى العاملة لديكم.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>موارد ذات صلة</h2>
    <ul>
      <li>
        <a href="/ar/signals/data-sources">تعرّف على كيفية تحويل بيانات التكاملات إلى إشارات إدارة المخاطر البشرية</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">استكشف تكاملات Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">افتح Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">اطلب عرضًا توضيحيًا من Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="أدخل بيانات الاعتماد في Living Security Platform">
    <p>
      يُنفَّذ هذا الإجراء من قِبل من يملك صلاحية الوصول إلى Living Security، وهو مالك البرنامج، أو مسؤول النظام
      إذا تمت دعوته (الإعداد المفوَّض).
    </p>
    <ol>
      <li>
        انتقل إلى <strong>الإعدادات ← التكاملات ← كتالوج</strong>، وحدد موضع بطاقة{' '}
        <strong>{tile}</strong>، ثم انقر فوق <strong>اتصال</strong>.
      </li>
      <li>
        املأ الحقول أدناه، ثم انقر فوق <strong>اتصال</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>هذا الدليل موجّه إلى مسؤول {system} لديكم.</strong> يتناول الدليل إنشاء بيانات اعتماد API
      داخل {system}، وهو ما يتطلب صلاحيات المسؤول في {system} وليس في
      Living Security Platform.
    </p>
    <p>
      إذا كنتم <strong>مالك البرنامج</strong> في Living Security ولا تتولّون إدارة {system}،
      فأرسلوا هذه الصفحة إلى المسؤول عنه. يُكمل المسؤول الجزء A ثم يسلّمكم بيانات الاعتماد
      (أو يُدخلها مباشرةً إذا دعوتموه إلى المنصة).
      {recommendDelegated && <>
          {' '}وبما أن عملية الإعداد تنتج مادة مفاتيح حساسة، فإننا نوصي باعتماد مسار{' '}
          <strong>الإعداد المفوَّض</strong> حتى لا يُرسَل السر إليكم مطلقًا.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Adaptive Security" />

## ما الذي يقدمه هذا التكامل

يمكن أن تقدّم Adaptive Security بيانات عن القوى العاملة والتدريب ونتائج المحاكاة متعددة القنوات. وتشمل الأمثلة التي جرت مراجعتها ما يلي:

* `phishing.simulation.clicked` — نقر على رسالة بريد إلكتروني محاكاة دون الإبلاغ عنها
* `phishing.simulation.credential.submitted` — أدخل بيانات اعتماد في صفحة تسجيل دخول محاكاة
* `phishing.simulation.attachment.opened` — فتح مرفقًا في رسالة بريد إلكتروني محاكاة
* `phishing.simulation.reported` — أبلغ عن رسالة بريد إلكتروني محاكاة
* `smishing.simulation.replied` — ردّ على رسالة نصية محاكاة
* `vishing.simulation.succeeded` — استجاب لمتصل صوتي محاكى
* `training.assigned` — تم تعيين تدريب أمني له
* `training.completed` — أنهى التدريب الأمني
* `training.past.due` — فاته الموعد النهائي للتدريب

تبيّن هذه الأمثلة أنواع النشاط الموحَّد التي يمكن لـ Living Security استخدامها. راجع
[كيف تتحول بيانات التكامل إلى إشارات](/ar/signals/data-sources).

<Note>
  **تجري Adaptive عمليات المحاكاة عبر ثلاث قنوات، وتقوم Living Security بتسجيل نتيجة كل قناة على حدة.**
  تُسجَّل نتائج البريد الإلكتروني بوصفها phishing، ونتائج الرسائل النصية بوصفها smishing، ونتائج المكالمات
  الصوتية بوصفها vishing. فالشخص الذي ينقر على رسالة بريد إلكتروني محاكاة والشخص الذي يردّ على
  رسالة نصية محاكاة لا يُقاس سلوكهما على أنه سلوك واحد، لأن الحكم الذي اتخذه كل منهما
  مختلف.
</Note>

## ما الذي تحتاجه Living Security

| بيانات الاعتماد | الوصف |
| - | - |
| **رمز API** | رمز API خاص بـ Adaptive Security. ترسله Living Security بوصفه رمز حامل (bearer token) مع كل طلب. |

**الدور المطلوب:** مسؤول في حساب Adaptive Security لديكم لديه إمكانية الوصول إلى
**Settings → API**. تتحكم Adaptive في الوصول إلى API عبر أذونات قائمة على الأدوار، لذا
يجب أن ينتمي الرمز إلى دور يمكنه قراءة المستخدمين وبيانات التصيد الاحتيالي والتدريب.

**الوصول:** للقراءة فقط. تقرأ Living Security من Adaptive Security فقط، ولا
تنشئ أو تغيّر أو تحذف أي شيء في حسابكم.

### ما الذي تسترجعه Living Security

| البيانات | التفاصيل |
| - | - |
| **الأشخاص** | دليل مستخدمي Adaptive لديكم: الاسم، والبريد الإلكتروني، والقسم، والمسمى الوظيفي، واسم المدير وبريده الإلكتروني، والموقع، والشعبة، وحالة التوظيف وتاريخ المباشرة. |
| **محاكاة البريد الإلكتروني** | لكل شخص ولكل محاكاة: وقت تسليم الرسالة، أو فتحها، أو النقر عليها، أو الرد عليها، أو فتح مرفقها، أو مسح رمز QR الخاص بها، أو إدخال بيانات اعتماد، أو الإبلاغ عنها. |
| **محاكاة الرسائل النصية** | لكل شخص ولكل محاكاة: التسليم، أو الفتح، أو النقر، أو الرد، أو إدخال بيانات اعتماد، أو الإبلاغ. |
| **محاكاة المكالمات الصوتية** | لكل شخص ولكل محاكاة: الطُعم الذي تم تسليمه، والرقم الذي جرى الاتصال به، وما إذا استجاب الشخص للمتصل، وما إذا أبلغ عن المكالمة. |
| **التدريب** | لكل شخص ولكل حملة: وقت التسجيل، وتاريخ الاستحقاق، ووقت البدء، ووقت الإكمال، وما إذا أقرّ بسياسة الحملة. |

<Note>
  **لا يتم تخزين أرقام الهواتف.** تُرجع Adaptive أرقام المكتب والهاتف المحمول ضمن سجل المستخدم. تتجاهل
  Living Security كلا الرقمين قبل تخزين أي بيانات، لأنه لا توجد أي ميزة في Living Security
  تستخدمهما.
</Note>

<Note>
  **يُسجَّل تقييم المخاطر الخاص بـ Adaptive لكنه لا يُستخدم في الاحتساب أبدًا.** تحتسب Adaptive
  `current_risk_score` لكل شخص. تحتفظ به Living Security لتتمكنوا من مقارنة النظامين
  جنبًا إلى جنب، إلا أن مؤشر المخاطر البشرية يُحتسب دائمًا استنادًا إلى السلوك
  المرصود باستخدام النموذج المنشور الخاص بـ Living Security — وليس استنادًا إلى الدرجة المركّبة
  لأي مزوّد آخر.
</Note>

### المتطلبات المسبقة

* حساب Adaptive Security مع تمكين API.
* صلاحية المسؤول على [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* عناوين بريد إلكتروني للمستخدمين في Adaptive تطابق العناوين التي تستخدمها أنظمتكم
  المتصلة الأخرى. فالبريد الإلكتروني هو ما تعتمد عليه Living Security لمطابقة مستخدم Adaptive بشخص.

***

## الجزء A — في Adaptive Security

*يُكمل مسؤول Adaptive Security لديكم هذه الخطوات.*

<Steps>
  <Step title="افتح إعدادات API">
    1. سجّل الدخول إلى [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) بصفتك مسؤولًا.
    2. انتقل إلى **Settings → API**.
  </Step>

  <Step title="أنشئ رمز API">
    1. أنشئ رمز API جديدًا.
    2. أعطه اسمًا تتعرف عليه لاحقًا — على سبيل المثال `Living Security`.
    3. تأكد من أن دور الرمز يمكنه قراءة المستخدمين وحملات التصيد الاحتيالي وحملات التدريب.
    4. انسخ الرمز.

    <Warning>
      انسخ الرمز قبل مغادرة الصفحة. إذا كان حساب Adaptive لديكم يحدد تاريخ انتهاء صلاحية
      للرمز، فدوّن هذا التاريخ — إذ لا تستطيع Living Security استرجاع البيانات بعد انتهاء الصلاحية، ويجب
      تحديث الاتصال برمز جديد.
    </Warning>
  </Step>
</Steps>

***

## الجزء B — في Living Security Platform

*يُكمل مالك البرنامج هذه الخطوة، أو مسؤول النظام في حال استخدام الإعداد المفوَّض.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | الحقل | القيمة |
    | - | - |
    | **رمز API** | الرمز الذي أنشأتموه في الجزء A |
  </ConnectInPlatform>
</Steps>

لقد أصبحتم الآن متصلين بـ Adaptive Security.

***

## وتيرة استرجاع البيانات

| البيانات | الجدول الزمني |
| - | - |
| الأشخاص | كل 6 ساعات |
| نتائج المحاكاة (البريد الإلكتروني، والرسائل النصية، والمكالمات الصوتية) | كل 6 ساعات |
| نتائج التدريب | كل 6 ساعات |

لا توفر واجهة API الخاصة بالتقارير في Adaptive عامل تصفية من نوع "ما الذي تغيّر منذ"، لذا تقرأ Living Security
كل حملة محاكاة وتدريب ما دامت ما تزال تنتج نتائج، وتتوقف عن قراءتها بعد مرور أسبوعين على إغلاقها.
وبذلك تبقى النقرات المتأخرة والإبلاغات المتأخرة مرصودة،
ولا تُعاد قراءة الحملات المنتهية إلى ما لا نهاية.

<Note>
  قد يستغرق الاتصال الأول بحساب Adaptive كبير عدة عمليات تشغيل مجدولة لإكمال قراءة
  كل شيء. تقرأ كل عملية تشغيل أكبر قدر ممكن، وتتابع العملية التالية من حيث توقفت
  السابقة، لذا تتزايد الأعداد على مدى اليوم الأول أو الثاني بدلًا من ظهورها دفعة واحدة.
</Note>

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    رمز API غير صحيح، أو منتهي الصلاحية، أو تم إلغاؤه. تُرجع Adaptive نص استجابة فارغًا
    عند حدوث هذا الخطأ، لذا لا توجد تفاصيل إضافية يمكن الاطلاع عليها. أنشئ رمزًا جديدًا في
    **Settings → API** ثم أعد الاتصال باستخدامه. ويؤدي نسخ الرمز جزئيًا إلى الخطأ
    نفسه، وهو السبب الأكثر شيوعًا.
  </Accordion>

  <Accordion title="403 Forbidden">
    تمت مصادقة الرمز، لكن دوره لا يستطيع قراءة البيانات المطلوبة. لن تفيد إعادة لصق
    الرمز نفسه. في Adaptive، تأكد من أن دور الرمز لديه صلاحية قراءة المستخدمين
    وبيانات التصيد الاحتيالي والتدريب، أو أصدر رمزًا من دور يملك هذه الصلاحية.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    فرضت Adaptive حدًّا لمعدل الطلبات على الاتصال. توقف Living Security عملية التشغيل تلك وتستأنف من
    المكان نفسه في عملية التشغيل المجدولة التالية، لذا لا تُفقد أي بيانات — إذ يستغرق تزايد الأعداد
    وقتًا أطول فقط. إذا استمر ذلك لعدة أيام، فتواصل مع دعم Adaptive Security للاستفسار عن
    حد المعدل المطبّق على حسابكم.
  </Accordion>

  <Accordion title="يظهر الأشخاص، ولكن لا تظهر نتائج المحاكاة">
    تحقق من أن الحملات التي تتوقعونها قد نُفّذت فعلًا. لا تُبلغ Adaptive عن التسجيلات إلا
    للمحاكاة التي أُرسلت، لذا فإن الحملة التي ما تزال في حالة **مسودة** أو **مجدولة**
    لا تقدّم أي بيانات إلى أن يتم إرسالها. لا تقرأ Living Security هذه الحملات عمدًا،
    كي تخصص حصة طلباتها للحملات التي لها نتائج فعلية.
  </Accordion>

  <Accordion title="محاكاة المكالمات الصوتية أو الرسائل النصية مفقودة">
    تحدد Living Security قناة كل نتيجة من السيناريو المرتبط بها. إذا حُذف سيناريو
    في Adaptive بعد تشغيل المحاكاة الخاصة به، تُسجَّل نتائجه ضمن قناة البريد الإلكتروني،
    لأنه لم يعد بالإمكان قراءة القناة. ويساعد الإبقاء على السيناريوهات المتقاعدة في Adaptive
    بدلًا من حذفها على تجنب ذلك.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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