Použití aplikace GitHub v Google Chatu

Pomocí aplikace GitHub si můžete v Google Chatu nechat posílat oznámení o událostech v GitHubu, jako jsou problémy, žádosti o změnu (pull request) a komentáře.

Než začnete

Postup použití aplikace GitHub pro Chat:

• K instalaci aplikací potřebujete oprávnění od administrátora Google Workspace.
• Přidejte si aplikaci do Chatu. Přečtěte si, jak vyhledávat aplikace a přidat je do Chatu.
• Potřebujete účet GitHub.
• Je potřeba nainstalovat aplikaci Google Chat pro váš repozitář GitHub.

Seznamte se s ověřovacími mechanismy aplikací GitHub a OAuth

Tento článek popisuje individuální charakteristiky a operační modely aplikací GitHub a OAuth, které slouží jako primární mechanismy integrace služeb třetích stran se službou GitHub a přístupu k jejím zdrojům. Správné pochopení těchto rozdílů je zásadní pro zachování optimální úrovně zabezpečení v organizaci.

1. Srovnávací analýza: Klíčové rozdíly

Zásadní rozdíly mezi těmito dvěma modely spočívají v identitě použité pro přístup (entita zabezpečení) a v mechanismu, který řídí autorizaci zdrojů.

Atribut	Aplikace GitHub (doporučené přihlášení)	Aplikace OAuth (starší přihlášení)
Identita entity zabezpečení	V závislosti na případu použití funguje jako nezávislá identita aplikace oddělená od uživatele, případně jménem autorizujícího uživatele.	Jedná jménem autorizujícího uživatele a dědí jeho oprávnění.
Model autorizace	Podrobná oprávnění (doporučeno): Využívá princip nejmenšího oprávnění a umožňuje přístup ke konkrétním repozitářům a typům zdrojů. Příklad: Přístup ke čtení pouze pro metadata.	Široké rozsahy: Přístup je definován širokými rozsahy, například udělením přístupu ke všem zdrojům viditelným pro autorizujícího uživatele.
Délka platnosti identifikačních údajů	Krátkodobé tokeny: Přístupové tokeny mají omezenou životnost (obvykle 1 hodinu) a vyžadují časté obnovování, což v případě ohrožení výrazně snižuje riziko.	Dlouhodobé tokeny: Přístupové tokeny zůstávají platné, dokud je uživatel ručně nezruší, což představuje vyšší riziko v případě ohrožení.
Požadavek na instalaci	Musí být nainstalována administrátorem nebo vlastníkem organizace, který vytvoří formální propojení s účtem nebo organizací. Uživatel ji autorizuje pro případy použití, kdy aplikace jedná jménem uživatele.	Musí být autorizována jednotlivým uživatelem, přičemž přístup musí být přímo propojen s jeho identitou.

Podrobnější dokumentaci najdete v článku Rozdíly mezi aplikacemi GitHub a OAuth.

2. Doporučení

V souladu s doporučenými postupy zabezpečení doporučujeme pro všechny integrace třetích stran a organizací používat ověřovací mechanismus aplikace GitHub. Tento model uplatňuje zásadu nejmenších oprávnění a používá robustní, časově omezené identifikační údaje, čímž udržuje vyšší standard zabezpečení a provozní stability ve srovnání s modelem delegované autority aplikací OAuth.

Nainstalujte si aplikaci Google Chat pro repozitáře GitHub.

Nastavení aplikace GitHub v Chatu

1. Otevřete Chat.
2. Otevřete přímou zprávu s aplikací nebo s ní přejděte do prostoru.
3. Kliknutím na Přihlásit se otevřete okno konfigurace.
4. Klikněte na Konfigurovat přístup Přihlásit se do GitHubu.
5. Dokončete proces přihlášení a vyskakovací okno zavřete.
6. Pokud chcete dialogové okno Chatu aktualizovat, klikněte na Obnovit.
7. Do pole Přidat repozitáře zadejte repozitář GitHub, o kterém chcete dostávat oznámení.
8. Zaškrtněte políčka u událostí, o kterých chcete dostávat oznámení.
9. Klikněte na Uložit.

Tip: Oznámení musíte nastavit v každém prostoru, do kterého aplikaci přidáte. Aplikace odesílá oznámení do všech prostorů, kde je členem.

Migrace z aplikace OAuth (starší verze) na aplikaci GitHub (doporučeno)

Pokud chcete stávající připojení migrovat ze starší metody ověření aplikace OAuth na doporučenou metodu aplikace GitHub:

1. Otevřete Chat.
2. Otevřete přímou zprávu nebo prostor s aplikací GitHub.
3. V poli pro zprávu klikněte na Nástroje Google Workspace .
4. V seznamu příkazů vyberte Znovu autorizovat GitHub.
5. Dokončete migraci a proces opětovné autorizace podle pokynů na obrazovce v dialogovém okně Chatu.

Používání aplikace GitHub v prostorech

Pokud chcete v prostorech používat aplikaci, musíte ji @zmínit nebo /zmínit v každé zprávě a v odpovědích na zprávy od aplikace.

@zmínkou nebo /zmínkou potvrdíte, že zprávu posíláte aplikaci, a ne ostatním uživatelům prostoru.

1. Spusťte aplikaci Chat .
2. V prostoru zadejte @github nebo /github a poté příkaz.
   • Když zmíníte @github nebo /github, zpráva se odešle do aplikace, a ne ostatním uživatelům prostoru.

Změna nastavení aplikace

V prostorech může nastavení změnit jen ten, kdo aplikaci přidal.

1. Otevřete Chat.
2. Otevřete přímou zprávu s aplikací nebo s ní přejděte do prostoru.
3. Pokud chcete otevřít aktuální nastavení aplikace, zadejte /github_settings.
4. Upravte nastavení podle potřeby.
5. Klikněte na Uložit.

Odstraněním aplikace z prostoru smažete její nastavení.

Příkazy pro aplikaci GitHub v Chatu

V poli pro zadání přímé zprávy nebo v prostoru s aplikací GitHub v Chatu můžete používat:

• Příkazy s lomítkem:
  • /github_settings: Otevře dialogové okno nastavení.
  • /github_reminders: Nastavte a upravte naplánovaná připomenutí pro osobní nebo týmové otevřené žádosti o změnu.
  • /github_subscribe: Přihlásí odběr k repozitáři GitHub <repoURL> nebo <owner/repo>.
  • /github_openIssue: Otevře nový problém na GitHubu.
  • /github_logout: Odhlásí vás z účtu GitHub.
  • /github_help: Zobrazí zprávu nápovědy.
  • /github_feedback: Odeslání zpětné vazby k aplikaci GitHub.
• Rychlé příkazy: Rychlé příkazy zobrazíte kliknutím na Nástroje Google Workspace .
  • Připojení GitHub: Zobrazí zprávu s možnostmi Přihlásit se a Starší přihlášení.
  • Znovu autorizovat GitHub: Umožňuje migrovat na nový způsob připojení.

Úplný seznam podporovaných příkazů zobrazíte takto:

1. Na počítači otevřete Chat.
2. Otevřete přímou zprávu nebo přejděte do prostoru, kde je nainstalovaná aplikace GitHub.
3. Zadejte: /github_help.

Odstraňování problémů s aplikací GitHub v Chatu

Pokud se při přihlašování k oznámením v reálném čase zobrazí chyba

Aplikace GitHub

Postup nastavení oznámení v reálném čase v prostorech:

1. V prohlížeči přejděte do nastavení profilu GitHub.
2. V sekci Integrace klikněte na Aplikace Autorizované aplikace GitHub.
   • Po připojení aplikace GitHub v Google Chatu se v seznamu autorizovaných aplikací zobrazí Google Chat.
3. Nainstalujte si aplikaci Google Chat pro repozitář GitHub.
   • Případně můžete o instalaci požádat vlastníka organizace nebo repozitáře.
4. Počkejte na dokončení instalace.
5. V Google Chatu otevřete přímou zprávu nebo prostor s aplikací GitHub.
6. Pokud chcete vytvořit odběr, zadejte do pole pro zprávu: /github_subscribe [organizace/repozitář] nebo /github_settings.

Aplikace OAuth

Pokud chcete v prostorech nastavit oznámení v reálném čase, musíte:

• Být vlastníkem navrhovaného repozitáře.
• Autorizovat aplikaci v organizaci na GitHubu.
  1. V prohlížeči přejděte do nastavení profilu GitHub.
  2. V sekci Integrace klikněte na Aplikace Autorizované aplikace OAuth.
     • Po připojení aplikace GitHub v Google Chatu se v seznamu autorizovaných aplikací zobrazí „Google Chat“.
  3. Udělení přístupu aplikace k organizaci, ke které chcete mít přístup

Pokud vám z aplikace GitHub chodí příliš mnoho oznámení

1. Do pole zprávy zadejte /github_settings.
2. Pokud chcete upravit nastavení oznámení repozitáře, klikněte na Nastavení oznámení.
3. Pokud chcete oznámení filtrovat, klikněte vedle každého typu oznámení na šipku dolů .
   • Zobrazí se další možnosti filtrování oznámení.
4. Zaškrtněte políčka u oznámení, která chcete dostávat.
5. Klikněte na Uložit.

Pokud vás v naplánovaných připomenutích nelze @zmínit

Pokud chcete být zmíněni v naplánovaných připomenutích, musíte mít účet Google Chat propojený s účtem GitHub.

1. Do pole zprávy zadejte /github_settings.
2. Postup připojení účtu:
   1. Ve vyskakovacím okně klikněte na Konfigurovat přístup Přihlásit se na GitHub.
   2. Přihlaste se ke svému účtu GitHub.
   3. Aplikaci autorizujte.
3. V zprávě, kterou obdržíte z aplikace GitHub, vyberte Naplánovat připomenutí pro tým.
4. Ve vyskakovacím okně:
   1. Klikněte na Vytvořit nové připomenutí.
   2. Nakonfigurujte nastavení připomenutí.
   3. Klikněte na Uložit.

Pokud vám z aplikace GitHub nechodí připomenutí

V repozitáři, ze kterého chcete dostávat připomenutí, ověřte instalaci aplikace Google Chat pro GitHub.

_{Google, Google Workspace a související značky a loga jsou ochrannými známkami společnosti Google LLC. Všechny ostatní názvy společností a produktů jsou ochrannými známkami společností, se kterými jsou spojeny.}