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

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

> قم بربط Abnormal Security لاستيراد بيانات تهديدات البريد الإلكتروني وحملات التصيد الاحتيالي.

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="Abnormal Security" />

## ما الذي يوفره هذا التكامل

يمكن لـ Abnormal Security توفير نشاط موحّد يتعلق بتهديدات البريد الإلكتروني وتسليمه وحظره وإبلاغ الموظفين عنه. وتشمل الأمثلة التي تمت مراجعتها ما يلي:

* `phishing.real.blocked` — تصيد احتيالي حقيقي تم حظره قبل التسليم
* `phishing.real.delivered` — تصيد احتيالي حقيقي تم تسليمه إلى صندوق الوارد
* `phishing.real.reported` — الإبلاغ عن رسائل تصيد احتيالي حقيقية

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

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

| بيانات الاعتماد | وصف |
| - | - |
| **مفتاح API** | رمز حامل (bearer token) لواجهة REST API يتم إنشاؤه من بوابة Abnormal |
| **مضيف API الإقليمي** | اسم المضيف لبيئة Abnormal Security الخاصة بك |

**النطاقات:** وصول مخصص مع صلاحية **قراءة** على `Abuse Campaigns (AI Security Mailbox)` و`Threats`

**الدور المطلوب:** **Security Admin** أو **Super Admin** في Abnormal Security

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

* يجب أن تتوفر لديك صلاحية **Security Admin** أو **Super Admin** في Abnormal Security لإنشاء رموز API وإدارتها.

***

## الجزء أ — في Abnormal Security

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

<Steps>
  <Step title="الانتقال إلى إدارة رموز API">
    1. سجّل الدخول إلى بوابة Abnormal Security.
    2. في قائمة التنقل اليسرى، انقر على **الإعدادات**، ثم اختر **التكاملات**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/settings-integrations.webp?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=7f5d7a616acdcf72a9048f16c6706b5e" alt="قائمة الإعدادات في Abnormal Security تعرض خيار التكاملات" width="1999" height="1680" data-path="integrations/images/abnormal-security/settings-integrations.webp" />

    3. مرّر لأسفل إلى قسم **API Token Management** في أسفل صفحة التكاملات.
    4. انقر على **+ Create New Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/api-token-management.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=13cfdfb7ced9b3f3fca67c781ee7e844" alt="قسم API Token Management مع زر Create New Token" width="1239" height="1151" data-path="integrations/images/abnormal-security/api-token-management.avif" />
  </Step>

  <Step title="تحديد نوع التكامل">
    اختر **REST API** كنوع للتكامل، ثم انقر على **التالي**.
  </Step>

  <Step title="اختيار نطاق الرمز">
    اختر نطاقًا للرمز، ثم انقر على **التالي**:

    * **العميل (جميع المستأجرين الحاليين والمستقبليين)** — استخدم هذا الخيار إذا كان حساب Abnormal لديك يدير عدة مستأجرين. يغطي هذا الرمز جميع المستأجرين الحاليين والمستقبليين تلقائيًا.
    * **Tenant (Single Tenant)** — استخدم هذا الخيار لحصر الرمز في مستأجر واحد محدد.

    بالنسبة لمعظم المؤسسات التي لديها مستأجر واحد في Abnormal، يصلح أي من الخيارين. وعند الشك، اختر **العميل**.
  </Step>

  <Step title="منح الوصول المطلوب">
    اختر **Custom Access** وفعّل **قراءة** لكلتا مجموعتي نقاط النهاية:

    | مجموعة نقاط النهاية | مستوى الوصول المطلوب |
    | - | - |
    | **Abuse Campaigns (AI Security Mailbox)** | قراءة |
    | **Threats** | قراءة |

    ثم انقر على **التالي**.

    <Note>
      يعيد الوصول بصلاحية **قراءة** بيانات التهديدات والحملات غير الحساسة. أما **Read Sensitive** فيتيح بالإضافة إلى ذلك الوصول إلى المعلومات الشخصية والمرفقات وبيانات الموظفين. وتتيح صلاحية **الكتابة** إرسال إجراءات المعالجة. امنح صلاحية **قراءة** فقط ما لم تتطلب حالة الاستخدام لديك أكثر من ذلك تحديدًا.
    </Note>
  </Step>

  <Step title="تكوين تفاصيل الرمز وقائمة عناوين IP الآمنة">
    املأ الحقول التالية:

    * **Token Name** — اسم وصفي (مثل `Living Security Platform`)
    * **وصف** — سياق اختياري (مثل `Read access for Living Security HRM platform`)
    * **Token Expiry** — اختر **90** أو **180** أو **365 يومًا** بما يتوافق مع سياسة التدوير لديك. اضبط تذكيرًا في التقويم لتدوير الرمز قبل انتهاء صلاحيته.
    * **IP Safelist** — أدخل نطاقات عناوين IP الصادرة الخاصة بـ Living Security، نطاقًا واحدًا في كل إدخال. انقر على **إضافة** بعد كل إدخال.

    <EgressIpSafelist system="Abnormal Security" />

    <Warning>
      **قائمة عناوين IP الآمنة إلزامية.** يرفض Abnormal Security جميع طلبات API الواردة من عناوين غير مدرجة في القائمة الآمنة. سينجح مربع حوار الاتصال، لكن عمليات مزامنة البيانات ستفشل مع `401 Unauthorized` إلى أن تتم إضافة عناوين IP الصحيحة إلى القائمة الآمنة.
    </Warning>

    ثم انقر على **التالي**.
  </Step>

  <Step title="مراجعة الرمز وإنشاؤه">
    راجع ملخص تكوين الرمز، ثم انقر على **Create Token**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/review-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=6935f488f5778fcea3f6907629aa1316" alt="شاشة مراجعة تكوين الرمز" style={{maxWidth: "550px"}} width="1910" height="726" data-path="integrations/images/abnormal-security/review-token.avif" />
  </Step>

  <Step title="نسخ الرمز وحفظه">
    **انسخ الرمز فورًا** واحفظه في مكان آمن (مثل خزنة كلمات المرور أو مدير الأسرار)، ثم انقر على **تم**.

    <img src="https://mintcdn.com/livingsecurity/TnbD8Y_d8KdapRc2/integrations/images/abnormal-security/copy-token.avif?fit=max&auto=format&n=TnbD8Y_d8KdapRc2&q=85&s=fa752c333af664ad5b3ed037dbb67143" alt="مربع حوار نسخ الرمز يعرض الرمز الذي تم إنشاؤه" style={{maxWidth: "550px"}} width="1999" height="329" data-path="integrations/images/abnormal-security/copy-token.avif" />

    <Warning>
      تعرض بوابة Abnormal قيمة الرمز **مرة واحدة فقط**. وإذا غادرت الصفحة دون نسخه، فيجب عليك إنشاء رمز جديد وإلغاء الرمز القديم.
    </Warning>
  </Step>

  <Step title="تحديد مضيف API الإقليمي">
    حدّد مضيف API الصحيح لبيئة Abnormal Security الخاصة بك:

    | البيئة | مضيف API الإقليمي |
    | - | - |
    | الافتراضية (الولايات المتحدة التجارية) | `api.abnormalplatform.com` |
    | الاتحاد الأوروبي | `eu.rest.abnormalsecurity.com` |
    | FedRAMP | `rest.abnormalsecurity.us` |

    أدخل **المضيف فقط** — دون البادئة `https://` ودون شرطة مائلة في النهاية.

    إذا لم تكن متأكدًا من البيئة التي تستخدمها مؤسستك، فتحقق من عنوان URL لبوابة Abnormal الخاصة بك أو تواصل مع فريق حسابك في Abnormal Security.
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="Abnormal Security">
    | الحقل | القيمة |
    | - | - |
    | **مفتاح API** | الرمز الذي تم نسخه في الجزء أ، الخطوة 7 |
    | **مضيف API الإقليمي** | المضيف من الجزء أ، الخطوة 8 (الافتراضي للولايات المتحدة: `api.abnormalplatform.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/abnormal-security/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=46afa66685c5f59483324c863fd4fa86" alt="مربع حوار اتصال Living Security الخاص بـ Abnormal Security" style={{maxWidth: "450px"}} width="576" height="638" data-path="integrations/images/abnormal-security/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

لقد تم الآن ربط Abnormal Security.

***

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

<AccordionGroup>
  <Accordion title="403 Forbidden — ليست لديك صلاحية لتنفيذ هذا الإجراء">
    الرمز يفتقر إلى أحد صلاحيات الوصول المطلوبة أو كليهما (**Abuse Campaigns** أو **Threats**). لا يمكن تغيير نوع التكامل والنطاق ومستوى الوصول بعد إنشاء الرمز — يجب عليك إنشاء رمز جديد بالإعدادات الصحيحة وإلغاء الرمز القديم.
  </Accordion>

  <Accordion title="401 Unauthorized">
    إما أن الرمز غير صالح أو منتهي الصلاحية، أو أن عنوان IP الخاص بالطلب غير مدرج في القائمة الآمنة. تحقق مما يلي:

    1. لم يتم إلغاء الرمز ولم تنته صلاحيته
    2. جميع [عناوين IP الصادرة الأربعة الخاصة بـ Living Security](/ar/integrations/managing/egress-ip-addresses) مدرجة في القائمة الآمنة

    إذا كانت عمليات المزامنة تعمل سابقًا لكنها تفشل الآن مع `401`، فقد تكون عناوين IP الصادرة قد تغيّرت — راجع [تكوين عناوين IP الصادرة للتكاملات](/ar/integrations/managing/egress-ip-addresses) وتحقق من أن القائمة الآمنة تطابقها.
  </Accordion>

  <Accordion title="انتهاء صلاحية الرموز القديمة (30 أبريل 2027)">
    إذا كانت لدى مؤسستك رموز API تم إنشاؤها قبل طرح تجربة إدارة الرموز بالخدمة الذاتية، فستظهر بوصفها **Legacy** في لوحة التحكم. تستمر الرموز القديمة في العمل لكن لا يمكن تدويرها — يمكن فقط تحديث قائمة عناوين IP الآمنة الخاصة بها. تنتهي صلاحية جميع الرموز القديمة تلقائيًا في **30 أبريل 2027**. خطط لاستبدال الرموز القديمة برموز جديدة قبل ذلك التاريخ.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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