A GitHub alkalmazás használata a Google Chatben

A GitHub alkalmazással értesítéseket kaphat a GitHub-eseményekről, például a problémákról, a lekérési kérelmekről és a megjegyzésekről a Chatben.

Mielőtt belefogna

A GitHub alkalmazás használata a Chathez:

• Engedélyre van szüksége a(z) Google Workspace-adminisztrátortól az alkalmazások telepítéséhez.
• Adja hozzá az alkalmazást a Chathez. További információ az appok megkereséséről és a Chathez való hozzáadásukról.
• GitHub-fiókra van szüksége.
• Telepítenie kell a Google Chat alkalmazást a GitHub-tárhelyhez.

A GitHub-alkalmazások és az OAuth-alkalmazások hitelesítési mechanizmusainak megismerése

Ez a dokumentum a GitHub-alkalmazások és az OAuth-alkalmazások különálló jellemzőit és működési modelljeit ismerteti, amelyek a harmadik felek szolgáltatásai számára a GitHub-erőforrásokkal való integráció és a hozzájuk való hozzáférés elsődleges mechanizmusai. E különbségek átfogó ismerete kulcsfontosságú az optimális biztonsági helyzet fenntartásához a szervezeten belül.

1. Összehasonlító elemzés: A legfontosabb különbségek

A két modell közötti alapvető különbségek a hozzáféréshez használt identitásban (az alany) és az erőforrás-engedélyezést szabályozó mechanizmusban rejlenek.

Attribútum	GitHub alkalmazás (ajánlott bejelentkezés)	OAuth alkalmazás (régi bejelentkezés)
Egyszerű identitás	Független alkalmazás-identitásként működik, amely az adott használati esettől függően elkülönül a felhasználótól, vagy a felhatalmazó felhasználó nevében jár el.	A felhatalmazó felhasználó nevében jár el, és örökli a jogosultságait.
Engedélyezési modell	Részletes engedélyek (ajánlott): A legkisebb jogosultság elve alapján működik, és lehetővé teszi a hozzáférést bizonyos tárhelyekhez és erőforrástípusokhoz. Például: Csak olvasási hozzáférés a metaadatokhoz.	Széles hatókörök: A hozzáférést széles hatókörök határozzák meg, például a felhatalmazó felhasználó számára látható összes erőforráshoz való hozzáférés megadása.
Hitelesítési adatok élettartama	Rövid élettartamú tokenek: A hozzáférési tokenek élettartama korlátozott (általában 1 óra), és gyakori megújítást igényelnek, ami jelentősen csökkenti a biztonsági rések kockázatát.	Hosszú élettartamú tokenek: A hozzáférési tokenek addig maradnak meg, amíg a felhasználó manuálisan vissza nem vonja őket, ami elhúzódó kitettségi kockázatot jelent.
Telepítési követelmény	Adminisztrátornak vagy szervezet tulajdonosának kell telepítenie, és hivatalos kapcsolatot kell létrehoznia a fiókkal vagy a szervezettel, valamint a felhasználónak engedélyeznie kell az olyan használati esetekre, amikor az alkalmazás a felhasználó nevében jár el.	Egyéni felhasználónak kell engedélyeznie, és a hozzáférést közvetlenül az adott felhasználó személyazonosságához kell kapcsolni.

A részletesebb dokumentációt A GitHub-alkalmazások és OAuth-alkalmazások közötti különbségek című cikkben találja.

2. Javaslat

A biztonsági bevált módszerek alapján a GitHub-alkalmazás hitelesítési mechanizmusa javasolt minden harmadik féltől származó és szervezeti integrációhoz. Ez a modell a legkisebb jogosultság elvét alkalmazza, és robusztus, időkorlátos hitelesítési adatokat használ, így az OAuth-alkalmazások delegált hatósági modelljéhez képest magasabb szintű biztonságot és működési stabilitást biztosít.

A Google Chat alkalmazás telepítése a GitHub-tárhelyekhez.

A GitHub alkalmazás beállítása a Chatben

1. Nyissa meg a Chat oldalát.
2. Nyisson meg egy az alkalmazással váltott közvetlen üzenetet, vagy lépjen be egy olyan projektterületre, amelyben az alkalmazás is benne van.
3. A konfigurációs ablak megnyitásához kattintson a Bejelentkezés lehetőségre.
4. Kattintson a Hozzáférés konfigurálása Bejelentkezés a GitHubba lehetőséget.
5. Végezze el a bejelentkezési folyamatot, majd zárja be az előugró ablakot.
6. A Chat-párbeszédpanel frissítéséhez kattintson a Frissítés lehetőségre.
7. A Tárhelyek hozzáadása lehetőség alatt adja meg azt a GitHub-tárhelyet, amelyről értesítéseket szeretne kapni.
8. Jelölje be a jelölőnégyzeteket azokra az eseményekre vonatkozóan, amelyekről értesítéseket szeretne kapni.
9. Kattintson a Mentés gombra.

Tipp: Minden olyan projektterületen be kell állítania az értesítéseket, ahol hozzáadja az alkalmazást. Az alkalmazás minden olyan projektterületnek értesítést küld, amelynek a tagja.

Áttelepítés OAuth-alkalmazásból (régi) GitHub-alkalmazásba (ajánlott)

A jelenlegi kapcsolat áttelepítése a régebbi OAuth-alkalmazás-hitelesítési módszerről az ajánlott GitHub-alkalmazás módszerére:

1. Nyissa meg a Chat oldalát.
2. Nyisson meg egy közvetlen üzenetet vagy projektterületet a GitHub alkalmazással.
3. Az üzenetmezőben kattintson a Google Workspace-eszközök elemre.
4. A parancsok listájában válassza A GitHub újbóli engedélyezése lehetőséget.
5. Az áttelepítési és az újbóli engedélyezési folyamat befejezéséhez kövesse a Chat párbeszédpanelén megjelenő utasításokat.

A GitHub alkalmazás használata projektterületeteken

Ha az alkalmazást projektterületeken szeretné használni, @megemlítést vagy /megemlítést kell elhelyeznie az alkalmazásnak küldött minden egyes üzenetben és az alkalmazástól kapott üzenetekre adott válaszokban.

A @megemlítés vagy a /megemlítés megerősíti, hogy az üzenetet az alkalmazásnak küldte, nem pedig másoknak a projektterületen.

1. Nyissa meg a Chat alkalmazást .
2. Egy projektterületen írja be a @github vagy a /github parancsot, majd a parancsot.
   • A @github vagy a /github megemlítésekor az üzenetet az alkalmazásnak küldi el, nem pedig másoknak a projektterületen.

Alkalmazásbeállítások módosítása

A projektterületeken csak az a személy módosíthatja a beállításokat, aki hozzáadta az alkalmazást.

1. Nyissa meg a Chat oldalát.
2. Nyisson meg egy az alkalmazással váltott közvetlen üzenetet, vagy lépjen be egy olyan projektterületre, amelyben az alkalmazás is benne van.
3. Az alkalmazás jelenlegi beállításainak megnyitásához írja be a következőt: /github_settings.
4. Szükség szerint módosítsa a beállításokat.
5. Kattintson a Mentés gombra.

Ha eltávolítja az alkalmazást egy projektterületről, azzal törli az alkalmazás beállításait.

További információ a Chatben használt GitHub alkalmazásnak adott parancsokról

A GitHub alkalmazással a Chatben egy közvetlen üzenet vagy projektterület üzenetmezőjében a következőket használhatja:

• Perjelet tartalmazó parancsok:
  • /github_settings: Megnyitja a beállítások párbeszédpaneljét.
  • /github_reminders: Beállíthat ütemezett emlékeztetőket és szerkesztheti azokat a személyes vagy csapathoz tartozó nyitott beolvasztási kérelmek esetén.
  • /github_subscribe: Feliratkozik egy GitHub <repoURL> vagy <owner/repo> listára.
  • /github_openIssue: Megnyit egy új GitHub-ügyet.
  • /github_logout: Kijelentkezik az Ön GitHub-fiókjából.
  • /github_help: Megjeleníti a súgóüzenetet.
  • /github_feedback: Visszajelzést küldhet a GitHub alkalmazásról.
• Gyorsparancsok: A gyorsparancsok eléréséhez kattintson a Google Workspace-eszközök ikonra.
  • GitHub Connect: Megjelenít egy üzenetet, amely tartalmazza a „Bejelentkezés” és a „Régi bejelentkezés” lehetőséget.
  • GitHub újbóli engedélyezése: Lehetővé teszi az új kapcsolódási módszerre való áttérést.

A támogatott parancsok teljes listáját itt találja:

1. Nyissa meg a Chatet a számítógépén.
2. Nyisson meg egy közvetlen üzenetet vagy egy olyan projektterületet, amelynél a GitHub alkalmazás telepítve van.
3. Írja be a következőt: /github_help.

A Chatben használt GitHub alkalmazással kapcsolatos problémák megoldása

Ha hibaüzenetet kap valós idejű értesítésekre való feliratkozáskor

GitHub alkalmazás

Valós idejű értesítések beállítása projektterületeken:

1. Böngészőben nyissa meg a GitHub-profilbeállításokat.
2. Az „Integrációk” alatt kattintson az Alkalmazások Engedélyezett GitHub-alkalmazások lehetőségre.
   • Miután csatlakoztatta a GitHub alkalmazást a Google Chatben, az engedélyezett alkalmazások listáján megjelenik a „Google Chat”.
3. Telepítse a Google Chat alkalmazást a GitHub-tárhelyhez.
   • Másik lehetőségként kérheti a telepítést a szervezet/tárhely tulajdonosától.
4. Várja meg a telepítés befejeződését.
5. A Google Chatben nyisson meg egy közvetlen üzenetet vagy egy projektterületet a GitHub alkalmazással.
6. Az üzenetmezőben az előfizetés létrehozásához írja be a következőt: /github_subscribe [organisation/repo] vagy /github_settings.

OAuth-alkalmazás

Valós idejű értesítések beállításához projektterületeken a következőket kell teljesítenie:

• Egy a javasolt tárhelyhez tartozó szervezet tulajdonosának kell lennie.
• Engedélyeznie kell az alkalmazást a GitHub szervezetnél.
  1. Böngészőben nyissa meg a GitHub-profilbeállításokat.
  2. Az „Integrációk” alatt kattintson az Alkalmazások Engedélyezett OAuth-alkalmazások lehetőségre.
     • Miután csatlakoztatta a GitHub alkalmazást a Google Chatben, az engedélyezett alkalmazások listáján megjelenik a „Google Chat”.
  3. Adjon alkalmazás-hozzáférést annak a szervezetnek, amelyhez hozzá szeretne férni.

Ha túl sok értesítést kap a GitHub alkalmazástól

1. Az üzenetmezőbe írja be a /github_settings parancsot.
2. A tárhelyértesítések beállításainak módosításához kattintson az Értesítési beállítások lehetőségre.
3. Az értesítések szűréséhez az egyes értesítéstípusok mellett kattintson a lefelé nyílra .
   • Ekkor további lehetőségek jelennek meg az értesítések szűrésére.
4. Jelölje be a kívánt értesítések jelölőnégyzetét.
5. Kattintson a Mentés gombra.

Ha nem kap @megemlítést az ütemezett emlékeztetőknél

Ahhoz, hogy meg legyen említve az ütemezett emlékeztetőkben, csalatkoztatnia kell Google Chat-fiókját a GitHub-fiókjához.

1. Az üzenetmezőbe írja be a /github_settings parancsot.
2. A fiók csatlakoztatásához:
   1. Az előugró ablakban kattintson a Hozzáférés konfigurálása Bejelentkezés a GitHubba lehetőségre.
   2. Jelentkezzen be a GitHub-fiókjába.
   3. Engedélyezze az alkalmazást.
3. A GitHub alkalmazástól kapott üzenetben válassza az Emlékeztetők ütemezése a csapat számára lehetőséget.
4. Az előugró ablakban:
   1. Kattintson az Új emlékeztető létrehozása lehetőségre.
   2. Konfigurálja az emlékeztetők beállításait.
   3. Kattintson a Mentés gombra.

Ha nem kap emlékeztetőket a GitHub alkalmazástól

Annak a tárhelynek az esetében, amelyről emlékeztetőket szeretne kapni, ellenőrizze a Google Chat alkalmazás telepítését a GitHubhoz.

A Google, a Google Workspace és a kapcsolódó márkajegyek és logók a Google LLC védjegyei. Valamennyi egyéb cég- és terméknév a hozzájuk kapcsolódó vállalat védjegye.