الانتقال إلى المحتوى الرئيسي

كيف يعمل

يلتقط موصل GitHub جميع طلبات السحب والمشاكل في مستودع محدد.
  • سيقوم بفهرسة طلبات السحب المفتوحة والمغلقة. هذا يشمل العنوان والملخص.
  • سيقوم بفهرسة المشاكل والتعليقات المفتوحة والمغلقة
  • يتضمن بعض البيانات الوصفية الأخرى مثل عنوان URL والمنشئ وما إلى ذلك.

ميزة مزامنة الأذونات

يدعم موصل GitHub مزامنة الأذونات، مما يضمن أن المستخدمين يمكنهم فقط الوصول إلى المستندات التي لديهم أذونات لعرضها في GitHub. عند التمكين، هذه الميزة:
  • تزامن أذونات المستخدم من مستودعات ومؤسسات GitHub
  • تضمن أن المستخدمين يرون نتائج البحث فقط للمستودعات التي يمكنهم الوصول إليها
  • تحافظ على التحكم في الوصول المتسق بين GitHub و Gorbit
مزامنة الأذونات متاحة فقط على Cloud والإصدار المؤسسي من Gorbit، وتتطلب أذونات رمز إضافية تتجاوز تلك اللازمة للفهرسة الأساسية.

⚠️ متطلب حاسم: الملف الشخصي للبريد الإلكتروني العام

مهم جدًا: لكي تعمل مزامنة الأذونات، يجب أن يكون لدى المستخدمين عنوان بريدهم الإلكتروني مرئيًا علنًا في ملفهم الشخصي على GitHub. إذا تم تعيين بريد مستخدم على خاص، لن يحصلوا على الوصول إلى أي مستندات من خلال Gorbit.
1

تسجيل الدخول إلى GitHub

سجل الدخول إلى حساب GitHub
2

الوصول إلى إعدادات الملف الشخصي

انقر على صورتك الشخصية في الزاوية العلوية اليمنى وحدد Settings من القائمة المنسدلة
3

الانتقال إلى إعدادات البريد الإلكتروني

في الشريط الجانبي الأيسر، انقر على Emails
4

تمكين البريد الإلكتروني العام

انتقل لأسفل إلى Keep my email addresses private و ألغِ تحديد هذا الخيار
5

تكوين الملف الشخصي العام

الآن عد إلى الشريط الجانبي الأيسر وانقر على Public profile
6

تعيين البريد الإلكتروني العام

انتقل لأسفل إلى قسم Public email وحدد عنوان بريدك الإلكتروني من القائمة المنسدلة
7

حفظ التغييرات

انقر على Update profile لحفظ التغييرات
لماذا هذا مطلوب؟ يستخدم Gorbit البريد الإلكتروني العام لمطابقة مستخدمي GitHub مع مستخدمي Gorbit لمزامنة الأذونات. بدون بريد إلكتروني عام، لا يمكن للنظام تحديد أذونات GitHub التي تنطبق على مستخدم Gorbit.

الإعداد

التفويض

يستخدم هذا الموصل رمز وصول GitHub. تعتمد الأذونات المطلوبة على ما إذا كنت تستخدم ميزة مزامنة الأذونات.

الإعداد الأساسي (الفهرسة فقط)

للفهرسة الأساسية بدون مزامنة الأذونات:
1

مراجعة الدليل التفصيلي

هذا الدليل يعرض الخطوات التالية بالتفصيل.
2

تسجيل الدخول إلى GitHub

سجل الدخول إلى GitHub.
3

الوصول إلى الإعدادات

في الزاوية العلوية اليمنى، وسّع ملفك الشخصي وانقر على Settings
4

الانتقال إلى إعدادات المطور

في الأسفل، انتقل إلى Developer settings -> Personal access tokens -> Tokens (classic)
5

توليد رمز جديد

انقر على Generate new token
6

منح الأذونات

امنح الأذونات التالية:
  • أذونات المستودع:
  • repo (التحكم الكامل في المستودعات الخاصة) - للوصول إلى طلبات السحب والمشاكل
إذا كنت تستخدم رمز وصول دقيق بدلاً من رمز كلاسيكي:
1

فتح أذونات المستودع

في صفحة تكوين الرمز، انتقل إلى Repository permissions
2

إضافة الأذونات

انقر على Add permission، ثم أضف ما يلي مع وصول للقراءة:
  • Pull requests - للوصول إلى بيانات طلبات السحب
  • Metadata - للبيانات الوصفية للمستودع
  • Issues - للوصول إلى المشاكل والتعليقات
  • Contents - للوصول إلى محتويات المستودع

إعداد مزامنة الأذونات

اختر نوع الرمز الذي تستخدمه:
1

تحديد المؤسسة (مالك المورد)

عند إنشاء رمز وصول GitHub دقيق لـ مزامنة الأذونات، تأكد من تحديد مؤسسة Resource owner الصحيحة ( المؤسسة على GitHub التي تمتلك المستودعات التي تريد إنشاء الموصل لها). الرموز الدقيقة المحددة لحساب مستخدم شخصي لا تسمح بمنح أذونات المؤسسة (مثل Members)، لذا تتطلب مزامنة الأذونات تحديد مؤسسة كمالك للمورد.
2

إضافة الأذونات المطلوبة

أضف هذه في صفحة تكوين الرمز باستخدام Repository permissions -> Add permission و Organization permissions -> Add permission:أذونات رمز GitHub الدقيق: أذونات المستودع وأذونات المؤسسة
  • أذونات المستودع (وصول للقراءة): Administration، Issues، Metadata، Pull requests
  • أذونات المؤسسة (للقراءة فقط): Administration، Members

تكوين الرمز

1

تعيين وقت انتهاء الصلاحية

عيّن أي وقت انتهاء صلاحية. سيحتاج رمز جديد إلى تقديمه لـ Gorbit لمتابعة تحديث فهرس Gorbit بمجرد انتهاء صلاحية هذا الرمز.
2

التحقق من الأذونات

مهم: إذا كنت تخطط لاستخدام مزامنة الأذونات، تأكد من منح جميع الأذونات أعلاه عند إنشاء الرمز.

الفهرسة

1

الانتقال إلى الموصل

انتقل إلى لوحة الإدارة وحدد موصل GitHub
2

تكوين الموصل

شاشة إدخال بيانات اعتماد موصل GitHub في Gorbit مثال تكوين مستودع موصل GitHub في Gorbit