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

# إعداد تكامل Google Workspace

> اربط Google Workspace بمنصة Living Security لمتابعة نشاط دورة حياة المستخدم، وتسجيل الدخول، والمصادقة متعددة العوامل (MFA)، والنشاط الإداري، وحماية البيانات.

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="Google Workspace" recommendDelegated={true} />

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

يمكن أن يسهم Google Workspace بنشاط مُوحَّد يتعلق بدورة حياة المستخدم، وتسجيل الدخول، والمصادقة متعددة العوامل (MFA)، والنشاط الإداري، وحماية البيانات. وتشمل الأمثلة التي جرت مراجعتها ما يلي:

* `account.compromised` — حساب تم الإبلاغ عنه على أنه مخترَق
* `data.sensitive.downloaded` — تنزيل بيانات حساسة
* `auth.login.unusual` — تسجيل الدخول من سياقات غير معتادة

اطّلع على [كيفية تحوّل بيانات التكامل إلى إشارات](/ar/signals/data-sources).

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

| بيانات الاعتماد | الوصف |
| - | - |
| **مفتاح حساب الخدمة** | مفتاح بصيغة JSON لحساب خدمة مخصص في Google Cloud. |
| **المسؤول المفوَّض** | عنوان البريد الإلكتروني لمسؤول في Google Workspace يمكن لحساب الخدمة انتحال هويته. |

فعّل واجهات Admin SDK البرمجية (APIs)، ولا تمنح التفويض إلا للنطاقات (scopes) التي يقرؤها الاتصال:

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## الإعداد

<Steps>
  <Step title="إنشاء حساب خدمة في Google Cloud">
    أنشئ حساب خدمة مخصصًا، وفعّل التفويض على مستوى النطاق (domain-wide delegation)، ثم نزّل مفتاح JSON الخاص به. احفظ المفتاح في مكان آمن.
  </Step>

  <Step title="تفويض التفويض على مستوى النطاق">
    في Google Admin Console، افتح **Security → Access and data control → API controls → Manage Domain Wide Delegation**. أضف معرّف العميل الرقمي لحساب الخدمة والنطاقات الثلاثة للقراءة فقط المذكورة أعلاه.
  </Step>

  <Step title="اختيار المسؤول المفوَّض">
    اختر مسؤولًا نشطًا في Workspace يمكنه قراءة الدليل، وتعيينات الأدوار، وتقارير التدقيق. تستخدم Living Security هذه الهوية فقط لعمليات القراءة المفوَّضة عبر واجهات API.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    حمّل بيانات اعتماد حساب الخدمة أو الصقها وفق المطلوب، ثم أدخل عنوان البريد الإلكتروني للمسؤول المفوَّض.
  </ConnectInPlatform>
</Steps>

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

تحقق من أن الاتصال قادر على قراءة مستخدم واحد من الدليل ونشاط تسجيل الدخول الأخير. تشير Google إلى أن منح التفويض الجديد على مستوى النطاق قد يستغرق بعض الوقت حتى يتم تعميمه.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    تأكد من أن التفويض على مستوى النطاق يستخدم معرّف العميل الرقمي لحساب الخدمة وليس عنوان بريده الإلكتروني، وأن النطاقات الثلاثة جميعها مطابقة تمامًا.
  </Accordion>

  <Accordion title="الدليل يعمل لكن تعيينات الأدوار مفقودة">
    أضف `admin.directory.rolemanagement.readonly` إلى إدخال التفويض، وتأكد من أن المسؤول المفوَّض يستطيع عرض تعيينات الأدوار.
  </Accordion>

  <Accordion title="التقارير فارغة">
    تأكد من تفعيل Admin Reports API ومن أن المسؤول المفوَّض يستطيع الوصول إلى تقارير التدقيق الخاصة بمستأجر Workspace.
  </Accordion>
</AccordionGroup>

للاطلاع على التفاصيل من جانب المورّد، راجع [دليل Google للتفويض على مستوى النطاق](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority).

<PublicIntegrationNextSteps />


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