كيفية استخدام تطبيق GitHub في Google Chat

يمكنك استخدام تطبيق GitHub في Chat لتلقّي إشعارات حول أحداث GitHub، مثل المشاكل وطلبات السحب والتعليقات.

قبل البدء

لاستخدام تطبيق GitHub مع Chat:

• تحتاج إلى إذن من مشرف Google Workspace لتثبيت التطبيقات.
• أضِف التطبيق إلى Chat. كيفية العثور على التطبيقات وإضافتها إلى Chat
• يجب أن يكون لديك حساب على GitHub.
• يجب تثبيت تطبيق Google Chat لمستودع GitHub.

التعرّف على آليات المصادقة في تطبيق GitHub وتطبيق OAuth

توضّح هذه المقالة الخصائص المميزة ونماذج التشغيل لتطبيقات GitHub وتطبيقات OAuth، والتي تعمل كآليات أساسية لتكامل الخدمات الخارجية مع موارد GitHub والوصول إليها. من الضروري فهم هذه الاختلافات بشكل شامل للحفاظ على وضع أمان مثالي داخل المؤسسة.

‫1- التحليل المقارن: الاختلافات الرئيسية

تكمن الاختلافات الأساسية بين النموذجين في الهوية المستخدَمة للوصول (الكيان الأساسي) وآلية إدارة تفويض الوصول إلى الموارد.

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

للحصول على مستندات أكثر شمولاً، يُرجى الرجوع إلى الاختلافات بين تطبيقات GitHub وتطبيقات OAuth.

2- اقتراحات

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

تثبيت تطبيق Google Chat لمستودعات GitHub

إعداد تطبيق GitHub في Chat

1. افتح Chat.
2. استخدِم التطبيق لفتح رسالة مباشرة أو الانتقال إلى مساحة.
3. لفتح نافذة الإعدادات، انقر على تسجيل الدخول.
4. انقر على ضبط الوصول تسجيل الدخول إلى GitHub.
5. أكمِل عملية تسجيل الدخول ثم أغلِق النافذة المنبثقة.
6. لتعديل مربّع حوار Chat، انقر على إعادة تحميل.
7. ضمن إضافة مستودعات، أدخِل مستودع GitHub الذي تريد تلقّي إشعارات بشأنه.
8. ضَع علامة في المربّعات للأحداث التي تريد تلقّي إشعارات بشأنها.
9. انقر على حفظ.

ملاحظة: يجب إعداد الإشعارات في كل مساحة تضيف إليها التطبيق، وسيرسل التطبيق إشعارات إلى جميع المساحات التي هو عضو فيها.

نقل البيانات من تطبيق OAuth (الإصدار القديم) إلى تطبيق GitHub (يُنصح به)

لنقل عملية الربط الحالية من طريقة المصادقة القديمة لتطبيق OAuth إلى طريقة تطبيق GitHub المقترَحة، يُرجى اتّباع الخطوات التالية:

1. افتح Chat.
2. افتح رسالة مباشرة أو مساحة باستخدام تطبيق GitHub.
3. في حقل الرسالة، انقر على "أدوات Google Workspace" .
4. في قائمة الأوامر، اختَر إعادة تفويض GitHub.
5. لإكمال عملية نقل البيانات وإعادة التفويض، يُرجى اتّباع التعليمات الظاهرة على الشاشة في مربّع حوار Chat.

استخدام تطبيق GitHub في المساحات

لاستخدام التطبيق في المساحات، يجب الإشارة باستخدام الرمز@ أو الإشارة باستخدام الشرطة/ إلى التطبيق في كل رسالة وفي الردود على الرسائل الواردة من التطبيق.

تؤكد الإشارة باستخدام الرمز@ أو الإشارة باستخدام الشرطة/ أنّك أرسلت الرسالة إلى التطبيق وليس إلى الآخرين في المساحة.

1. افتح تطبيق Chat .
2. في مساحة، أدخِل ‎@github أو ‎/github متبوعًا بالأمر.
   • عندما تشير إلى @github أو /github، ترسل الرسالة إلى التطبيق وليس إلى الآخرين في المساحة.

تغيير إعدادات التطبيق

في المساحات، لا يمكن لأحد تغيير الإعدادات سوى الشخص الذي أضاف التطبيق.

1. افتح Chat.
2. افتَح رسالة مباشرة باستخدام التطبيق أو انتقِل إلى مساحة باستخدام التطبيق.
3. لفتح الإعدادات الحالية للتطبيق، أدخِل: ‎/github_settings.
4. غيِّر الإعدادات حسب الحاجة.
5. انقر على حفظ.

تؤدي إزالة التطبيق من مساحة إلى حذف إعداداته.

تعرَّف على الأوامر الخاصة بتطبيق GitHub في Chat

في حقل الرسالة ضمن رسالة مباشرة أو مساحة تتضمن تطبيق GitHub في Chat، يمكنك استخدام:

• أوامر تبدأ بشرطة مائلة:
  • ‫‎/github_settings: لفتح مربع حوار الإعدادات
  • ‫‎/github_reminders: لإعداد التذكيرات المجدولة وتعديلها لطلبات السحب المفتوحة الفردية أو الخاصة بالفريق
  • ‫‎/github_subscribe: للاشتراك في GitHub <repoURL>‎ أو <owner/repo>
  • ‫‎/github_openIssue: لفتح مشكلة جديدة على GitHub
  • ‫‎/github_logout: لتسجيل الخروج من حسابك على GitHub
  • ‫‎/github_help: لعرض رسالة المساعدة
  • ‫‎/github_feedback: لإرسال تعليقات حول تطبيق GitHub
• الأوامر السريعة: للوصول إلى الأوامر السريعة، انقر على أدوات Google Workspace .
  • GitHub Connect: يعرض رسالة تتضمّن خيارَي "تسجيل الدخول" و"تسجيل الدخول باستخدام الإصدار القديم".
  • إعادة تفويض GitHub: تتيح لك الانتقال إلى طريقة ربط جديدة.

للحصول على قائمة كاملة بالأوامر المتاحة:

1. افتح Chat على الكمبيوتر.
2. افتح رسالة مباشرة أو انتقِل إلى مساحة تم فيها تثبيت GitHub.
3. أدخِل: ‎/github_help.

تحديد المشاكل في تطبيق GitHub في Chat وحلّها

في حال ظهور رسالة خطأ عند الاشتراك في الإشعارات المرسَلة في الوقت الفعلي

تطبيق GitHub

لإعداد الإشعارات المرسَلة في الوقت الفعلي في المساحات، يُرجى اتّباع الخطوات التالية:

1. في المتصفح، انتقِل إلى إعدادات ملف تعريف GitHub.
2. ضمن "عمليات التكامل" (Integrations)، انقر على التطبيقات (Applications) تطبيقات GitHub المعتمَدة.
   • بعد ربط تطبيق GitHub بـ Google Chat، ستعرض قائمة التطبيقات المعتمدة "Google Chat".
3. تثبيت تطبيق Google Chat لمستودع GitHub
   • أو يمكنك طلب التثبيت من مالك المؤسسة أو المستودع.
4. يُرجى الانتظار إلى أن يكتمل التثبيت.
5. في Google Chat، افتح رسالة مباشرة أو مساحة تتضمّن تطبيق GitHub.
6. في حقل الرسالة، لإنشاء اشتراك، أدخِل: ‎/github_subscribe [organisation/repo] أو ‎/github_settings.

تطبيق OAuth

لإعداد الإشعارات المرسَلة في الوقت الفعلي في المساحات، يجب:

• أن تكون مؤسسة تملك المستودع المقترح
• أن تفوّض تطبيق GitHub في المؤسسة
  1. في المتصفح، انتقِل إلى إعدادات ملف تعريف GitHub.
  2. ضمن "عمليات التكامل" (Integrations)، انقر على التطبيقات (Applications) تطبيقات OAuth المعتمَدة (Authorized OAuth apps).
     • بعد ربط تطبيق GitHub بـ Google Chat، ستعرض قائمة التطبيقات المعتمدة "Google Chat".
  3. امنح التطبيق إذن الوصول إلى المؤسسة التي تريد الوصول إليها.

في حال تلقّي عدد كبير جدًا من الإشعارات من تطبيق GitHub

1. في حقل الرسالة، أدخِل: ‎/github_settings.
2. انقر على إعدادات الإشعارات لتعديل إعدادات إشعارات المستودع.
3. لفلترة الإشعارات، انقر على السهم المتّجه للأسفل بجانب كل نوع من الإشعارات.
   • سيتم عرض الخيارات الإضافية لفلترة الإشعارات.
4. ضَع علامة في المربّع بجانب الإشعارات التي تريدها.
5. انقر على حفظ.

في حال عدم الإشارة إليك باستخدام @ في التذكيرات المجدوَلة

للإشارة إليك في التذكيرات المجدوَلة، يجب ربط حسابك على Google Chat بحساب GitHub.

1. في حقل الرسالة، أدخِل: ‎/github_settings.
2. لربط حسابك:
   1. في النافذة المنبثقة، انقر على ضبط الوصول تسجيل الدخول إلى GitHub.
   2. سجِّل الدخول إلى حسابك على GitHub.
   3. امنح المصادقة للتطبيق.
3. في الرسالة التي تصلك من تطبيق GitHub، اختَر جدولة التذكيرات لفريقك.
4. في النافذة المنبثقة:
   1. انقر على إنشاء تذكير جديد.
   2. اضبط إعدادات التذكير.
   3. انقر على حفظ.

في حال عدم تلقّي تذكيرات باستخدام تطبيق GitHub

في المستودع الذي تريد تلقّي تذكيرات منه، يُرجى التحقُّق من تثبيت تطبيق Google Chat لـ GitHub.

_{Google وGoogle Workspace والعلامات التجارية والشعارات المرتبطة هي علامات تجارية مملوكة لشركة Google LLC. وجميع أسماء الشركات والمنتجات الأخرى هي علامات تجارية مملوكة للشركات ذات الصلة بها.}