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

# إعداد التكامل مع NINJIO

> اربط NINJIO بـ Living Security Platform لاستيراد نتائج التدريب على الوعي الأمني ونتائج محاكاة التصيد الاحتيالي للقوى العاملة لديك.

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="NINJIO" />

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

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

* `training.assigned` — لديه تدريب أمني مُسند
* `training.completed` — يُكمل التدريب الأمني
* `training.passed` — يجتاز تقييمات التدريب الأمني
* `phishing.simulation.clicked` — نقر على محاكاة دون الإبلاغ عنها
* `phishing.simulation.reported` — يبلّغ عن محاكاة التصيد الاحتيالي

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

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

| بيانات الاعتماد | الوصف |
| - | - |
| **مفتاح API** | مفتاح API من NINJIO يتمتع بصلاحية القراءة على نقاط الوصول الخاصة بالموظفين والتدريب والتصيد الاحتيالي. ترسله Living Security مع كل طلب. |

**النطاقات:** تحدد NINJIO نطاقات كل مفتاح API لكل *نقطة وصول*، مع أذونات منفصلة للقراءة والكتابة. تحتاج Living Security إلى صلاحية **القراءة** على ثلاث نقاط: الموظفين والتدريب والتصيد الاحتيالي. صلاحية الكتابة غير مطلوبة ويجب عدم منحها.

**الدور المطلوب:** **مسؤول** في حساب NINJIO الخاص بك. لا يمكن إلا للمسؤولين الوصول إلى منطقة التكامل التي يتم فيها إنشاء المفاتيح.

<Warning>
  **تعرض NINJIO المفتاح الجديد مرة واحدة فقط، لحظة إنشائه.** انسخه مباشرة إلى Living Security Platform، أو إلى خزنة كلمات مرور، قبل أن تنتقل إلى صفحة أخرى. لا يمكن استرداد مفتاح لم تنسخه — بل عليك إنشاء مفتاح بديل.
</Warning>

### ما تسترده Living Security

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

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

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

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

***

## الجزء أ — في NINJIO

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

<Steps>
  <Step title="افتح منطقة التكامل">
    1. سجّل الدخول إلى [admin.goninjio.com](https://admin.goninjio.com/) بصفتك مسؤولاً.
    2. حدد **Integration** في أعلى يمين الشاشة.
  </Step>

  <Step title="أنشئ مفتاح API">
    1. حدد **New API Key**.
    2. أعطِ المفتاح اسماً يسهل عليك تمييزه لاحقاً — على سبيل المثال `Living Security`.
    3. امنح صلاحية **القراءة** على نقاط الوصول **employee** و**training** و**phishing**.
    4. اترك صلاحية الكتابة غير محددة. تقرأ Living Security من NINJIO فقط.
    5. حدد **Generate Key**.

    <Warning>
      انسخ المفتاح الآن. تعرضه NINJIO مرة واحدة ولا يمكنها عرضه مرة أخرى.
    </Warning>
  </Step>
</Steps>

***

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

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

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

أصبحت الآن متصلاً بـ NINJIO.

***

## وتيرة استرداد البيانات

| البيانات | الجدول الزمني |
| - | - |
| المتعلمون | يومياً |
| نتائج التدريب | كل 6 ساعات |
| نتائج التصيد الاحتيالي | كل 6 ساعات |

عند الاتصال لأول مرة، تسترد Living Security عمليات إكمال التدريب خلال الأشهر الـ 12 الماضية، ثم تواصل التحديث تدريجياً. تُقرأ عمليات محاكاة التصيد الاحتيالي مرة واحدة لكل منها، ثم يُعاد فحصها لمدة أسبوعين بعد انتهائها، بحيث تُسجَّل النقرات والتقارير المتأخرة.

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    مفتاح API غير صحيح أو غير مكتمل. السبب الأكثر شيوعاً هو نسخ المفتاح جزئياً — تعرضه NINJIO مرة واحدة، لذا يسهل حدوث لصق مبتور ويستحيل اكتشافه لاحقاً. أنشئ مفتاحاً جديداً في NINJIO وأعد الاتصال باستخدامه.
  </Accordion>

  <Accordion title="403 Forbidden">
    هذه **ليست** مشكلة في بيانات الاعتماد. تمت مصادقة المفتاح، لكن إحدى نقاط الوصول التي يحتاج إليها لم تُمنح صلاحية القراءة.

    لن تفيد إعادة لصق المفتاح نفسه. في NINJIO، أنشئ مفتاحاً بصلاحية **القراءة** على نقاط الوصول الثلاث جميعها — employee وtraining وphishing — ثم أعد الاتصال باستخدامه.
  </Accordion>

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

    إذا كانت الحملات نشطة، فتأكد من أن المتعلمين فيها لديهم عناوين بريد إلكتروني في سجلاتهم في NINJIO. لا يمكن مطابقة متعلم ليس لديه عنوان بريد إلكتروني مع شخص، ويتم تخطيه.
  </Accordion>

  <Accordion title="يظهر التدريب كمُسند ولكن غير مكتمل">
    هذا هو العرض المتوقع للتدريب الذي لم يُنهِه المتعلم. تسجّل Living Security الإسناد عند بدء محاكاة NINJIO، وتسجّل الإكمال بشكل منفصل عندما تبلّغ NINJIO عن تاريخ إكمال.
  </Accordion>

  <Accordion title="بعض المتعلمين مفقودون">
    تطابق Living Security متعلم NINJIO مع شخص عن طريق **عنوان البريد الإلكتروني**. لن تتم مطابقة متعلم يختلف بريده الإلكتروني في NINJIO عن العنوان المسجل في دليلك — مثل عنوان شخصي أو نطاق قديم أو خطأ إملائي.

    صحّح العنوان في NINJIO وستتم المطابقة عند عملية الاسترداد المجدولة التالية.
  </Accordion>

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

<PublicIntegrationNextSteps />


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