المتطلبات الأساسية
قبل إعداد Microsoft Teams، تأكد من توفر ما يلي:- مسؤول Microsoft Teams يمكنه رفع تطبيقات المؤسسة واعتمادها. يجوز أن يشغل الشخص نفسه دورَي المسؤول كليهما.
- مسؤول Microsoft Entra، وذلك فقط إذا أردت تمكين البحث الاحتياطي الاختياري باستخدام البريد الإلكتروني/UPN مع موافقة التطبيق
User.Read.Allعلى مستوى المستأجر - صلاحيات مسؤول Living Security
- مؤسسة Living Security نشطة
- أسماء الفريق والقناة التي ينبغي تسليم الإعلانات الأمنية إليها، إذا كانت إعلانات القنوات مفعّلة
- معرّف مستأجر Microsoft Entra الخاص بك، المتاح ضمن Microsoft Entra admin center ← الهوية ← نظرة عامة
من يقوم بماذا
الإعداد
افتح لوحة إعداد Microsoft Teams
اربط مستأجر Microsoft الخاص بك
نزّل حزمة Teams الإقليمية
ارفع الحزمة وثبّتها في مركز إدارة Teams
- يطابق معرّف تطبيق Teams ومعرّف تطبيق الروبوت القيم المعروضة في Living Security
- اسم التطبيق هو اسم Living Security الإقليمي، أو الاسم الذي عيّنته إذا أعدت وسم الحزمة
- الناشر هو Living Security. لا تغيّر إعادة وسم الحزمة الناشر
- التطبيق غير محظور
- التطبيق متاح للمستخدمين أو المجموعات المستهدفة
- التطبيق مثبّت عبر سياسات إعداد التطبيق أو التثبيت المستهدف للمستخدمين والفرق/القنوات التي ينبغي أن تتلقى الإشعارات
ثبّت التطبيق أو افتحه
اضبط رسائل التثبيت
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{installerName}}، الذي يُستبدل باسم العرض للمستخدم الذي ثبّت التطبيق. اترك الرسالة الشخصية أو رسالة القناة فارغة لاستخدام الرسالة الافتراضية التي ضبطتها. وإذا كانت الرسالة الافتراضية فارغة أيضًا، تستخدم Living Security الرسالة المضمّنة لذلك النطاق.تحقق من الإعداد
أرسل إشعارات اختبار
User.Read.All.إذا لم يتم اكتشاف أي تثبيت شخصي، فاطلب من مستخدم تثبيت
تطبيق Living Security الشخصي أو فتحه، ثم حدد Validate install مرة أخرى، وبعد ذلك
أعد إرسال الاختبار. لا تستخدم اختبار البريد الإلكتروني/UPN المستهدف المتقدم إلا عند
تمكين البحث الاحتياطي الاختياري.إعادة وسم الحزمة الإقليمية
الحزمة الإقليمية هي أرشيف ZIP يتكون من ثلاثة ملفات:manifest.json وcolor.png وoutline.png. يمكنك تعيين اسم التطبيق والأيقونات الخاصة بك في هذه الحزمة قبل رفعها. تدعم Living Security هذا المسار للحزم الإقليمية التي يرفعها مسؤول Teams مباشرة.
نفّذ ذلك بعد تنزيل الحزمة والتحقق منها، وقبل رفعها في مركز إدارة Teams.
فك ضغط الحزمة
manifest.json وcolor.png وoutline.png.استبدل الأيقونات
color.png وoutline.png بأيقوناتك الخاصة. احتفظ باسمَي الملفين
نفسيهما.عيّن اسم تطبيقك
manifest.json، عدّل هذين الحقلين:-
name.short— الاسم المعروض في ترويسة تطبيق Teams وفي المناطق الأخرى محدودة المساحة. الحد الأقصى 30 حرفًا. -
name.full— الاسم المعروض في كتالوج التطبيقات وتفاصيل التطبيق. الحد الأقصى 100 حرف.إذا كان تطبيق 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 الرفع.
اترك حقول الهوية دون تغيير
-
id -
botIdفيbots -
webApplicationInfo -
validDomains -
contentUrlوwebsiteUrlفيstaticTabs
أعد ضغط الملفات الثلاثة
manifest.json فيها داخل مجلد.ارفع الحزمة وتحقق منها
الناشر والمجموع الاختباري
تحدد إعادة الوسم اسم التطبيق والأيقونات. ولا تغيّر أمرين:- يبقى الناشر 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 التالي:
- معرّف تطبيق Teams يحدد حزمة التطبيق القابلة للتثبيت في مركز إدارة Microsoft Teams.
- معرّف تطبيق الروبوت يحدد تطبيق Microsoft Entra الخاص بالروبوت الإقليمي وهو معرّف العميل المستخدم في تدفق موافقة المسؤول الاختياري.
User.Read.All من تسجيلات تطبيق
Living Security الإقليمية الحالية. يمكن للعملاء الذين منحوا الموافقة بالفعل
مواصلة استخدام البحث الاحتياطي بالبريد الإلكتروني/UPN دون إعادة ضبط.أنواع الإشعارات
بحسب استحقاقات مؤسستك وأدلة التشغيل المضبوطة، يمكن لـ Living Security إرسال:التخصيص
تستخدم إشعارات Teams إعدادات مؤسسة Living Security الخاصة بك. وتشمل الحقول المدعومة اسم العرض للعميل، وحقول الشعار والعلامة التجارية المدعومة، ونص الرسالة، ودعوات اتخاذ الإجراء، وروابط الوجهة، ونص الإطلاق، ونص الدعم/الاتصال. يمكن ضبط رسائل التثبيت من الإعدادات ← الاتصالات ← القنوات ← Microsoft Teams ← Install message controls. يمكنك تعطيل رسائل التثبيت بالكامل، أو تعطيل الرسائل الشخصية أو رسائل القنوات فقط، وضبط النص الافتراضي أو الخاص بالرسائل الشخصية أو بالقنوات. يأتي اسم تطبيق Teams وأيقوناته من الحزمة الإقليمية. لتعيين اسمك وأيقوناتك، راجع إعادة وسم الحزمة الإقليمية.تحديث التطبيق أو إزالته
- عندما توفّر Living Security حزمة إقليمية محدّثة، نزّلها من لوحة قناة Microsoft Teams وارفعها عبر مركز إدارة Teams. تحقق من معرّف التطبيق ومعرّف الروبوت والمجموع الاختباري المعروضة قبل الإطلاق.
- لا تبقى تعديلات العلامة التجارية بعد تحديث الحزمة. تحمل كل حزمة إقليمية جديدة اسم تطبيق Living Security وأيقوناته مرة أخرى. أعد تطبيق تعديلاتك باتباع إعادة وسم الحزمة الإقليمية قبل رفع الحزمة الجديدة. احتفظ بأيقوناتك وقيمتَي الاسم والإصدار الذي رفعته آخر مرة في مكان يسهل الوصول إليه، بحيث يكون كل ترقية تكرارًا مختصرًا للخطوات نفسها. لا تحمل الحزمة الجديدة دائمًا إصدارًا أعلى من الذي ثبّتّه، لذا عيّن الإصدار بناءً على ما تعرضه Teams بوصفه مثبّتًا.
- أعد تشغيل Validate install وأرسل اختبارًا آخر بعد أي تحديث للتطبيق أو السياسة.
- تؤدي إزالة التطبيق أو حظره إلى منع الإشعارات الاستباقية إلى ذلك المستخدم أو القناة. أعد تثبيت التطبيق وأرسل اختبارًا جديدًا لكي تتلقى Living Security حدث تثبيت حديثًا من Teams.
- إذا كنت ستوقف التسليم عبر Teams، فأزل Teams من أدلة التشغيل ذات الصلة قبل إزالة التطبيق من Microsoft Teams.
استكشاف الأخطاء وإصلاحها
لا يتلقى المستخدم إشعارًا شخصيًا
لا يتلقى المستخدم إشعارًا شخصيًا
- تأكد من تثبيت تطبيق Living Security الشخصي لـ Teams وأن المستخدم فتحه، حتى يكون لدى Living Security مرجع محادثة حالي
- تأكد من أن معرّف مستأجر Microsoft المضبوط هو المستأجر الذي يوجد فيه المستخدم
- إذا أظهرت التشخيصات أنه جرت محاولة البحث الاحتياطي بالبريد الإلكتروني/UPN، فتأكد من منح موافقة المسؤول
User.Read.Allلمعرّف تطبيق الروبوت المعروض للمستأجر الصحيح - عند استخدام البحث الاحتياطي بالبريد الإلكتروني/UPN، تحقق من أن بريد المستخدم الإلكتروني أو UPN في Living Security يطابق Microsoft Entra ID
- اطلب من المستخدم إلغاء حظر التطبيق أو إعادة تثبيته إذا سبق أن أزاله أو حظره
لا يظهر إعلان القناة
لا يظهر إعلان القناة
- تأكد من تثبيت تطبيق Living Security لـ Teams في الفريق أو القناة المستهدفة.
- تأكد من أن تعيين القناة في Living Security يستخدم الفريق والقناة الصحيحين.
- تحقق مما إذا كانت القناة قد أُزيلت أو أُعيدت تسميتها أو أُرشفت أو قُيّدت.
- أعد تثبيت التطبيق في الفريق أو القناة المستهدفة وأرسل إشعار اختبار آخر.
يفشل البحث الاختياري بالبريد الإلكتروني/UPN أو الموافقة
يفشل البحث الاختياري بالبريد الإلكتروني/UPN أو الموافقة
- تأكد من أن مسؤول Microsoft Entra منح موافقة على مستوى المستأجر
لـ Microsoft Graph
User.Read.Allلمعرّف تطبيق الروبوت المعروض. - تأكد من أن معرّف المستأجر المضبوط هو المستأجر الذي يوجد فيه المستخدمون وTeams.
- تحقق من وجود المستخدم في Microsoft Entra ID وأنه ليس ضيفًا من مستأجر آخر.
يعرض سجل الاتصالات أن موافقة مسؤول Microsoft مطلوبة
يعرض سجل الاتصالات أن موافقة مسؤول Microsoft مطلوبة
TEAMS_ADMIN_CONSENT_REQUIRED، أو خطأ Microsoft AADSTS7000229، أن عملية البحث عن مستلم بالبريد الإلكتروني/UPN حاولت استخدام البحث الاحتياطي الاختياري عبر Microsoft Graph، لكن تطبيق Living Security لـ Teams الإقليمي لا يملك كيان خدمة (تطبيق مؤسسة) في مستأجر Microsoft Entra المرتبط. لا يتطلب مسارا المعرّف الموثوق الافتراضي والمحادثة المخزّنة هذه الموافقة. وهذا ليس سرًّا منتهي الصلاحية لدى Living Security.- افتح الإعدادات ← الاتصالات ← القنوات ← Microsoft Teams. يمكنك أيضًا استخدام Open Microsoft Teams setup من خطأ سجل الاتصالات.
- تأكد من ربط معرّف مستأجر Microsoft Entra الصحيح.
- إذا كان البحث الاحتياطي بالبريد الإلكتروني/UPN مطلوبًا، فاطلب من مسؤول Microsoft Entra النقر على Grant optional User.Read.All consent والموافقة على
User.Read.Allلـ معرّف تطبيق الروبوت المعروض. وإلا، فتأكد من أن المستلم فتح التطبيق الشخصي وأن لدى Living Security معرّف كائن Entra الموثوق الخاص به. - بعد أن تنتهي Microsoft من معالجة الموافقة، أرسل اختبار بريد إلكتروني/UPN مستهدفًا متقدمًا من إعداد Microsoft Teams. يعرض سجل الاتصالات سجل التسليم والتشخيصات؛ ولا يعيد تسليم الرسالة التي فشلت.
التطبيق مثبّت لكن الإشعارات تفشل
التطبيق مثبّت لكن الإشعارات تفشل
- تحقق مما إذا كان الروبوت قد حُظر أو أُزيل أو أُلغي تثبيته
- إذا كان التطبيق قد ثُبّت قبل ربط المستأجر في Living Security، فاحفظ المستأجر وحدد Validate install حتى تتمكن Living Security من ربط التثبيت الحالي
- لا تُعِد التثبيت إلا إذا تعذّر على التحقق اكتشاف التثبيت الحالي
- تأكد من أن المستخدم أو القناة المستهدفة تلقى أحدث حدث لتثبيت التطبيق
- أرسل إشعار اختبار جديدًا بعد إعادة تثبيت التطبيق
الأمان
تستخدم Living SecurityUser.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 التي تتم استضافة مؤسستك فيها.

