إعداد تسجيل الدخول عبر GitHub لـ Discourse

[Discourse]

يشرح هذا الدليل كيفية إعداد GitHub كخيار تسجيل دخول لمنتدى Discourse الخاص بك عن طريق تكوين بيانات اعتماد OAuth.

مستوى المستخدم المطلوب: مسؤول

نظرة عامة

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

إعداد GitHub OAuth

1. تفضل بزيارة إعدادات المطورين على GitHub على https://github.com/settings/developers

2. في القائمة اليسرى، حدد موقع تطبيقات OAuth (OAuth Apps) وانقر عليها.

3. انقر على تطبيق OAuth جديد (New OAuth App)

4. املأ الحقول المطلوبة:

   • اسم التطبيق (Application name): أدخل اسم موقعك
   • عنوان URL للصفحة الرئيسية (Homepage URL): عنوان URL الرئيسي لموقعك (على سبيل المثال، https://discourse.example.com)
   • وصف التطبيق (Application description) (اختياري): صف موقعك باختصار
   • عنوان URL لإعادة توجيه التفويض (Authorization callback URL): استخدم نطاق موقعك مع المسار /auth/github/callback
     (على سبيل المثال، https://discourse.example.com/auth/github/callback)

5. انقر على تسجيل التطبيق (Register application)

تكوين إعدادات Discourse

1. بعد التسجيل، سيعرض GitHub معرّف العميل (Client ID) الخاص بك على صفحة إعدادات التطبيق.

2. للحصول على سر العميل (Client Secret)، انقر على إنشاء سر عميل جديد (Generate a new client secret). انسخه فورًا - سيتم عرضه مرة واحدة فقط.

3. في إعدادات المسؤول في Discourse لديك، قم بتكوين ما يلي:

   • اضبط github_client_id على معرّف العميل الخاص بك
   • اضبط github_client_secret على سر العميل الخاص بك
   • قم بتمكين الإعداد enable github logins

اختبار التكامل

1. قم بتسجيل الخروج من موقع Discourse الخاص بك
2. يجب أن ترى الآن خيار تسجيل الدخول “باستخدام GitHub” (with GitHub) على صفحة تسجيل الدخول
3. اختبر تدفق تسجيل الدخول للتأكد من أنه يعمل كما هو متوقع

أفضل الممارسات

• حافظ على سر العميل (Client Secret) الخاص بك آمنًا ولا تشاركه علنًا أبدًا
• راجع إعدادات تطبيق OAuth الخاص بك على GitHub بانتظام
• فكر في تمكين ميزات أمان إضافية في إعدادات تطبيق OAuth على GitHub

المشاكل والحلول الشائعة

• إذا فشل تسجيل الدخول، تحقق من أن عنوان URL لإعادة التوجيه يطابق تمامًا ما تم تكوينه في GitHub
• تأكد من أن شهادة SSL الخاصة بموقعك صالحة، حيث يتطلب GitHub بروتوكول HTTPS
• تحقق من إدخال كل من معرّف العميل والسر بشكل صحيح في إعدادات Discourse

موارد إضافية

• Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso)
• Creating an OAuth app - GitHub Docs