إعداد Microsoft Graph API لإرسال البريد الإلكتروني

يوضح هذا الدليل كيفية منح موافقة المسؤول في مؤسستك لتطبيقنا متعدد المستأجرين لإرسال البريد الإلكتروني، وتقييد وصوله بحيث لا يتمكن إلا من إرسال رسائل البريد الإلكتروني من صندوق بريد مخصص (على سبيل المثال، noreply@yourdomain.com). حتى إذا كانت خبرتك في مجال تكنولوجيا المعلومات محدودة، ستساعدك التعليمات خطوة بخطوة والمتطلبات الأساسية الواردة هنا على إكمال الإعداد باستخدام الأدوات المثبتة على جهاز الكمبيوتر الخاص بك.

ملاحظة:
إذا كنت بحاجة إلى المساعدة، يرجى إنشاء تذكرة دعم على eniris.io/support.

جدول المحتويات

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

نظرة عامة

يستخدم تطبيقنا لإرسال البريد الإلكتروني Microsoft Graph API مع أذونات التطبيق لإرسال رسائل البريد الإلكتروني من صندوق بريد مخصص. لتمكين هذه الوظيفة، يجب على المسؤول لديك القيام بما يلي:

1. منح موافقة على مستوى المستأجر للتطبيق.
2. تزويدنا باسم المجال الخاص بك، ومعرّف المستأجر، وعنوان البريد الإلكتروني الذي تريد استخدامه (مثل noreply@yourdomain.com).

يمكن العثور على هذه التفاصيل في نظرة عامة على المستأجر ضمن Microsoft Entra.

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

قبل البدء، يرجى التأكد من توفر ما يلي لديك:

• بيانات اعتماد المسؤول: يجب أن تتمتع بحقوق المسؤول العام للمستأجر الخاص بك في Microsoft 365.
• الوصول إلى Microsoft Entra: ستحتاج إلى عرض تفاصيل المستأجر الخاص بك في Microsoft Entra.
• PowerShell على جهاز الكمبيوتر الخاص بك:
  • Windows PowerShell أو PowerShell Core.
  • ثبّت وحدة ExchangeOnlineManagement عن طريق تشغيل:

    Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser

• المعرفة الأساسية: الإلمام بنسخ الأوامر ولصقها في PowerShell. لا تقلق إذا كنت مبتدئًا—فالخطوات أدناه مفصلة وواضحة.

الخطوة 1: منح موافقة المسؤول

1. إنشاء عنوان URL لموافقة المسؤول:
   استخدم تنسيق عنوان URL التالي. استبدل <YOUR-DOMAIN-NAME> باسم المجال الفعلي الخاص بك (على سبيل المثال، إذا كان مجالك هو "contoso.com"، فاستخدمه):

   https://login.microsoftonline.com/<YOUR-DOMAIN-NAME>/adminconsent?client_id=03126c25-5828-4b2e-aa6d-d97380cb1cb5&redirect_uri=https://eniris.io

2. زيارة عنوان URL:
   اطلب من المسؤول العام لـ Microsoft 365 تسجيل الدخول إلى المتصفح والانتقال إلى عنوان URL. سيظهر له مربع حوار للموافقة يسرد الأذونات التي يطلبها تطبيقنا (مثل Mail.Send).

3. منح الموافقة:
   يجب على المسؤول النقر على "قبول" لمنح الموافقة. سيؤدي هذا الإجراء إلى إنشاء كيان خدمة لتطبيقنا في المستأجر الخاص بك والسماح له بإرسال رسائل البريد الإلكتروني.

4. إخطارنا:
   بعد منح الموافقة، يرجى إنشاء تذكرة على eniris.io/support تتضمن التفاصيل التالية:

• اسم المجال الخاص بك.
• معرّف المستأجر الخاص بك (الموجود في نظرة عامة على مستأجر Microsoft Entra).
• عنوان البريد الإلكتروني الذي ترغب في استخدامه لإرسال رسائل البريد (مثل noreply@yourdomain.com).

الخطوة 2: الحصول على تفاصيل المستأجر

ستحصل عملية الإعداد لدينا على معرّف المستأجر تلقائيًا عند منح المسؤول الموافقة. ومع ذلك، إذا كنت بحاجة إلى التحقق منه يدويًا، يمكنك القيام بما يلي:

• سجّل الدخول إلى Microsoft Entra.
• انسخ معرّف المستأجر من صفحة نظرة عامة على المستأجر.

الخطوة 3: تكوين قيود الوصول

وفقًا لأفضل ممارسات الأمان، سننشئ مجموعة أمان مخصصة ونستخدمها لتقييد وصول التطبيق إلى صندوق البريد المخصص لك فقط. يطبق هذا مبدأ أقل قدر من الامتيازات، مما يضمن عدم تمكن التطبيق من الوصول إلا إلى ما هو ضروري تمامًا.

إنشاء مجموعة أمان البريد المطلوبة

1. تسجيل الدخول إلى مركز إدارة Microsoft 365:
   انتقل إلى admin.microsoft.com وسجّل الدخول باستخدام حساب المسؤول الخاص بك.

2. إنشاء مجموعة أمان:

• انتقل إلى "المجموعات" > "المجموعات النشطة"
• انقر على "إضافة مجموعة"
• حدّد "الأمان" كنوع المجموعة وانقر على "التالي"
• أدخل اسمًا (مثل "Noreply Access Only") ووصفًا
• أضف حساب noreply@yourdomain.com كعضو
• انقر على "التالي" ثم "إنشاء مجموعة"

تطبيق قيود الوصول

1. فتح PowerShell:
   شغّل PowerShell كمسؤول على جهاز الكمبيوتر الخاص بك.

2. الاتصال بـ Exchange Online:
   ثبّت وحدة ExchangeOnlineManagement (إذا لم تكن مثبتة بالفعل)، ثم اتصل:

   Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
   Connect-ExchangeOnline -UserPrincipalName "<YOUR-ADMIN-EMAIL>"  # For example: admin@yourdomain.com

3. إنشاء نهج وصول التطبيق:
   شغّل الأمر التالي. استبدل <YOUR-SECURITY-GROUP-EMAIL> بعنوان البريد الإلكتروني الفعلي أو معرّف الكائن لمجموعة الأمان الخاصة بك:

   New-ApplicationAccessPolicy -AccessRight RestrictAccess -AppId "03126c25-5828-4b2e-aa6d-d97380cb1cb5" -PolicyScopeGroupId "<YOUR-SECURITY-GROUP-EMAIL>" -Description "Restrict app access to the noreply mailbox only"

4. التحقق من النهج:
   اختبر عمل النهج عن طريق تشغيل (استبدل بعنوان بريد noreply الإلكتروني الفعلي الخاص بك):

   Test-ApplicationAccessPolicy -Identity "<YOUR-NOREPLY-EMAIL>" -AppId "03126c25-5828-4b2e-aa6d-d97380cb1cb5"

اعتبارات الأمان

• عزل البيانات: يضمن كيان الخدمة الذي تم إنشاؤه في المستأجر الخاص بك ألا يتمكن التطبيق من الوصول إلا وفقًا لما يسمح به النهج.
• أقل قدر من الامتيازات: يطلب التطبيق إذن Mail.Send فقط، كما يتم تقييده بشكل إضافي ليقتصر على صندوق بريد واحد.
• التدقيق: نوصي بإجراء مراجعات دورية لكيان الخدمة ونهج وصول التطبيق.

معلومات وموارد إضافية

المشكلات الشائعة:

أخطاء الموافقة:

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

أخطاء PowerShell:

• تحقّق من تثبيت وحدة ExchangeOnlineManagement وتحديثها إلى أحدث إصدار
• تحقّق من امتلاك بيانات اعتماد المسؤول لديك للأذونات الكافية

التحقق من النهج:

• استخدم Test-ApplicationAccessPolicy للتحقق من قيود الوصول
• راجع وثائق نهج وصول التطبيق