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

# تكامل Microsoft Teams

> اربط Living Security بـ Microsoft Teams لإرسال إشعارات التدريب والتنبيهات الأمنية وإعلانات القنوات.

يرسل تكامل Microsoft Teams إشعارات Living Security إلى المستخدمين والقنوات عبر تطبيق Living Security لـ Teams. استخدمه لإسناد التدريب، وتنبيهات المخاطر البشرية، ورسائل الإطلاق، وإعلانات فريق الأمان.

هذا التكامل مخصص للإشعارات فقط. لا يرسل المستخدمون أوامر إلى الروبوت في Microsoft Teams. عند تثبيت التطبيق، يحفظ الروبوت مرجع محادثة Teams لاستخدامه في الإشعارات الاستباقية المستقبلية. رسائل التثبيت أحادية الاتجاه، ويمكن تخصيصها أو تعطيلها وفقًا لمتطلبات الإطلاق في المؤسسة.

<Warning>
  لا بد أن يقوم مسؤول Microsoft Teams برفع تطبيق Living Security لـ Teams
  واعتماده وتوزيعه. أما موافقة المسؤول في Microsoft Entra `User.Read.All` فهي
  اختيارية، ولا تتيح سوى البحث الاحتياطي باستخدام البريد الإلكتروني أو اسم
  المستخدم الأساسي (UPN).
</Warning>

<Note>
  لإعداد تسليم التنبيهات التحفيزية وأدلة التشغيل، ابدأ من **الإعدادات ← الاتصالات ←
  القنوات** ثم انقر على بطاقة **Microsoft Teams**. تتناول هذه الصفحة
  إعداد تطبيق Teams الأساسي.
</Note>

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

قبل إعداد Microsoft Teams، تأكد من توفر ما يلي:

* مسؤول Microsoft Teams يمكنه رفع تطبيقات المؤسسة واعتمادها. يجوز أن يشغل الشخص نفسه دورَي المسؤول كليهما.
* مسؤول Microsoft Entra، وذلك فقط إذا أردت تمكين البحث الاحتياطي الاختياري باستخدام البريد الإلكتروني/UPN مع موافقة التطبيق `User.Read.All` على مستوى المستأجر
* صلاحيات مسؤول Living Security
* مؤسسة Living Security نشطة
* أسماء الفريق والقناة التي ينبغي تسليم الإعلانات الأمنية إليها، إذا كانت إعلانات القنوات مفعّلة
* معرّف مستأجر Microsoft Entra الخاص بك، المتاح ضمن **Microsoft Entra admin center ← الهوية ← نظرة عامة**

## من يقوم بماذا

| الدور | المسؤولية |
| - | - |
| **مسؤول Living Security** | يربط مستأجر Microsoft، وينزّل الحزمة الإقليمية، ويضبط رسائل التثبيت، ويتحقق من الإعداد، ويرسل الاختبارات |
| **مسؤول Microsoft Teams** | يرفع التطبيق ويسمح به، ويوزعه على المستخدمين أو المجموعات المستهدفة، ويعيّن سياسات إعداد التطبيق |
| **مسؤول Microsoft Entra**، اختياري | يمنح موافقة التطبيق `User.Read.All` لمعرّف تطبيق الروبوت الإقليمي عند الحاجة إلى البحث الاحتياطي باستخدام البريد الإلكتروني/UPN |
| **مالك الفريق في Teams**، عند استخدام التسليم عبر القنوات | يثبّت التطبيق أو يعتمده للفريق والقناة المستهدفين |

قد يكون هؤلاء أشخاصًا مختلفين. شارك مع مسؤول Microsoft Teams المجموع الاختباري للحزمة، ومعرّف تطبيق Teams، و**معرّف تطبيق الروبوت**، والفئة المستهدفة بالإطلاق. شارك عنوان URL الخاص بالموافقة الذي تم إنشاؤه مع مسؤول Microsoft Entra فقط عند تمكين البحث الاحتياطي الاختياري باستخدام البريد الإلكتروني/UPN. لا تشارك أي بيانات اعتماد أخرى غير ذات صلة من Living Security.

## الإعداد

<Steps>
  <Step title="افتح لوحة إعداد Microsoft Teams">
    في Living Security، انتقل إلى **الإعدادات ← الاتصالات ← القنوات** وحدد **Microsoft Teams**.

    تعرض اللوحة منطقة مؤسستك، واسم ملف الحزمة، ومعرّف تطبيق Teams، ومعرّف تطبيق الروبوت، والمجموع الاختباري SHA256، وحالة إعداد مستأجر Microsoft، وتعليمات التثبيت، وعناصر التحكم في رسائل التثبيت، وأدوات التحقق وإرسال إشعارات الاختبار.

    <Check>
      تطابق المنطقة المعروضة في Living Security المنطقة التي تتم استضافة مؤسستك فيها.
    </Check>
  </Step>

  <Step title="اربط مستأجر Microsoft الخاص بك">
    في **Connect your tenant**، أدخل معرّف مستأجر Microsoft Entra الذي يملك المستخدمين وقنوات Teams التي ستتلقى الإشعارات، ثم انقر على **Save Microsoft tenant**. لا يمكن أن ينتمي مستأجر Microsoft واحد إلا إلى مؤسسة Living Security واحدة.

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

    <Check>
      تعرض Living Security الرسالة **Microsoft tenant connected** قبل أن تتابع.
    </Check>

    <Note>
      اربط المستأجر قبل تثبيت تطبيق Teams متى أمكن. إذا كان التطبيق مثبّتًا بالفعل، فاحفظ المستأجر وحدد **Validate install** أولًا. تحاول Living Security ربط التثبيت الحالي تلقائيًا؛ ولا تُعِد التثبيت إلا إذا تعذّر على التحقق اكتشافه.
    </Note>
  </Step>

  <Step title="نزّل حزمة Teams الإقليمية">
    انقر على **Download Teams package**. توفّر Living Security حزمة ZIP خاصة بمنطقة مؤسستك.

    تحقق من الملف الذي نزّلته بمقارنته بالمجموع الاختباري SHA256 المعروض في Living Security قبل إجراء أي تغيير. لإعطاء التطبيق اسمك وأيقوناتك الخاصة، اتبع [إعادة وسم الحزمة الإقليمية](#%D8%A5%D8%B9%D8%A7%D8%AF%D8%A9-%D9%88%D8%B3%D9%85-%D8%A7%D9%84%D8%AD%D8%B2%D9%85%D8%A9-%D8%A7%D9%84%D8%A5%D9%82%D9%84%D9%8A%D9%85%D9%8A%D8%A9) بعد هذا التحقق وقبل رفع الحزمة.

    <Check>
      يطابق المجموع الاختباري للملف الذي نزّلته المجموع الاختباري SHA256 المعروض في Living Security.
    </Check>
  </Step>

  <Step title="ارفع الحزمة وثبّتها في مركز إدارة Teams">
    في مركز إدارة Microsoft Teams، انتقل إلى **Teams apps ← Manage apps ← الإجراءات ← Upload new app**، ثم ارفع ملف ZIP الذي نزّلته من Living Security.

    تأكد مما يلي:

    * يطابق معرّف تطبيق Teams ومعرّف تطبيق الروبوت القيم المعروضة في Living Security
    * اسم التطبيق هو اسم Living Security الإقليمي، أو الاسم الذي عيّنته إذا أعدت وسم الحزمة
    * الناشر هو **Living Security**. لا تغيّر إعادة وسم الحزمة الناشر
    * التطبيق غير محظور
    * التطبيق متاح للمستخدمين أو المجموعات المستهدفة
    * التطبيق مثبّت عبر سياسات إعداد التطبيق أو التثبيت المستهدف للمستخدمين والفرق/القنوات التي ينبغي أن تتلقى الإشعارات

    قد تستغرق Microsoft بعض الوقت لنشر تغييرات توفّر التطبيق وسياسات الإعداد.

    <Note>
      إذا فشل التحقق أو الاختبار مباشرة بعد تغيير في سياسة التطبيق، فتأكد من تعيين السياسة في مركز إدارة Microsoft Teams وأعد المحاولة بعد أن تنتهي Microsoft من نشرها.
    </Note>
  </Step>

  <Step title="ثبّت التطبيق أو افتحه">
    وزّع التطبيق الشخصي على المستخدمين المستهدفين. قبل أن تتمكن Living Security من
    إرسال اختبار شخصي إلى تثبيت تم اكتشافه، يجب أن يقوم مستخدم واحد على الأقل بتثبيت
    تطبيق Living Security الشخصي أو فتحه في Microsoft Teams. يتيح ذلك
    للروبوت التقاط هوية المستخدم الموثوقة ومرجع المحادثة الشخصية. لا يمكن استخدام
    التثبيت في قناة وحده لإجراء اختبار شخصي على تثبيت تم اكتشافه.

    للتسليم عبر القنوات، ثبّت التطبيق في الفريق والقناة المستهدفين ليتمكن
    الروبوت من التقاط مرجع محادثة تلك القناة.

    <Check>
      قام مستخدم مستهدف بتثبيت التطبيق الشخصي أو فتحه، أو أن التطبيق
      مثبّت في القناة المستهدفة.
    </Check>
  </Step>

  <Step title="اضبط رسائل التثبيت">
    في قسم **Install message controls**، اختر ما إذا كانت رسائل تثبيت Teams سيتم إرسالها، وخصّص النص أحادي الاتجاه بما يناسب مؤسستك.

    عناصر التحكم المتاحة:

    * Send install messages
    * Send personal install messages
    * Send channel install messages
    * Default message
    * Personal message
    * Channel message

    تدعم حقول الرسائل `{{installerName}}`، الذي يُستبدل باسم العرض للمستخدم الذي ثبّت التطبيق. اترك الرسالة الشخصية أو رسالة القناة فارغة لاستخدام الرسالة الافتراضية التي ضبطتها. وإذا كانت الرسالة الافتراضية فارغة أيضًا، تستخدم Living Security الرسالة المضمّنة لذلك النطاق.
  </Step>

  <Step title="تحقق من الإعداد">
    انقر على **Validate install** في Living Security. يتحقق هذا الإجراء من توفر الحزمة الإقليمية، ومن وجود إعداد مستأجر Microsoft وتفرّده لمؤسسة Living Security هذه، ومن ضبط بيانات اعتماد الروبوت الإقليمي، ومن اكتشاف تثبيت نشط للتطبيق للمستأجر المرتبط.

    <Check>
      تعرض عملية التحقق الرسالة **Validation passed** قبل أن ترسل إشعارات فعلية.
    </Check>
  </Step>

  <Step title="أرسل إشعارات اختبار">
    للاختبار الشخصي الافتراضي، انقر على **Send test to detected installation**.
    تحدد Living Security تثبيتًا شخصيًا نشطًا تم اكتشافه وتستخدم الهوية الموثوقة
    ومرجع المحادثة المخزّنين له. لا يستدعي هذا الاختبار Microsoft Graph
    ولا يتطلب موافقة `User.Read.All`.

    إذا لم يتم اكتشاف أي تثبيت شخصي، فاطلب من مستخدم تثبيت
    تطبيق Living Security الشخصي أو فتحه، ثم حدد **Validate install** مرة أخرى، وبعد ذلك
    أعد إرسال الاختبار. لا تستخدم اختبار البريد الإلكتروني/UPN المستهدف المتقدم إلا عند
    تمكين البحث الاحتياطي الاختياري.

    <Check>يظهر إشعار الاختبار أحادي الاتجاه في Microsoft Teams.</Check>

    راجع المحاولة المقابلة في [سجل الاتصالات](/ar/features/communications/log) عند الحاجة إلى تشخيصات التسليم.
  </Step>
</Steps>

## إعادة وسم الحزمة الإقليمية

الحزمة الإقليمية هي أرشيف ZIP يتكون من ثلاثة ملفات: `manifest.json` و`color.png` و`outline.png`. يمكنك تعيين اسم التطبيق والأيقونات الخاصة بك في هذه الحزمة قبل رفعها. تدعم Living Security هذا المسار للحزم الإقليمية التي يرفعها مسؤول Teams مباشرة.

نفّذ ذلك بعد تنزيل الحزمة والتحقق منها، وقبل رفعها في مركز إدارة Teams.

<Steps>
  <Step title="فك ضغط الحزمة">
    استخرج ملف ZIP. يحتوي على ثلاثة ملفات بالضبط في جذر
    الأرشيف: `manifest.json` و`color.png` و`outline.png`.
  </Step>

  <Step title="استبدل الأيقونات">
    استبدل `color.png` و`outline.png` بأيقوناتك الخاصة. احتفظ باسمَي الملفين
    نفسيهما.

    | الملف | المتطلب |
    | - | - |
    | `color.png` | PNG بألوان كاملة، بحجم 192 × 192 بكسل، دون شفافية |
    | `outline.png` | PNG شفاف، بحجم 32 × 32 بكسل |
  </Step>

  <Step title="عيّن اسم تطبيقك">
    في `manifest.json`، عدّل هذين الحقلين:

    * `name.short` — الاسم المعروض في ترويسة تطبيق Teams وفي المناطق الأخرى محدودة المساحة. الحد الأقصى 30 حرفًا.
    * `name.full` — الاسم المعروض في كتالوج التطبيقات وتفاصيل التطبيق. الحد الأقصى 100 حرف.

          <Note>
            إذا كان تطبيق Living Security مرفوعًا بالفعل في مركز إدارة Teams، فعيّن
            `version` إلى قيمة أعلى من الإصدار المثبّت هناك. ترفض Microsoft Teams أي
            تحديث لا يزيد رقم الإصدار، وقد يحمل التنزيل الجديد الإصدار نفسه الذي تحمله الحزمة
            المثبّتة لديك أو إصدارًا أقل منه.

            اقرأ الإصدار المثبّت في مركز إدارة Teams ضمن **Teams apps ← Manage
            apps**، في صفحة تفاصيل التطبيق. قارنه بقيمة `version` في
            `manifest.json` الذي نزّلته للتو، ثم عيّن قيمة أعلى من كليهما. احتفظ
            بتنسيق `MAJOR.MINOR.PATCH` المكوّن من ثلاثة أرقام.

            على سبيل المثال، إذا كان التطبيق المثبّت `1.1.1` وكان تنزيلك الجديد `1.1.0`،
            فعيّن `1.1.2`. إن رفع `1.1.0` الذي نزّلته إلى `1.1.1` سيكرر
            الإصدار المثبّت، وسترفض Teams الرفع.
          </Note>
  </Step>

  <Step title="اترك حقول الهوية دون تغيير">
    لا تغيّر هذه الحقول. يحمل كل منها هوية التطبيق أو الروبوت أو
    تسجيل الدخول الأحادي:

    * `id`
    * `botId` في `bots`
    * `webApplicationInfo`
    * `validDomains`
    * `contentUrl` و`websiteUrl` في `staticTabs`

          <Warning>
            قد يؤدي تغيير أي حقل من حقول الهوية إلى بقاء التطبيق قابلًا للتثبيت لكنه يعجز عن
            تسليم الإشعارات أو إكمال تسجيل الدخول الأحادي. يتحقق **Validate install** من
            المستأجر وبيانات اعتماد الروبوت والتثبيت الذي تم اكتشافه. ولا يقارن ملف
            manifest الخاص بك بالحزمة التي أنشأتها Living Security.
          </Warning>
  </Step>

  <Step title="أعد ضغط الملفات الثلاثة">
    أنشئ أرشيف ZIP جديدًا من الملفات الثلاثة. ضعها في جذر
    الأرشيف، دون مجلد يحتويها. ترفض Microsoft Teams أي حزمة يكون
    `manifest.json` فيها داخل مجلد.
  </Step>

  <Step title="ارفع الحزمة وتحقق منها">
    ارفع ملف ZIP المعاد وسمه في مركز إدارة Teams، ثم عد إلى Living
    Security وانقر على **Validate install**. أرسل إشعار اختبار.

    <Check>
      تعرض عملية التحقق الرسالة **Validation passed**، ويصل إشعار الاختبار إلى
      Microsoft Teams باسم تطبيقك وأيقوناته.
    </Check>
  </Step>
</Steps>

### الناشر والمجموع الاختباري

تحدد إعادة الوسم اسم التطبيق والأيقونات. ولا تغيّر أمرين:

* **يبقى الناشر Living Security.** تذكر حقول `developer` في manifest اسم Living Security وتشير إلى موقع Living Security الإلكتروني وسياسة الخصوصية وشروط الخدمة. وهي معًا تحدد الشركة التي تشغّل الخدمة، لذلك تستمر Teams في عرض **Living Security** ناشرًا في صفحة تفاصيل التطبيق، وفي مربعات حوار الموافقة على الأذونات، وفي تقارير استخدام التطبيق. أما اسمك وأيقوناتك فهما ما يراه المستخدمون في ترويسة التطبيق وكتالوج التطبيقات والإشعارات.
* **لن يطابق المجموع الاختباري SHA256 الحزمة بعد التعديل.** يصف المجموع الاختباري المعروض في Living Security الحزمة كما تم تنزيلها. تحقق منه قبل تعديل الملفات، ثم سجّل المجموع الاختباري لحزمتك المعاد وسمها ضمن سجلات الإطلاق لديك.

## اختياري: تمكين البحث الاحتياطي باستخدام البريد الإلكتروني/UPN

يستخدم التسليم الشخصي المعتاد معرّف كائن Microsoft Entra موثوقًا تعرفه
Living Security بالفعل، مع مرجع محادثة الروبوت الذي يتم التقاطه عندما
يثبّت المستخدم التطبيق أو يفتحه. ويستخدم التسليم عبر القنوات مرجع محادثة القناة المخزّن.
ولا يتطلب أي من المسارين Microsoft Graph.

إذا لم يكن لدى المستلم معرّف كائن Entra موثوق، يمكن لـ Living Security
اختياريًا استخدام Microsoft Graph لتحديد المستلم من خلال عنوان البريد الإلكتروني أو UPN.
لتمكين هذا البحث الاحتياطي، اطلب من مسؤول Microsoft Entra النقر على **Grant
optional User.Read.All consent** في لوحة إعداد Teams والموافقة على
إذن التطبيق `User.Read.All` في Microsoft Graph لتطبيق Living
Security لـ Teams الإقليمي.

يتبع تدفق موافقة المسؤول نمط Microsoft Entra التالي:

```text theme={null}
https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}
```

تنشئ Living Security عنوان URL هذا من معرّف المستأجر المرتبط و**معرّف تطبيق
الروبوت** المعروض في لوحة الإعداد. تخدم المعرّفات أغراضًا مختلفة:

* **معرّف تطبيق Teams** يحدد حزمة التطبيق القابلة للتثبيت في مركز إدارة
  Microsoft Teams.
* **معرّف تطبيق الروبوت** يحدد تطبيق Microsoft Entra الخاص بالروبوت الإقليمي
  وهو معرّف العميل المستخدم في تدفق موافقة المسؤول الاختياري.

لا تستبدل معرّف تطبيق Teams في عنوان URL الخاص بالموافقة. إن تكامل **Microsoft Entra ID
(Client Credentials)** ضمن Connected Integrations هو تكامل عام ومنفصل. ولا يمكن
لروبوت Teams الإقليمي إعادة استخدام بيانات اعتماده أو موافقته، كما أن الموافقة الممنوحة
لتطبيق Entra غير ذي صلة لا تمكّن هذا البحث الاحتياطي.

<Note>
  لا يؤدي جعل الموافقة اختيارية إلى إزالة `User.Read.All` من تسجيلات تطبيق
  Living Security الإقليمية الحالية. يمكن للعملاء الذين منحوا الموافقة بالفعل
  مواصلة استخدام البحث الاحتياطي بالبريد الإلكتروني/UPN دون إعادة ضبط.
</Note>

## أنواع الإشعارات

بحسب استحقاقات مؤسستك وأدلة التشغيل المضبوطة، يمكن لـ Living Security إرسال:

| الإشعار | الوصف |
| - | - |
| إسناد التدريب | إبلاغ المستخدمين عند إسناد التدريب أو حلول موعده أو جاهزيته للإكمال |
| تذكيرات التدريب | تذكير المستخدمين بالمواعيد النهائية القادمة |
| تنبيهات المخاطر البشرية | إرسال تحديثات مخصصة عن مؤشر المخاطر البشرية والخطوات التالية الموصى بها |
| رسائل الإطلاق | إرسال إشعارات أحادية الاتجاه للتهيئة أو الإطلاق أثناء النشر |
| إعلانات القنوات | نشر اتصالات برنامج الأمان في قنوات Teams المضبوطة |

## التخصيص

تستخدم إشعارات Teams إعدادات مؤسسة Living Security الخاصة بك. وتشمل الحقول المدعومة اسم العرض للعميل، وحقول الشعار والعلامة التجارية المدعومة، ونص الرسالة، ودعوات اتخاذ الإجراء، وروابط الوجهة، ونص الإطلاق، ونص الدعم/الاتصال.

يمكن ضبط رسائل التثبيت من **الإعدادات ← الاتصالات ← القنوات ← Microsoft Teams ← Install message controls**. يمكنك تعطيل رسائل التثبيت بالكامل، أو تعطيل الرسائل الشخصية أو رسائل القنوات فقط، وضبط النص الافتراضي أو الخاص بالرسائل الشخصية أو بالقنوات.

يأتي اسم تطبيق Teams وأيقوناته من الحزمة الإقليمية. لتعيين اسمك وأيقوناتك، راجع [إعادة وسم الحزمة الإقليمية](#%D8%A5%D8%B9%D8%A7%D8%AF%D8%A9-%D9%88%D8%B3%D9%85-%D8%A7%D9%84%D8%AD%D8%B2%D9%85%D8%A9-%D8%A7%D9%84%D8%A5%D9%82%D9%84%D9%8A%D9%85%D9%8A%D8%A9).

## تحديث التطبيق أو إزالته

* عندما توفّر Living Security حزمة إقليمية محدّثة، نزّلها من لوحة قناة Microsoft Teams وارفعها عبر مركز إدارة Teams. تحقق من معرّف التطبيق ومعرّف الروبوت والمجموع الاختباري المعروضة قبل الإطلاق.
* لا تبقى تعديلات العلامة التجارية بعد تحديث الحزمة. تحمل كل حزمة إقليمية جديدة اسم تطبيق Living Security وأيقوناته مرة أخرى. أعد تطبيق تعديلاتك باتباع [إعادة وسم الحزمة الإقليمية](#%D8%A5%D8%B9%D8%A7%D8%AF%D8%A9-%D9%88%D8%B3%D9%85-%D8%A7%D9%84%D8%AD%D8%B2%D9%85%D8%A9-%D8%A7%D9%84%D8%A5%D9%82%D9%84%D9%8A%D9%85%D9%8A%D8%A9) قبل رفع الحزمة الجديدة. احتفظ بأيقوناتك وقيمتَي الاسم والإصدار الذي رفعته آخر مرة في مكان يسهل الوصول إليه، بحيث يكون كل ترقية تكرارًا مختصرًا للخطوات نفسها. لا تحمل الحزمة الجديدة دائمًا إصدارًا أعلى من الذي ثبّتّه، لذا عيّن الإصدار بناءً على ما تعرضه Teams بوصفه مثبّتًا.
* أعد تشغيل **Validate install** وأرسل اختبارًا آخر بعد أي تحديث للتطبيق أو السياسة.
* تؤدي إزالة التطبيق أو حظره إلى منع الإشعارات الاستباقية إلى ذلك المستخدم أو القناة. أعد تثبيت التطبيق وأرسل اختبارًا جديدًا لكي تتلقى Living Security حدث تثبيت حديثًا من Teams.
* إذا كنت ستوقف التسليم عبر Teams، فأزل Teams من أدلة التشغيل ذات الصلة قبل إزالة التطبيق من Microsoft Teams.

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

<AccordionGroup>
  <Accordion title="لا يتلقى المستخدم إشعارًا شخصيًا">
    * تأكد من تثبيت تطبيق Living Security الشخصي لـ Teams وأن المستخدم فتحه، حتى يكون لدى Living Security مرجع محادثة حالي
    * تأكد من أن معرّف مستأجر Microsoft المضبوط هو المستأجر الذي يوجد فيه المستخدم
    * إذا أظهرت التشخيصات أنه جرت محاولة البحث الاحتياطي بالبريد الإلكتروني/UPN، فتأكد من منح موافقة المسؤول `User.Read.All` لمعرّف تطبيق الروبوت المعروض للمستأجر الصحيح
    * عند استخدام البحث الاحتياطي بالبريد الإلكتروني/UPN، تحقق من أن بريد المستخدم الإلكتروني أو UPN في Living Security يطابق Microsoft Entra ID
    * اطلب من المستخدم إلغاء حظر التطبيق أو إعادة تثبيته إذا سبق أن أزاله أو حظره
  </Accordion>

  <Accordion title="لا يظهر إعلان القناة">
    <ul>
      <li>
        تأكد من تثبيت تطبيق Living Security لـ Teams في الفريق أو
        القناة المستهدفة.
      </li>

      <li>
        تأكد من أن تعيين القناة في Living Security يستخدم الفريق
        والقناة الصحيحين.
      </li>

      <li>
        تحقق مما إذا كانت القناة قد أُزيلت أو أُعيدت تسميتها أو أُرشفت أو قُيّدت.
      </li>

      <li>
        أعد تثبيت التطبيق في الفريق أو القناة المستهدفة وأرسل إشعار اختبار
        آخر.
      </li>
    </ul>
  </Accordion>

  <Accordion title="يفشل البحث الاختياري بالبريد الإلكتروني/UPN أو الموافقة">
    <ul>
      <li>
        تأكد من أن مسؤول Microsoft Entra منح موافقة على مستوى المستأجر
        لـ Microsoft Graph `User.Read.All` لمعرّف تطبيق الروبوت المعروض.
      </li>

      <li>
        تأكد من أن معرّف المستأجر المضبوط هو المستأجر الذي يوجد فيه المستخدمون
        وTeams.
      </li>

      <li>
        تحقق من وجود المستخدم في Microsoft Entra ID وأنه ليس ضيفًا من
        مستأجر آخر.
      </li>
    </ul>
  </Accordion>

  <Accordion title="يعرض سجل الاتصالات أن موافقة مسؤول Microsoft مطلوبة">
    تعني فئة الخطأ `TEAMS_ADMIN_CONSENT_REQUIRED`، أو خطأ Microsoft `AADSTS7000229`، أن عملية البحث عن مستلم بالبريد الإلكتروني/UPN حاولت استخدام البحث الاحتياطي الاختياري عبر Microsoft Graph، لكن تطبيق Living Security لـ Teams الإقليمي لا يملك كيان خدمة (تطبيق مؤسسة) في مستأجر Microsoft Entra المرتبط. لا يتطلب مسارا المعرّف الموثوق الافتراضي والمحادثة المخزّنة هذه الموافقة. وهذا ليس سرًّا منتهي الصلاحية لدى Living Security.

    1. افتح **الإعدادات ← الاتصالات ← القنوات ← Microsoft Teams**. يمكنك أيضًا استخدام **Open Microsoft Teams setup** من خطأ سجل الاتصالات.
    2. تأكد من ربط معرّف مستأجر Microsoft Entra الصحيح.
    3. إذا كان البحث الاحتياطي بالبريد الإلكتروني/UPN مطلوبًا، فاطلب من مسؤول Microsoft Entra النقر على **Grant optional User.Read.All consent** والموافقة على `User.Read.All` لـ **معرّف تطبيق الروبوت** المعروض. وإلا، فتأكد من أن المستلم فتح التطبيق الشخصي وأن لدى Living Security معرّف كائن Entra الموثوق الخاص به.
    4. بعد أن تنتهي Microsoft من معالجة الموافقة، أرسل اختبار بريد إلكتروني/UPN مستهدفًا متقدمًا من إعداد Microsoft Teams. يعرض سجل الاتصالات سجل التسليم والتشخيصات؛ ولا يعيد تسليم الرسالة التي فشلت.

    لا تؤدي إعادة ضبط **Microsoft Entra ID (Client Credentials)** إلى حل هذا الخطأ لأن ذلك التكامل غير مستخدم في تسليم إشعارات Teams.
  </Accordion>

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

    مثال على حقول حدث التثبيت المستخدمة في استكشاف الأخطاء وإصلاحها:

    ```json theme={null}
    {
      "type": "installationUpdate",
      "action": "add",
      "channelData": {
        "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
        "team": { "id": "19:team-id@thread.tacv2" },
        "channel": { "id": "19:channel-id@thread.tacv2" }
      },
      "conversation": {
        "id": "19:channel-id@thread.tacv2",
        "conversationType": "channel",
        "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## الأمان

تستخدم Living Security `User.Read.All` في Microsoft Graph فقط للبحث الاحتياطي الاختياري عن المستلم بالبريد الإلكتروني/UPN. وبشكل افتراضي، يستخدم توجيه الإشعارات الشخصية معرّف كائن Entra موثوقًا من بيانات الكيانات لدى Living Security ومرجع محادثة الروبوت الذي تم التقاطه من Microsoft Teams. لا تُعد معرّفات الكائنات ومراجع المحادثات التي يوفرها المستدعي بيانات توجيه موثوقة. تُسلَّم رسائل Microsoft Teams عبر روبوت Teams الخاص بـ Living Security المخصص للإشعارات فقط، باستخدام المراسلة الاستباقية في Microsoft Teams.

لا تطلب Living Security من العملاء إنشاء تسجيل تطبيق Microsoft Entra خاص بهم أو مشاركة سر عميل يملكه العميل في إعداد تطبيق Teams القياسي.

تحافظ حزم Teams الخاصة بكل منطقة على اتساق معرّف التطبيق ومعرّف الروبوت ونقطة نهاية المراسلة مع منطقة Living Security التي تتم استضافة مؤسستك فيها.

## ذو صلة

<CardGroup cols={2}>
  <Card title="تكامل البريد الإلكتروني" icon="envelope" href="/ar/integrations/outbound/email">
    اضبط البريد الإلكتروني كقناة تسليم.
  </Card>

  <Card title="تكامل Slack" icon="slack" href="/ar/integrations/outbound/slack">
    اضبط Slack كقناة تسليم.
  </Card>

  <Card title="سجل الاتصالات" icon="clock-rotate-left" href="/ar/features/communications/log">
    تتبّع حالة تسليم Teams وسجله.
  </Card>

  <Card title="المصادقة" icon="shield-halved" href="/ar/features/settings/sso">
    إعداد Microsoft Entra ID وتسجيل الدخول الأحادي.
  </Card>
</CardGroup>


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