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

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

> اربط KnowBe4 بمنصة 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 EgressIpSafelist = ({system}) => <Note>
    <strong>أضف عناوين IP الأربعة جميعها الخاصة بالمزامنة الصادرة من Living Security</strong> إلى قائمة السماح في{' '}
    {system}. أدخل كل عنوان كمضيف واحد مع <code>/32</code> إذا كان {system} يتوقع صيغة CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    يمكن أن تصدر حركة البيانات من أي عنوان من العناوين الأربعة، لذا فإن إضافة بعضها فقط إلى قائمة السماح يتسبب في إخفاقات متقطعة
    في المزامنة. هذه العناوين الأربعة هي نفسها في جميع مناطق Living Security. راجع{' '}
    <a href="/ar/integrations/managing/egress-ip-addresses">
      تكوين عناوين IP الصادرة للتكاملات
    </a>{' '}
    للاطلاع على القائمة الكاملة وسياسة التغيير واستكشاف الأخطاء وإصلاحها.
  </Note>;

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

## ما الذي يساهم به هذا التكامل

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

* `training.completed` — يُكمل التدريب على الأمان
* `training.past.due` — لديه تدريب متأخر
* `phishing.simulation.clicked` — نقر على رابط في محاكاة دون الإبلاغ عنها

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

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

| بيانات الاعتماد | الوصف |
| - | - |
| **مفتاح API** | رمز حامل (bearer token) لـ Reporting API يتم إنشاؤه ضمن **Account Settings → API**. يُرسَل مع كل طلب في الترويسة `Authorization: Bearer`. |
| **منطقة خادم Reporting API** | المنطقة التي تم توفير حساب KnowBe4 الخاص بك عليها، ويتم اختيارها من قائمة (US وEU وCanada وUK وGermany). |

**النطاقات (Scopes):** لا يلزم ضبط أي نطاقات — رموز KnowBe4 Reporting API للقراءة فقط بحكم تصميمها، وهي غير محددة بنطاقات. يمنح الرمز صلاحية قراءة المستخدمين وتسجيلات التدريب ونتائج اختبارات الأمان الخاصة بالتصيد الاحتيالي، وهذا بالضبط ما تقرؤه عملية المزامنة.

**الدور المطلوب:** **Account Admin** في KnowBe4 (لا يمكن إلا لمسؤولي الحساب الوصول إلى **Account Settings → API**)

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

* يجب أن تكون مسجلاً الدخول إلى وحدة تحكم KnowBe4 الخاصة بك بدور **Account Admin**. لا يمكن إلا لمسؤولي الحساب الوصول إلى **Account Settings → API** لتمكين Reporting API وإنشاء الرموز.

***

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

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

<Steps>
  <Step title="تمكين Reporting API وإنشاء رمز">
    1. سجّل الدخول إلى وحدة تحكم KnowBe4 الخاصة بك.
    2. انقر على اسم حسابك في الزاوية العلوية اليمنى، ثم اختر **Account Settings**.
    3. في قائمة التنقل اليسرى، اختر **API**.
    4. فعّل **Reporting API** إذا لم يكن ممكَّناً بالفعل، ثم أنشئ رمز API جديداً.

    امنح الرمز غرضاً وصفياً (مثل `Living Security Platform`) إذا طلبت وحدة التحكم ذلك.

    <Warning>
      يعرض KnowBe4 قيمة رمز API **مرة واحدة فقط** عند إنشائه. انسخه فوراً واحفظه في مكان آمن (مثل خزنة كلمات المرور أو مدير الأسرار). إذا انتقلت بعيداً دون نسخه، فيجب عليك إنشاء رمز جديد.
    </Warning>

    <Note>
      Reporting API للقراءة فقط. فهو يتيح الوصول إلى المستخدمين وتسجيلات التدريب ونتائج اختبارات الأمان الخاصة بالتصيد الاحتيالي — وهي البيانات التي تستوعبها Living Security لأغراض التقييم وإعداد التقارير. ولا يلزم منح صلاحية كتابة.
    </Note>
  </Step>

  <Step title="إضافة عناوين IP الصادرة الخاصة بـ Living Security إلى قائمة Allowed IP Addresses">
    يتيح لك KnowBe4 تقييد الوصول إلى Reporting API بمجموعة محددة من عناوين IP المصدر. يوجد هذا الإعداد في المكان نفسه الذي يوجد فيه الرمز:

    1. في وحدة تحكم KnowBe4 الخاصة بك، انتقل إلى **Account Settings → API → Allowed IP Addresses**.
    2. أضف كل [عنوان IP صادر خاص بـ Living Security](/ar/integrations/managing/egress-ip-addresses) إلى قائمة السماح. تنطبق العناوين الأربعة نفسها في جميع المناطق.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **إذا تم ضبط قائمة Allowed IP Addresses، فإنها تُطبَّق على مستوى الشبكة.** سينجح مربع حوار الاتصال عند المصادقة، لكن عمليات مزامنة البيانات ستفشل (بسبب الحظر على مستوى الشبكة، وغالباً ما يظهر ذلك على هيئة `403`) إلى أن تتم إضافة عناوين IP الصادرة الخاصة بـ Living Security إلى قائمة السماح. وإذا أضفت أي عنوان إلى هذه القائمة، فيجب عليك أيضاً إضافة نطاقات Living Security، وإلا سيتم رفض طلباتنا حتى لو كان الرمز صالحاً.
    </Warning>

    <Note>
      قد تتغير عناوين IP الصادرة الخاصة بـ Living Security عند تحديث البنية التحتية، مع أننا نُبقي هذه التغييرات نادرة. إذا بدأت عمليات مزامنة البيانات بالفشل بعد أن كانت تعمل سابقاً، فراجع [تهيئة عناوين IP الصادرة للتكامل](/ar/integrations/managing/egress-ip-addresses) وتحقق من أن قائمة Allowed IP Addresses مطابقة.
    </Note>
  </Step>

  <Step title="تحديد منطقة خادم KnowBe4 الخاصة بك">
    يقدّم KnowBe4 خدمة Reporting API من مضيف خاص بكل منطقة. وتختار منطقتك في مربع حوار الاتصال بدلاً من كتابة اسم المضيف:

    | المنطقة | مضيف Reporting API |
    | - | - |
    | الولايات المتحدة | `us.api.knowbe4.com` |
    | أوروبا | `eu.api.knowbe4.com` |
    | كندا | `ca.api.knowbe4.com` |
    | المملكة المتحدة | `uk.api.knowbe4.com` |
    | ألمانيا | `de.api.knowbe4.com` |

    إذا لم تكن متأكداً من المنطقة التي يستخدمها حسابك، فتحقق من نطاق عنوان URL لوحدة تحكم KnowBe4 الخاصة بك أو تواصل مع مسؤول KnowBe4 لديك.

    <Note>
      هذه المناطق الخمس هي التي يمكن لـ Living Security الوصول إليها. وإذا كان حساب KnowBe4 الخاص بك على خادم آخر (مثل نسخة حكومية أمريكية)، فتواصل مع دعم Living Security قبل البدء بإعداد الاتصال.
    </Note>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | الحقل | القيمة |
    | - | - |
    | **مفتاح API** | رمز Reporting API من الجزء أ، الخطوة 1 |
    | **منطقة خادم Reporting API** | المنطقة من الجزء أ، الخطوة 3 (مثل الولايات المتحدة) |
  </ConnectInPlatform>
</Steps>

لقد أصبحت الآن متصلاً بـ KnowBe4.

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    رمز API غير صالح أو منتهي الصلاحية. تحقق من أن الرمز صحيح وأنه لم يُعَد إنشاؤه في **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    إما أن الرمز لا يملك صلاحية الوصول إلى Reporting API، أو أن عنوان IP الخاص بالطلب غير مدرج في قائمة Allowed IP Addresses. تحقق من أن Reporting API ممكَّن ومن أن جميع [عناوين IP الصادرة الخاصة بـ Living Security](/ar/integrations/managing/egress-ip-addresses) الأربعة مدرجة في قائمة السماح.
  </Accordion>

  <Accordion title="نتائج فارغة (200 OK ولكن بدون بيانات)">
    قد لا تتوفر بعد بيانات لدى Reporting API لإرجاعها، أو قد لا يملك حساب الرمز إمكانية الاطلاع على المستخدمين والحملات التي تستوعبها Living Security. تحقق من أن الرمز تم إنشاؤه بواسطة Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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