איך משתמשים באפליקציית GitHub ב-Google Chat

אתם יכולים להשתמש באפליקציה של GitHub ב-Google 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. לוחצים על Sign in (כניסה) כדי לפתוח את חלון ההגדרות.
4. לוחצים על Configure Access (הגדרת הגישה) Sign in to GitHub (כניסה ל-GitHub).
5. משלימים את תהליך הכניסה וסוגרים את החלון הקופץ.
6. לוחצים על Refresh (רענון) כדי לרענן את תיבת הדו-שיח ב-Chat.
7. בשדה Add Repositories (הוספת מאגרים), כותבים את שמות המאגרים ב-GitHub שרוצים לקבל עליהם התראות.
8. מסמנים את התיבות של סוגי האירועים שרוצים לקבל עליהם התראות.
9. לוחצים על Save (שמירה).

כדאי לדעת: אתם צריכים להגדיר את התראות בכל מרחב שצירפתם אליו את האפליקציה. האפליקציה שולחת את ההתראות בכל המרחבים שאליהם היא צורפה.

איך עוברים מאפליקציית OAuth (השיטה הקודמת) ל-GitHub (השיטה המומלצת)

כדי להעביר את החיבור הקיים משיטת האימות הקודמת דרך אפליקציית OAuth לשיטה המומלצת דרך אפליקציית GitHub:

1. פותחים את Chat.
2. פותחים צ'אט ישיר או מרחב עם אפליקציית GitHub.
3. בשדה ההודעה, לוחצים על סמל הכלים של Google Workspace .
4. ברשימת הפקודות, לוחצים על GitHub Reauthorize (הרשאה מחדש של GitHub).
5. כדי להשלים את תהליך ההעברה וההרשאה מחדש, פועלים לפי ההוראות במסך בתיבת הדו-שיח ב-Chat.

איך משתמשים באפליקציית GitHub במרחבים

כדי להשתמש באפליקציה במרחבים, אתם צריכים לתייג אותה באמצעות @ או / בכל הודעה שאתם רוצים לשלוח אליה (כולל בתשובות להודעות שלה).

התיוג באמצעות @ או / בעצם מאשר שאתם רוצים לשלוח את ההודעה לאפליקציה ולא לשאר האנשים במרחב.

1. פותחים את אפליקציית Chat .
2. במרחב, כותבים ‎@github או ‎/github ואז את הפקודה.
   • כשמתייגים את אפליקציית GitGub באמצעות @ או /, ההודעה נשלחת אליה ולא לשאר האנשים במרחב.

איך משנים את ההגדרות של האפליקציה

במרחבים, רק מי שהוסיף את האפליקציה יכול לשנות את ההגדרות.

1. פותחים את Chat.
2. פותחים צ'אט ישיר עם האפליקציה או נכנסים למרחב שבו האפליקציה נמצאת.
3. כותבים ‎/github_settings כדי לפתוח את ההגדרות הקיימות של האפליקציה.
4. משנים את ההגדרות לפי הצורך.
5. לוחצים על Save (שמירה).

אם תסירו את האפליקציה ממרחב מסוים, ההגדרות של האפליקציה יימחקו.

מה הפקודות שאפשר לשלוח לאפליקציית GitHub ב-Chat

בצ'אט ישיר או במרחב ב-Chat אפשר לשלוח לאפליקציית GitHub את הפקודות הבאות:

• דרך שורת הפקודות:
  • ‫‎/github_settings: פתיחת תיבת הדו-שיח של ההגדרות.
  • ‫‎/github_reminders: הגדרת ועריכת תזכורות בבקשות משיכה (pull requests) פתוחות. אלו יכולות להיות בקשות משיכה אישיות או של הצוות.
  • ‫‎/github_subscribe: הרשמה ל-<repoURL> או ל-<owner/repo> ב-GitHub.
  • ‫‎/github_openIssue: פנייה חדשה לגבי בעיה ב-GitHub.
  • ‫‎/github_logout: התנתקות מהחשבון ב-GitHub.
  • ‫‎/github_help: פתיחה של הודעת העזרה.
  • ‫‎/github_feedback: שליחת משוב על אפליקציית GitHub.
• כדי לשלוח פקודות מהירות: לוחצים על סמל הכלים של Google Workspace‏ .
  • ‫GitHub Connect: תופיע הודעה עם האפשרויות Sign in (כניסה לחשבון) ו-Legacy Sign in (כניסה בשיטה הקודמת).
  • ‫GitHub Reauthorize: כדי לעבור לשיטת החיבור החדשה.

כדי לראות את רשימת הפקודות שאפשר לשלוח:

1. פותחים את Chat במחשב.
2. פותחים צ'אט ישיר או מרחב שבו אפליקציית GitHub מותקנת.
3. כותבים ‎/github_help.

פתרון בעיות שקשורות לאפליקציית GitHub ב-Chat

אם מופיעה הודעת שגיאה כשאתם מנסים להירשם להתראות בזמן אמת

אפליקציית GitHub

כדי לקבל במרחבים התראות בזמן אמת:

1. פותחים בדפדפן את הגדרות הפרופיל ב-GitHub.
2. בקטע Integrations (שילובים), לוחצים על Applications (אפליקציות) Authorized GitHub apps (אפליקציות GitHub מורשות).
   • אחרי שתתחברו ל-GitHub ב-Chat, אפליקציית Google Chat אמורה להופיעה ברשימת האפליקציות המורשות.
3. איך מתקינים את אפליקציית Google Chat למאגר ב-GitHub
   • אתם יכולים גם לבקש מהארגון או מהבעלים של המאגר להתקין את האפליקציה.
4. מחכים שההתקנה תסתיים.
5. ב-Google Chat, פותחים צ'אט ישיר או מרחב עם אפליקציית GitHub.
6. כדי להירשם, כותבים בשדה ההודעה ‎/github_subscribe ואז את שם הארגון/המאגר או ‎/github_settings.

אפליקציית OAuth

כדי לקבל במרחבים התראות בזמן אמת על מאגר כלשהו, אתם צריכים:

• להיות הבעלים של הארגון באותו מאגר.
• לאשר את האפליקציה בארגון ב-GitHub.
  1. פותחים בדפדפן את הגדרות הפרופיל ב-GitHub.
  2. בקטע Integrations (שילובים), לוחצים על Applications (אפליקציות) Authorized OAuth apps (אפליקציות OAuth מורשות).
     • אחרי שתתחברו לאפליקציית GitHub ב-Google Chat, אפליקציית Google Chat אמורה להופיעה ברשימת האפליקציות המורשות.
  3. נותנים לאפליקציה הרשאת גישה לארגון הרלוונטי.

אם אתם מקבלים יותר מדי התראות מאפליקציית GitHub

1. כותבים בשדה ההודעה ‎/github_settings.
2. כדי לערוך את ההגדרות של המאגר, לוחצים על Notification settings (הגדרת ההתראות).
3. כדי לסנן את ההתראות, לוחצים על החץ למטה ליד כל אחד מסוגי ההתראות.
   • יופיעו אפשרויות נוספות לסינון ההתראות.
4. מסמנים את התיבות של ההתראות שרוצים לקבל.
5. לוחצים על Save (שמירה).

אם אתם לא מתויגים בתזכורות

כדי שתתויגו בתזכורות, אתם צריכים לחבר בין החשבון שלכם ב-Google Chat לחשבון ב-GitHub.

1. כותבים בשדה ההודעה ‎/github_settings.
2. כדי לחבר את החשבון:
   1. בחלון הקופץ, לוחצים על Configure Access (הגדרת הגישה) Sign in to GitHub (כניסה ל-GitHub).
   2. נכנסים לחשבון ב-GitHub.
   3. נותנים הרשאה לאפליקציה.
3. בהודעה שנשלחה מ-GitHub, לוחצים על Schedule reminders for your team (קביעת תזכורות לצוות).
4. בחלון הקופץ:
   1. לוחצים על Create new reminder (יצירת תזכורת חדשה).
   2. בודקים או משנים את שאר ההגדרות של התזכורות.
   3. לוחצים על Save (שמירה).

אם אתם לא מקבלים תזכורות עם אפליקציית GitHub

במאגר שממנו רוצים לקבל תזכורות, מוודאים שאפליקציית Google Chat ל-GitHub מותקנת.

_{Google,‏ Google Workspace והסימנים וסמלי הלוגו הקשורים אליהם הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.}