برای دریافت اعلانهای مربوط به رویدادهای GitHub (مثل مشکلات، درخواستهای کشش، و نظرات)، از برنامه GitHub در Chat استفاده کنید.
قبلاز شروع
برای استفاده از برنامه GitHub ویژه Chat:
- برای نصب کردن برنامهها، به اجازه سرپرست Google Workspace نیاز دارید.
- افزودن برنامه به Chat. با نحوه پیدا کردن برنامهها و افزودن آنها به Chat آشنا شوید.
- باید حساب GitHub داشته باشید.
- باید برنامه Google Chat را برای مخزن GitHub خود نصب کنید.
این سند ویژگیهای متمایز و مدلهای عملیاتی برنامههای GitHub و برنامههای OAuth را شرح میدهد که بهعنوان سازوکارهای اصلی برای ادغام سرویسهای طرف سوم با منابع GitHub و دسترسی به آنها عمل میکنند. درک جامع این تفاوتها برای حفظ وضعیت امنیتی بهینه در یک سازمان حیاتی است.
۱. تجزیهوتحلیل تطبیقی: تفاوتهای کلیدی
تفاوتهای اساسی بین این ۲ مدل در هویت استفادهشده برای دسترسی (اصلی) و سازوکاری است که مجوز منبع را کنترل میکند.
|
مشخصه |
برنامه GitHub (ورود به سیستم توصیهشده) |
برنامه OAuth (ورود به سیستم قدیمی) |
|
هویت اصلی |
بسته به مورد استفاده، بهعنوان یک هویت برنامه مستقل، جدا از هر کاربر، یا به نمایندگی از کاربر مجوزدهنده عمل میکند. |
ازطرف کاربر مجوزدهنده عمل میکند و امتیازهای او را به ارث میبرد. |
|
مدل مجوز |
اجازههای دقیق (توصیهشده): از اصل کمترین امتیاز استفاده میکند و امکان دسترسی به مخزنهای خاص و انواع منابع را فراهم میکند. برای مثال: دسترسی خواندن فقط برای فراداده. |
حوزههای گسترده: دسترسی با حوزههای گستردهای مانند اعطای دسترسی به همه منابع رؤیتپذیر برای کاربر مجاز تعریف میشود. |
|
ماندگاری اعتبارنامه |
کدهای کوتاهمدت: رمزهای دسترسی دارای طول عمر محدودی هستند (معمولاً ۱ ساعت) و نیاز به تمدید مکرر دارند، که درصورت بهخطر افتادن، خطر را بهطور قابلتوجهی کاهش میدهد. |
کدهای طولانیمدت: کدهای دسترسی تا زمانیکه کاربر آنها را بهصورت دستی باطل کند باقی میمانند و خطر قرار گرفتن طولانیمدت درمعرض آنها را نشان میدهند. |
|
شرایط لازم برای نصب |
باید توسط «سرپرست» یا مالک «سازمان» نصب شود و پیوند رسمی با حساب یا سازمان برقرار کند و کاربر برای موارد استفادهای که برنامه ازطرف کاربر عمل میکند آن را مجاز کند. |
باید توسط کاربر فردی مجاز شود و دسترسی مستقیماً به هویت آن کاربر پیوند داده شود. |
برای اسناد جامعتر، به تفاوتهای بین برنامههای GitHub و برنامههای OAuth مراجعه کنید.
۲. توصیه
براساس روالهای مطلوب امنیتی، سازوکار اصالتسنجی «برنامه GitHub» برای همه یکپارچهسازیهای سازمانی و طرف سوم توصیه میشود. این مدل اصل حداقلسازی امتیاز را اعمال میکند و از اعتبارنامههای قوی و با محدودیت زمانی استفاده میکند، بنابراین در مقایسه با مدل اختیار واگذارشده «برنامههای OAuth»، استاندارد بالاتری از امنیت و پایداری عملیاتی را حفظ میکند.
راهاندازی برنامه GitHub در Chat
- برنامه Chat
را باز کنید.
- پیام مستقیمی را با برنامه باز کنید یا به فضایی که برنامه در آن است بروید.
- برای باز کردن پنجره پیکربندی، روی ورود به سیستم تکضرب بزنید.
- روی پیکربندی دسترسی
ورود به سیستم GitHub تکضرب بزنید.
- فرایند ورود به سیستم را تکمیل کنید، سپس بالاپر را ببندید.
- برای بهروزرسانی کادر گفتگوی Chat، روی بازآوری تکضرب بزنید.
- در بخش افزودن مخزنها، مخزنی از GitHub را که میخواهید برای آن اعلان دریافت کنید تایپ کنید.
- چارگوش رویدادهایی را که میخواهید برای آنها اعلان دریافت کنید علامت بزنید.
- روی ذخیره تکضرب بزنید.
انتقال از برنامه OAuth («قدیمی») به برنامه GitHub («توصیهشده»)
برای انتقال اتصال فعلی خود از روش قدیمیتر اصالتسنجی برنامه OAuth به روش توصیهشده برنامه GitHub:
- برنامه Chat
- پیام مستقیم یا فضایی را با برنامه GitHub باز کنید.
- در فیلد پیام، روی «ابزارهای Google Workspace»
تکضرب بزنید.
- در فهرست فرمان، مجوزدهی مجدد GitHub را انتخاب کنید.
- برای تکمیل کردن فرایند انتقال و مجوزدهی مجدد، دستورالعملهای روی صفحه را در کادر گفتگوی Chat را دنبال کنید.
تکضرب بزنید.استفاده از برنامه GitHub در فضاها
برای استفاده از برنامه در فضاها، باید در همه پیامهای ارسالشده به برنامه و همچنین هنگام پاسخ دادن به پیامهای برنامه، باید از آن برنامه @نامبری یا /نامبری کنید.
@نامبری یا /نامبری تأیید میکند که پیام را به برنامه ارسال کردهاید نه به افراد دیگری در فضا.
- برنامه Chat
- در فضا، @github یا /github و سپس دستور را وارد کنید.
- وقتی از github@ یا /github نام میبرید، پیام به برنامه ارسال میشود و نه به سایر افراد در فضا.
تغییر تنظیمات برنامه
در فضاها، فقط فردی که برنامه را اضافه کرده است میتواند تنظیمات را تغییر دهد.
- برنامه Chat
- پیام مستقیمی را با برنامه باز کنید یا به فضایی که برنامه در آن است بروید.
- برای باز کردن تنظیمات فعلی برنامه،
/github_settingsرا وارد کنید. - درصورت نیاز تنظیمات را تغییر دهید.
- روی ذخیره تکضرب بزنید.
اگر برنامه را از فضا بردارید، تنظیمات برنامه حذف میشود.
با فرمانهای برنامه 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: پیامی با گزینه «ورود به سیستم» و «ورود به سیستم قدیمی» نمایش میدهد.
- مجوزدهی مجدد GitHub: امکان میدهد به روش اتصال جدیدی انتقال دهید.
برای دریافت فهرست کامل فرمانهای پشتیبانیشده:
- در iPhone یا iPad، برنامه Chat
- پیامی مستقیم را باز کنید یا به فضایی بروید که برنامه GitHub نصب شده باشد.
-
/github_helpرا وارد کنید.
عیبیابی کردن مشکلات برنامه GitHub در Chat
اگر هنگام مشترک شدن در اعلانهای درلحظه با خطا مواجه شدیدبرنامه GitHub
برای راهاندازی کردن اعلانهای درلحظه در فضاها:
- در مرورگر، به تنظیمات نمایه GitHub بروید.
- در بخش «ادغامها»، روی برنامهها
برنامههای مجاز GitHub تکضرب بزنید.
- بعداز اینکه به برنامه GitHub در Google Chat متصل شدید، فهرست برنامههای مجاز «Google Chat» شما را نمایش خواهد داد.
- «برنامه Google Chat» را برای مخزن GitHub نصب کنید.
- یا میتوانید از مالک سازمان/ مخزن درخواست نصب کنید.
- منتظر بمانید تا نصب کامل شود.
- در Google Chat، پیام مستقیم یا فضایی را با برنامه GitHub باز کنید.
- در فیلد پیام، برای ایجاد کردن اشتراک،
/github_subscribe [organisation/repo]یا/github_settingsرا وارد کنید.
برنامههای مجاز GitHub تکضرب بزنید.
برنامه OAuth
برای راهاندازی اعلانهای درلحظه در فضاها، باید:
- مالک سازمان مخزن پیشنهادی باشید.
- برنامه را در سازمان GitHub مجاز کنید.
- در مرورگر، به تنظیمات نمایه GitHub بروید.
- در بخش «ادغامها»، روی برنامهها
- بعداز اینکه به برنامه GitHub در Google Chat متصل شدید، فهرست برنامههای مجاز «Google Chat» شما را نمایش خواهد داد.
- به برنامه اجازه دهید به سازمانی که میخواهید دسترسی داشته باشد، دسترسی پیدا کند.
- در فیلد پیام،
/github_settingsرا وارد کنید. - برای ویرایش تنظیمات اعلانهای مخزن، روی تنظیمات اعلان ضربه بزنید.
- برای فیلتر کردن اعلانها، در کنار انواع اعلانها، روی پیکان روبه پایین
ضربه بزنید.
- این تنظیم گزینههای اضافی را برای فیلتر کردن اعلان نمایش میدهد.
- کادرهای مربوط به اعلانهای موردنظرتان را علامت بزنید.
- روی ذخیره تکضرب بزنید.
برای اینکه در یادآوریهای زمانبندیشده از شما نام برده شود، باید حساب Google Chat خود را به حساب GitHub متصل کرده باشید.
- در فیلد پیام،
/github_settingsرا وارد کنید. - برای متصل کردن حسابتان:
- در بالاپر، روی پیکربندی دسترسی
- به سیستم حساب GitHub خود وارد شوید.
- برنامه را مجاز کنید.
- در بالاپر، روی پیکربندی دسترسی
- در پیامهایی که از برنامه GitHub دریافت میکنید، زمانبندی یادآورها برای تیمتان را انتخاب کنید.
- در بالاپر:
- روی ایجاد یادآور جدید ضربه بزنید.
- تنظیمات یادآور را پیکربندی کنید.
- روی ذخیره تکضرب بزنید.
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.