De GitHub-app gebruiken in Google Chat

Gebruik de GitHub-app in Google Chat om meldingen te krijgen over GitHub-gebeurtenissen, zoals problemen, pull-verzoeken en reacties.

Voordat u begint

Zo gebruikt u de GitHub-app voor Chat:

• U heeft toestemming nodig van uw Google Workspace-beheerder om apps te installeren.
• Voeg de app toe aan Chat. Meer informatie over hoe u bots vindt en toevoegt aan Chat
• U moet een GitHub-account hebben.
• U moet de Google Chat-app voor uw GitHub-opslagplaats installeren.

Inzicht in verificatiemechanismen voor GitHub-apps en OAuth-apps

Hierin worden de verschillende kenmerken en operationele modellen van GitHub-apps en OAuth-apps beschreven. Dit zijn de belangrijkste mechanismen waarmee services van derden kunnen worden geïntegreerd met en toegang kunnen krijgen tot GitHub-bronnen. Een uitgebreid begrip van deze verschillen is essentieel om een optimale beveiligingsstatus binnen een organisatie te behouden.

1. Vergelijkende analyse: Belangrijke verschillen

De fundamentele verschillen tussen de 2 modellen zitten in de identiteit die wordt gebruikt voor toegang (het hoofdaccount) en het mechanisme dat de resourceautorisatie beheert.

Kenmerk	GitHub-app (aanbevolen inlogmethode)	OAuth-app (verouderde inlogmethode)
Identiteit van hoofdaccount	Fungeert als een onafhankelijke app-identiteit, los van een gebruiker of namens de autoriserende gebruiker, afhankelijk van het use case.	Handelt namens de autoriserende gebruiker en neemt de rechten van die gebruiker over.
Autorisatiemodel	Gedetailleerde rechten (aanbevolen): Maakt gebruik van het principe van minimale rechten, waardoor toegang tot specifieke repositories en resourcetypen mogelijk is. Bijvoorbeeld: Alleen leestoegang tot metadata.	Brede bereiken: Toegang wordt gedefinieerd door brede bereiken, zoals toegang verlenen tot alle resources die zichtbaar zijn voor de autoriserende gebruiker.
Levensduur van inloggegevens	Kortlopende tokens: Toegangstokens hebben een beperkte levensduur (meestal 1 uur) en moeten vaak worden vernieuwd. Dit beperkt het risico aanzienlijk als de token wordt gecompromitteerd.	Tokens met een lange levensduur: Toegangstokens blijven bestaan totdat ze handmatig door de gebruiker worden ingetrokken. Dit houdt een langdurig blootstellingsrisico in.
Installatievereiste	Moet door een beheerder of organisatie-eigenaar worden geïnstalleerd, waardoor een formele koppeling met het account of de organisatie tot stand wordt gebracht en de gebruiker toestemming geeft voor use cases waarin de app namens de gebruiker handelt.	Moet door een individuele gebruiker worden geautoriseerd, waarbij de toegang rechtstreeks aan de identiteit van die gebruiker wordt gekoppeld.

Ga naar Verschillen tussen GitHub-apps en OAuth-apps voor uitgebreidere documentatie.

2. Aanbeveling

Op basis van best practices voor beveiliging wordt het verificatiemechanisme van de GitHub-app aanbevolen voor alle integraties van derden en organisaties. Dit model dwingt het principe van minimale rechten af en gebruikt robuuste, tijdelijke inloggegevens. Hierdoor wordt een hogere standaard voor beveiliging en operationele stabiliteit gehandhaafd dan bij het model met gedelegeerde rechten van OAuth-apps.

Installeer de Google Chat-app voor GitHub-repository's.

De GitHub-app instellen in Chat

1. Open Chat.
2. Open een privéchat met de app of ga naar een ruimte die de app bevat.
3. Klik op Inloggen om het configuratievenster te openen.
4. Klik op Toegang instellen Inloggen bij GitHub.
5. Rond het inlogproces af en sluit de pop-up.
6. Klik op Refresh (Vernieuwen) om het Chat-dialoogvenster te updaten.
7. Typ onder Add Repositories (Opslagplaatsen toevoegen) de GitHub-opslagplaats waarvoor u meldingen wilt krijgen.
8. Vink de vakjes aan voor de gebeurtenissen waarvoor u meldingen wilt krijgen.
9. Klik op Opslaan.

Tip: U moet meldingen instellen in elke ruimte waaraan u de app toevoegt. De app stuurt meldingen naar alle ruimtes waarvan deze lid is.

Migreren van OAuth-app (verouderd) naar GitHub-app (aanbevolen)

Zo migreert u uw huidige verbinding van de oudere OAuth-app-verificatiemethode naar de aanbevolen GitHub-app-methode:

1. Open Chat.
2. Open een privéchat of ruimte met de GitHub-app.
3. Klik in het berichtveld op Google Workspace-tools .
4. Selecteer GitHub Reauthorize (GitHub opnieuw autoriseren) in de lijst met opdrachten.
5. Volg de instructies op het scherm in het Chat-dialoogvenster om het migratie- en herautorisatieproces af te ronden.

De GitHub-app gebruiken in ruimtes

Als u de app in ruimtes wilt gebruiken, moet u de app @vermelden of /vermelden in elk bericht en in antwoorden op berichten van de app.

De @vermelding of /vermelding bevestigt dat je het bericht naar de app en niet naar anderen in de ruimte hebt gestuurd.

1. Open de Chat-app .
2. Voer in een ruimte @github of /github in, gevolgd door de opdracht.
   • Als je @github of /github vermeldt, wordt het bericht naar de app gestuurd en niet naar anderen in de ruimte.

App-instellingen wijzigen

In ruimtes kan alleen degene die de app heeft toegevoegd de instellingen wijzigen.

1. Open Chat.
2. Open een privéchat met de app of ga naar een ruimte die de app bevat.
3. Als u de huidige instellingen voor de app wilt openen, voert u /github_settings in.
4. Wijzig de gewenste instellingen.
5. Klik op Opslaan.

Als u de app uit een ruimte verwijdert, worden de app-instellingen ook verwijderd.

Meer informatie over opdrachten voor de GitHub-app in Chat

In het berichtveld van een privéchat of ruimte met de GitHub-app in Chat kunt u het volgende gebruiken:

• Slash-opdrachten:
  • /github_settings: Open het dialoogvenster met instellingen.
  • /github_reminders: Stel geplande herinneringen in en bewerk ze voor open pull-verzoeken voor jezelf of je team.
  • /github_subscribe: Abonneer je op een GitHub-<repoURL> of -<owner/repo>.
  • /github_openIssue: Open een nieuw GitHub-probleem.
  • /github_logout: Log uit van je GitHub-account.
  • /github_help: Toon het helpbericht.
  • /github_feedback: Stuur feedback over de GitHub-app.
• Snelle opdrachten: Klik op Google Workspace-tools om de snelle opdrachten te openen.
  • GitHub Connect: Toont een bericht met de opties Inloggen en Verouderde inlogmethode.
  • GitHub opnieuw autoriseren: Hiermee kunt u migreren naar een nieuwe verbindingsmethode.

Zo krijgt u een volledige lijst met ondersteunde opdrachten:

1. Open Chat op uw computer.
2. Open een privéchat of ga naar een ruimte waarin de GitHub-app is geïnstalleerd.
3. Voer /github_help in.

Problemen met de GitHub-app in Chat oplossen

Als u een foutmelding krijgt als u zich abonneert op realtime meldingen

GitHub-app

Zo stelt u realtime meldingen in ruimtes in:

1. Ga in uw browser naar de instellingen voor uw GitHub-profiel.
2. Klik onder Integraties op Apps Toegestane OAuth-apps.
   • Nadat u de GitHub-app heeft gekoppeld in Google Chat, staat Google Chat in uw lijst met gemachtigde apps.
3. Installeer de Google Chat-app voor GitHub-repository's.
   • U kunt de installatie ook aanvragen bij de eigenaar van de organisatie/repository.
4. Wacht tot de installatie is afgerond.
5. Open in Google Chat een privéchat of ruimte met de GitHub-app.
6. Voer in het berichtveld /github_subscribe [organisation/repo] of /github_settings in om een abonnement te maken.

OAuth-app

Als u realtime meldingen wilt instellen in ruimtes, moet u:

• Je bent de organisatie-eigenaar van de voorgestelde opslagplaats.
• De app binnen de GitHub-organisatie machtigen.
  1. Ga in uw browser naar de instellingen voor uw GitHub-profiel.
  2. Onder Integraties op Apps Toegestane OAuth-apps klikken.
     • Nadat u de GitHub-app heeft gekoppeld in Google Chat, staat Google Chat in uw lijst met geautoriseerde apps.
  3. De app toegang geven tot de organisatie waartoe u toegang wilt hebben.

Als u te veel meldingen van de GitHub-app krijgt

1. Voer in het berichtveld /github_settings in.
2. Klik op Meldingsinstellingen om de instellingen voor meldingen voor uw repository te bewerken.
3. Als u de meldingen wilt filteren, klikt u naast elk meldingstype op de pijl-omlaag .
   • Er worden extra opties getoond om meldingen te filteren.
4. Vink de vakjes aan voor de meldingen die u wilt.
5. Klik op Opslaan.

Als je niet wordt @vermeld in geplande herinneringen

Als u wilt worden vermeld in geplande herinneringen, moet u uw Google Chat-account aan het GitHub-account hebben gekoppeld.

1. Voer in het berichtveld /github_settings in.
2. Zo koppelt u uw account:
   1. Klik in het pop-upvenster op Toegang instellen Inloggen bij GitHub.
   2. Log in op uw GitHub-account.
   3. Autoriseer de app.
3. Selecteer in het bericht dat u van de GitHub-app krijgt de optie Herinneringen voor uw team plannen.
4. In de pop-up kunt u het volgende doen:
   1. Klik op Nieuwe herinnering maken.
   2. Stel de herinneringsinstellingen in.
   3. Klik op Opslaan.

Als u geen herinneringen krijgt met de GitHub-app

Verifieer de installatie van de Google Chat-app voor GitHub in de repository waarvoor u herinneringen wilt krijgen.

_{Google, Google Workspace en de gerelateerde merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waarmee ze in verband worden gebracht.}