تكوين تطبيق البريد الإلكتروني للاتصال عبر WebEx باستخدام مصادقة Office365

المقدمة

يصف هذا المستند خطوات تكوين تطبيق بريد إلكتروني ل Office365 باستخدام التفويض المفتوح (OAuth 2.0).

ساهم في هذا العمل أندريوس سوشانكا وبهوشان سوريش، مهندس مركز المساعدة الفنية التابع لشركة Cisco.

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

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• مركز اتصال Webex (WxCC) 2.0
• Webex ConnectPortal مع تكوين تدفقات البريد الإلكتروني 
• وصول MS Azure
• وصول MS Office365

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج التالية:

• WxCC 2.0
• حل إتصالات الصوت عبر السحابة بنظام WebEx من Cisco
• Microsoft Azure
• Microsoft Office365

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

التكوين

الخطوة 1: بدء تكوين تطبيق البريد الإلكتروني على اتصال WebEx

بدء تكوين تطبيق البريد الإلكتروني على النظام الأساسي ل WebEx Connect. 

-تسجيل الدخول إلى مستأجر Webex Connect؛

-انتقل إلى 'Asset-Apps'، ثم انقر فوق 'تكوين تطبيق جديد' ثم حدد 'Email'. حدد 'OAuth 2.0' لنوع المصادقة، ونسخ 'عنوان إعادة التوجيه' و'إستدعاء URL مرة أخرى' وتخزينه لخطوات التكوين اللاحقة:

قم بالمتابعة إلى التكوين على جانب Microsoft.

الخطوة 2: إنشاء تطبيق في Microsoft Azure

قم بتسجيل تطبيق في مدخل Azure وفقا لمستند 'تسجيل تطبيق مع نظام تعريف Microsoft الأساسي'.

-تسجيل الدخول إلى https://portal.azure.com؛

-انتقل إلى 'Azure Active Directory'، وحدد 'تسجيلات التطبيقات' وانقر فوق 'تسجيل جديد'؛

-توفير اسم التطبيق وتحديد نوع الحساب المناسب وإدخال موقع ويب 'URI إعادة توجيه' باسم المستأجر الخاص بك (الذي يظهر على https://yourwebexconnectname.us.webexconnect.io/callback as في الخطوة 1) وتسجيل التطبيق:

-بعد تسجيل التطبيق - انتقل إلى "المصادقة"، وانتقل لأسفل إلى "التدفقات الكبيرة والهجين الضمنية"، وحدد الخيار "رموز الوصول المميزة" وقم بالحفظ:

-انتقل إلى "الشهادات والأسرار"، حدد "أسرار العميل"، وانقر فوق "سر عميل جديد"، وقم بإضافة وصف وطول صلاحية:

-نسخ قيمة سر العميل وتخزينها للاستخدام لاحقا:

-انتقل إلى 'أذونات واجهة برمجة التطبيقات'، وانقر فوق 'إضافة إذن'، ثم حدد 'APIs التي تستخدمها مؤسستي'، في إدخال حقل البحث 'Office 365' وحدد 'Office 365 Exchange Online'. حدد 'أذونات التطبيق'، وقم بتوسيع المقطع 'Mail'، ثم تحقق من 'Mail.Send' وانقر فوق 'إضافة إذن':

-بعد إضافة الإذن المذكور، يجب منح موافقة المسؤول. انقر على "منح موافقة المسؤول":

-انتقل إلى "نظرة عامة" ولاحظ "معرف التطبيق (العميل)" و"معرف الدليل (المستأجر)" لأسفل لمزيد من إستخدام التكوين:

ملاحظة: تأكد من السماح بموافقة المستخدم للتطبيقات في Azure تحت "الموافقة والأذونات" ل "تطبيقات المؤسسة" (هذه إعدادات افتراضية):

الخطوة 3: تكوين مستخدم علبة البريد على Office365

-تسجيل الدخول إلى https://admin.microsoft.com؛

-انتقل إلى المستخدمين->المستخدمون النشطون؛

-تحديد مستخدم ذي علبة بريد للتكامل مع اتصال Webex؛

-بعد تحديد انتقال مستخدم محدد إلى "بريد"، ضمن "تطبيقات البريد الإلكتروني" انقر فوق "إدارة تطبيقات البريد الإلكتروني"، تأكد من تحديد "SMTP المصادق عليه" وانقر فوق "حفظ التغييرات":

-تحت "إعادة توجيه البريد الإلكتروني" انقر فوق "إدارة إعادة توجيه البريد الإلكتروني"، حدد "إعادة توجيه جميع رسائل البريد الإلكتروني المرسلة إلى علبة البريد هذه"، وقم بملء "عنوان البريد الإلكتروني لإعادة التوجيه" باسم مستعار من تكوين تطبيق اتصال WebEx كما هو موضح في الخطوة 1 (بالإضافة إلى ذلك، إذا لزم الأمر، حدد "الاحتفاظ بنسخة من البريد الإلكتروني المعاد توجيهه في علبة البريد هذه") وانقر فوق "حفظ التغييرات":

-تأكد من السماح بإعادة توجيه البريد الإلكتروني الصادر إلى عناوين البريد الإلكتروني الخارجية في مدخل Microsoft 365 Defender لديك.

-إذا لم يكن كذلك - قم بإنشاء سياسات مكافحة البريد العشوائي الموجودة أو تعديلها وفقا لمستندات Microsoft:

تكوين تصفية البريد العشوائي الصادر - Office 365

ملاحظة: إذا كان هناك خطأ يتعلق ب "تمكين-OrganizationCustomization" يتم إظهاره أثناء محاولة حفظ سياسات مكافحة البريد العشوائي مع تعيين إعادة التوجيه إلى "تشغيل"، الرجاء تشغيل cmdlet "تمكين-OrganizationCustomization" كما هو موضح في مقالة Microsoft - Enable-OrganizationCustomization (يمكن أن يستغرق ذلك ما يصل إلى 24 ساعة حتى يصبح التغيير المذكور في cmdlet ساري المفعول).

ملاحظة 2: من أجل الاتصال ب Exchange Online PowerShell، يرجى البحث في المقالة - الاتصال ب Exchange Online PowerShell

الخطوة 4: تكوين تطبيق البريد الإلكتروني على اتصال Webex

قم بالتبديل مرة أخرى إلى تكوين تطبيق البريد الإلكتروني لاتصال Webex وقم بتعبئة الحقول المطلوبة.

-بالنسبة "لمعرف البريد الإلكتروني"، أستخدم علبة البريد التي تم تكوينها لإعادة توجيه البريد الإلكتروني عبر البريد الإلكتروني باتجاه WebEx Connect بالفعل في الخطوة 3.

-إستخدام إعدادات تكوين SMTP:

SMTP Server: smtp.office365.com
Port: 587
Security: STARTTLS

-ل 'username' أستخدم نفس المستخدم كما تم تكوينه في الخطوة 3؛

-بالنسبة إلى 'معرف العميل'، أستخدم 'معرف التطبيق (العميل) المحفوظ' كما هو موضح في الخطوة 2؛

-بالنسبة ل "سر العميل"، تم حفظ "سر العميل" كما هو موضح في الخطوة 2:

-أستخدم 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/authorize' ل 'URL للتخويل'؛

-إستخدام 'offline_access https://outlook.office.com/SMTP.Send' for 'scope'؛

-ل 'Access Token URL' و'Refresh Token URL' أستخدم 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/token':

-انقر فوق "إنشاء رمز مميز"، تأكد من إستخدام نفس المستخدم كما تم تكوينه في حقل "اسم المستخدم" - يتم ملء الحقول "رمز الوصول المميز" و"رمز التحديث" و"الصحة":

-انقر فوق 'حفظ' ثم فوق 'تسجيل إلى Webex Engagement':

التحقق من الصحة

تحقق من خلال إرسال بريد إلكتروني إلى علبة بريد Office 365. إذا تم تقديم هذا البريد الإلكتروني إلى وكيل WebEx Contact Center وتم تلقي رد من وكيل WebEx Contact Center من قبل المرسل الأصلي - يكون التكوين ناجحا.

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

إذا استمر فشل تدفق البيانات، فأدخل إلى وحدة تحكم تصحيح الأخطاء على صفحة مدخل WebEx Connect وابحث باستخدام قناة البريد الإلكتروني وطابع الوقت 

يحتوي هذا القسم على الرسالة الواردة والرسالة الصادرة مع الحالة

حدد معرف الرسالة لجمع المزيد من التفاصيل حول الفشل 

بمجرد تحديد معرف الرسالة، سيقوم قسم الأخطاء والتحذيرات بعرض مزيد من تفاصيل الخطأ

إذا كان هناك حاجة إلى تشفير Cisco TAC، يرجى تجميع المعلومات: 

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