قم بربط Gmail أو Microsoft 365 ببريد Nextcloud باستخدام OAuth2

لربط Gmail أو Microsoft 365 بـ Nextcloud Mail باستخدام OAuth2، سجّل تطبيق ويب لدى موفر البريد، وانسخ عنوان URI لإعادة توجيه Nextcloud Mail إلى هذا التسجيل، واحفظ معرّف العميل وكلمة المرور في إعدادات إدارة برامج العمل الجماعي في Nextcloud. ثم اربط صندوق البريد في تطبيق البريد ووافق على طلب تسجيل الدخول من الموفر. يجب أن يقوم الإعداد السليم بتحميل الرسائل الواردة وإرسال رسالة اختبار، وليس مجرد عرض شاشة تأكيد المصادقة.

تأكد من أن حسابك وتثبيت Nextcloud الخاص بك يتوافقان مع هذه الطريقة

يستخدم Nextcloud Mail بروتوكول IMAP لقراءة الرسائل وبروتوكول SMTP لإرسالها. ويحصل OAuth2 على إذن من موفر الهوية؛ وXOAUTH2 هي الآلية التي يستخدمها عميل البريد الإلكتروني لتقديم رمز الوصول إلى خدمات البريد هذه. ولا يحوّل تسجيل الدخول إلى Nextcloud إلى تسجيل دخول موحد لجميع خوادم البريد.

تصف وثائق إدارة Nextcloud الحالية عمليات التكامل المخصصة لـ Gmail OAuth وMicrosoft Outlook XOAUTH2. أُضيفت ميزة دعم Microsoft في Mail 3.0.0؛ وقد تختلف مسميات القوائم باختلاف إصدارات Mail وNextcloud. يستند هذا الدليل الإرشادي إلى دليل إدارة Nextcloud 35 Mail ، وهو مُحدّث حتى أكتوبر 2026.

• استخدم عنوان URL لـ Nextcloud بتقنية HTTPS والذي يفتح بشكل موثوق من المتصفح، مع تثبيت تطبيق البريد الإلكتروني وتفعيله.
• يجب أن يكون لديك صلاحية الوصول إلى مسؤول Nextcloud وإذن لتسجيل تطبيق OAuth في Google Cloud أو Microsoft Entra.
• اعرف ما إذا كان الحساب هو Gmail/Google Workspace أو Outlook.com أو صندوق بريد Microsoft 365 مستضاف في Exchange Online.
• تأكد من أن مزود الخدمة يسمح بالوصول إلى بروتوكول IMAP، وللإرسال، يسمح باستخدام بروتوكول SMTP المصادق عليه وفقًا لسياسات المؤسسة.

ملاحظة هامة: لا تدعم شاشات إعداد Gmail/Microsoft في Nextcloud Mail تلقائيًا موفر IMAP مخصصًا يقبل OAuth2. يوضح طلب ميزة Nextcloud Mail لموفري OAuth2 العامين هذا الفرق. للحصول على موفر آخر، تحقق من إصدار بريدك الإلكتروني وطرق المصادقة المدعومة فيه، بدلًا من إدخال بيانات اعتماد Google أو Microsoft غير ذات الصلة.

قم بتسجيل عميل OAuth باستخدام عنوان URI لإعادة التوجيه الصحيح

جيميل أو مساحة عمل جوجل

1. في Nextcloud، سجّل الدخول كمسؤول، ثم افتح إعدادات الإدارة ← برامج العمل الجماعي ، وابحث عن تكامل Gmail . انسخ عنوان URI لإعادة التوجيه الذي يظهر في حسابك. لا تفترض صحة عنوان URL المنسوخ من تثبيت شخص آخر.
2. افتح وحدة تحكم Google Cloud وحدد مشروعًا أو أنشئ مشروعًا جديدًا. اضبط إعدادات الموافقة/العلامة التجارية والجمهور لمنصة Google Auth بما يتناسب مع مؤسستك في مساحة العمل أو المستخدمين الخارجيين؛ أضف مستخدمين تجريبيين إذا كان التطبيق لا يزال في مرحلة الاختبار.
3. أنشئ عميل OAuth من نوع تطبيق ويب . ضع عنوان URL الكامل من Nextcloud في خانة "معرّفات إعادة التوجيه المعتمدة" ، ثم احفظ معرّف العميل وسر العميل بشكل آمن. يتطلب Google مطابقة حرفية لمعرّف إعادة التوجيه، بما في ذلك المخطط والمسار وحالة الأحرف والشرطة المائلة في النهاية.
4. راجع نطاقات التفويض ومتطلبات النشر. يستخدم Gmail بروتوكولي IMAP وSMTP OAuth للوصول https://mail.google.com/، وهو نطاق واسع ومحدود يخضع لسياسات جوجل المتعلقة ببيانات المستخدم والتحقق منها. يجب على المسؤول تحديد ما إذا كان الاستخدام المقترح يفي بتلك المتطلبات.

توثق جوجل عملية تسجيل خادم الويب في تعليمات تطبيق OAuth2 الخاص بها، بالإضافة إلى نطاق وبروتوكول XOAUTH2 الخاص بـ Gmail . يُعدّ إعداد الاختبار مفيدًا للتحقق الأولي، ولكن عادةً ما يتلقى تطبيق OAuth خارجي مُفعّل في وضع الاختبار رموز تحديث تنتهي صلاحيتها بعد سبعة أيام عند طلب الوصول إلى بريد Gmail. راجع إرشادات جوجل بشأن انتهاء صلاحية الرموز . لذا، قد يشير تكرار إعادة التفويض أسبوعيًا إلى وجود قيود على حالة النشر، وليس إلى وجود خطأ في كلمة مرور IMAP.

مايكروسوفت 365 أو Outlook.com

1. في إعدادات إدارة Nextcloud → برامج العمل الجماعي ، ابحث عن تكامل Microsoft وانسخ عنوان URI لإعادة التوجيه المعروض.
2. في مركز إدارة Microsoft Entra ، انتقل إلى تسجيلات التطبيقات وأنشئ تسجيلًا. بالنسبة لأنواع الحسابات الموضحة في الدليل القياسي لـ Nextcloud، اختر حسابات Microsoft المؤسسية والشخصية؛ استخدم منصة إعادة توجيه الويب وأدخل عنوان URI الخاص بـ Nextcloud بدقة.
3. انسخ مُعرّف التطبيق (العميل) . ضمن قسم "الشهادات والأسرار" ، أنشئ سرًا للعميل وانسخ قيمته فورًا، وليس مُعرّف السر. سجّل تاريخ انتهاء صلاحيته في تقويم العمليات الخاص بك.
4. استخدم صلاحيات التفويض المتعلقة بالبريد الإلكتروني المطلوبة لبروتوكولي IMAP وSMTP OAuth الخاصين بمزود الخدمة، مع الحصول على موافقة المؤسسة عند الاقتضاء. توثق مايكروسوفت نطاقات هذه IMAP.AccessAsUser.Allالصلاحيات، SMTP.Sendبالإضافة إلى offline_accessصلاحيات تحديث الرموز المميزة. لا تخلط بين صلاحيات هذا البروتوكول وصلاحيات Microsoft Graph Mail.Read/Mail.Send.

للحصول على تفاصيل التسجيل، يُرجى مراجعة وثائق تسجيل التطبيقات من مايكروسوفت وتعليمات IMAP/SMTP OAuth الخاصة بـ Exchange Online . يُبقي إعداد Nextcloud العام الموثق حقل المستأجر فارغًا common. يجب استخدام قيمة خاصة بالمستأجر أو جمهور مدعوم أضيق نطاقًا فقط بعد أن يتحقق المسؤول من نوع الحساب المرتبط وتغييرات السياسة.

احفظ بيانات الاعتماد في Nextcloud وقم بتوصيل صندوق البريد

1. ارجع إلى إعدادات الإدارة ← برامج العمل الجماعي . الصق معرّف العميل وكلمة مرور العميل الخاصين بالمزوّد في قسم تكامل Gmail أو تكامل Microsoft المناسب ، ثم احفظ التغييرات. لا تضع كلمة المرور في حقل عنوان URI لإعادة التوجيه، ولا تنشرها في لقطات الشاشة أو التذاكر أو نظام التحكم في الإصدارات.
2. سجّل الدخول كمستخدم صندوق البريد المقصود، وافتح تطبيق البريد ، واختر إضافة حساب بريد. أدخل عنوان البريد الإلكتروني، وحدد خيار إعداد الحساب التلقائي أولًا، ثم ابدأ الاتصال. قد يظهر حقل كلمة المرور في مسار Microsoft الموثق في Nextcloud؛ حيث يتم تجاهل الكلمة الافتراضية عند إعداد OAuth الخاص بالموفر. لا تستخدم كلمة مرور حقيقية للحساب دون داعٍ.
3. في النافذة المنبثقة لمزود الخدمة، حدد هوية جوجل أو مايكروسوفت الصحيحة، وراجع الوصول المطلوب، وامنح الموافقة إذا وافقت مؤسستك. اسمح بظهور النوافذ المنبثقة في المتصفح، ثم عد إلى علامة تبويب Nextcloud الأصلية بعد إعادة توجيهك من قِبل مزود الخدمة.
4. إذا اختار التكوين التلقائي خادمًا خاطئًا، فراجع أسماء مضيفي IMAP وSMTP وخيارات التشفير المُدخلة يدويًا لهذا المزوّد تحديدًا. يرتبط زر OAuth بنقاط نهاية Gmail/Microsoft المُعترف بها؛ وقد لا تُفعّل أسماء المضيفين غير ذات الصلة المُدخلة يدويًا عملية تسجيل الدخول المتوقعة.

في نموذج حساب بريد Nextcloud، يمكن لنقطة نهاية Google المُعترف بها والمُهيأة بـ OAuth أن تُظهر " تسجيل الدخول باستخدام Google" ، بينما يُمكن لنقطة نهاية Microsoft المُكافئة أن تُظهر " تسجيل الدخول باستخدام Microsoft" . يوثّق مصدر نموذج حساب بريد Nextcloud هذه التسميات المشروطة. يُعدّ وجود الزر الخاص بمزود الخدمة مؤشرًا مبكرًا مفيدًا على أن Nextcloud قد تعرف على التكامل المقصود، ولكنه لا يُثبت اكتمال عملية التفويض أو الوصول إلى صندوق البريد.

قم بحل الإخفاقات حسب المرحلة التي تحدث فيها.

توضح مايكروسوفت آلية التحكم في مصادقة SMTP، بما في ذلك إمكانية تجاوز الإعدادات لكل صندوق بريد على حدة، في وثائق مصادقة SMTP الخاصة بـ Exchange Online . تجنب إضعاف أمان البريد الإلكتروني بشكل عام لمجرد تشغيل صندوق بريد واحد؛ إذا كانت السياسة تمنع هذا البروتوكول، فاستخدم برنامج بريد إلكتروني معتمدًا أو آلية عمل مدعومة من المؤسسة بدلاً من ذلك.

تحقق من اتجاهي تدفق البريد

1. افتح صندوق الوارد في Nextcloud Mail، وقم بتحديث الصفحة، وتأكد من ظهور رسالة تم استلامها مؤخرًا مع المرسل والموضوع والمحتوى المتوقع.
2. أرسل بريدًا إلكترونيًا تجريبيًا قصيرًا إلى صندوق بريد آخر تتحكم به. تحقق من وصول البريد إليه، ثم تحقق من مجلد "المرسلة" في Nextcloud Mail. هذا يُساعد في التمييز بين مشاكل أذونات SMTP ومشاكل مزامنة IMAP.
3. قم بتسجيل الخروج ثم تسجيل الدخول مرة أخرى، ثم أعد فتح تطبيق البريد. بالنسبة للتطبيقات التشغيلية، أعد التحقق بعد أن يتم تحديث رمز الوصول عادةً؛ فالنجاح الفوري لا يضمن تجديد الرمز على المدى الطويل.

إذا استمرت مشكلة مزامنة البريد الوارد، توفر Nextcloud وثائق occ mail:account:exportلتحديد مُعرّف حساب البريد الإلكتروني occ mail:account:sync -vvv ACCOUNT_IDولتحديد المشكلة بدقة. كما يشرح دليل استكشاف أخطاء برامج العمل الجماعي تسجيل تصحيح أخطاء IMAP/SMTP لكل حساب، ويحذر من أن السجلات قد تحتوي على معلومات حساسة. لذا، يُنصح بتسجيل المعلومات الضرورية فقط، وإخفاء الرموز المميزة والعناوين قبل المشاركة، وإيقاف تشغيل وضع تصحيح الأخطاء المُفصّل بعد ذلك.

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