Brug GitHub-appen i Google Chat

Brug GitHub-appen i Chat for at få notifikationer om GitHub-hændelser som f.eks. problemer, anmodninger om hentning og kommentarer.

Før du begynder

Sådan bruger du GitHub-appen til Chat:

• Din Google Workspace-administrator skal give dig tilladelse til at installere apps.
• Føj appen til Chat. Se, hvordan du finder apps og føjer dem til Chat.
• Du skal have en GitHub-konto.
• Du skal installere Google Chat-appen til dit GitHub-lager.

Forstå godkendelsesmekanismerne for GitHub-appen og OAuth-appen

Dette beskriver de forskellige karakteristika og driftsmodeller for GitHub-apps og OAuth-apps, som er de primære mekanismer for tredjepartstjenester til at integrere med og få adgang til GitHub-ressourcer. Det er vigtigt at have en grundig forståelse af disse forskelle for at opretholde et optimalt sikkerhedsniveau i en organisation.

1. Sammenlignende analyse: Vigtige forskelle

De grundlæggende forskelle mellem de 2 modeller ligger i den identitet, der bruges til adgang (Principal), og den mekanisme, der styrer ressourcegodkendelse.

Attribut	GitHub-app (anbefalet login)	OAuth-app (login med den gamle metode)
Principalidentitet	Fungerer som en uafhængig appidentitet, der er adskilt fra enhver bruger, eller på vegne af den godkendende bruger, afhængigt af brugstilfældet.	Handler på vegne af den godkendende bruger og arver vedkommendes rettigheder.
Autorisationsmodel	Finkornede tilladelser (anbefales): Anvender princippet om minimumsrettigheder, hvilket giver adgang til specifikke lagre og ressourcetyper. Eksempel: Læseadgang kun for metadata.	Brede omfang: Adgang defineres af brede omfang, f.eks. tildeling af adgang til alle ressourcer, der er synlige for den godkendende bruger.
Loginoplysningers levetid	Tokens med kort levetid: Adgangstokens har en begrænset levetid (typisk 1 time) og kræver hyppig fornyelse, hvilket i væsentlig grad reducerer risikoen i tilfælde af kompromittering.	Langtidsholdbare tokens: Adgangstokens er gyldige, indtil de tilbagekaldes manuelt af brugeren, hvilket udgør en forlænget risiko for eksponering.
Installationskrav	Skal installeres af en administrator eller organisationsejer, der opretter et formelt link til kontoen eller organisationen og er godkendt af brugeren til brugsscenarier, hvor appen handler på vegne af brugeren.	Skal godkendes af en individuel bruger, der knytter adgang direkte til den pågældende brugers identitet.

Du kan få mere omfattende dokumentation i Forskelle mellem GitHub-apps og OAuth-apps.

2. Anbefaling

Baseret på bedste praksis for sikkerhed anbefales GitHub-appens godkendelsesmekanisme til alle tredjeparts- og organisationsintegrationer. Denne model håndhæver princippet om minimumsrettighed og anvender robuste, tidsbegrænsede loginoplysninger, hvilket opretholder en højere standard for sikkerhed og driftsstabilitet sammenlignet med den delegerede autoritetsmodel for OAuth-apps.

Installer Google Chat-appen til GitHub-lagre.

Konfigurer GitHub-appen i Chat

1. Åbn Chat.
2. Åbn en direkte besked med appen, eller gå til et rum med appen.
3. Klik på Log ind for at åbne konfigurationsvinduet.
4. Klik på Konfigurer adgang Log ind på GitHub.
5. Gennemfør loginprocessen, og luk derefter pop op-vinduet.
6. Klik på Opdater for at opdatere chatdialogboksen.
7. Angiv det GitHub-lager, du vil have notifikationer om, under Tilføj lagre.
8. Markér afkrydsningsfelterne for de hændelser, du vil have notifikationer om.
9. Klik på Gem.

Tip! Du skal konfigurere notifikationer i alle de rum, hvor du tilføjer appen. Appen sender notifikationer til alle de rum, den er medlem af.

Migrer fra OAuth-appen (gammel) til GitHub-appen (anbefalet)

Sådan migrerer du din aktuelle forbindelse fra den ældre OAuth-appgodkendelsesmetode til den anbefalede GitHub-appmetode:

1. Åbn Chat.
2. Åbn en direkte besked eller et rum med GitHub-appen.
3. Klik på Google Workspace-værktøjer i meddelelsesfeltet.
4. Vælg GitHub Reauthorize [Godkend GitHub igen] på kommandolisten.
5. Følg vejledningen på skærmen i chatdialogen for at gennemføre migreringen og godkendelsesprocessen.

Brug GitHub-appen i rum

Hvis du vil bruge appen i rum, skal du @omtale eller /omtale appen i hver besked og i svar på beskeder fra appen.

@omtale eller /omtale bekræfter, at du har sendt beskeden til appen og ikke til andre i rummet.

1. Åbn appen Chat .
2. I et rum skal du skrive @github eller /github efterfulgt af kommandoen.
   • Når du omtaler @github eller /github, sendes beskeden til appen og ikke til andre i rummet.

Skift appindstillinger

Det er kun den bruger i rummet, der har tilføjet appen, som kan ændre indstillingerne.

1. Åbn Chat.
2. Åbn en direkte besked med appen, eller gå til et rum med appen.
3. Skriv /github_settings for at åbne de aktuelle indstillinger for appen.
4. Skift indstillingerne efter behov.
5. Klik på Gem.

Hvis du fjerner appen fra et rum, slettes appindstillingerne.

Få flere oplysninger om kommandoer til GitHub-appen i Chat

I beskedfeltet i en direkte besked eller et rum med GitHub-appen i Chat kan du bruge:

• Skråstregskommandoer:
  • /github_settings: Åbner dialogboksen med indstillinger.
  • /github_reminders: Konfigurer og rediger planlagte påmindelser for personlige eller åbne anmodninger om hentning fra teamet.
  • /github_subscribe: Abonnerer på et GitHub-lager <repoURL> eller <owner/repo>.
  • /github_openIssue: Åbner et nyt GitHub-problem.
  • /github_logout: Logger ud af din GitHub-konto.
  • /github_help: Viser hjælpebeskeden.
  • /github_feedback: Send feedback om GitHub-appen.
• Kvikkommandoer: Du kan få adgang til kvikkommandoerne ved at klikke på Google Workspace-værktøjer .
  • GitHub Connect: Viser en meddelelse med valgmulighederne "Log ind" og "Log ind med den gamle metode".
  • GitHub-godkendelse igen: Giver dig mulighed for at migrere til en ny tilknytningsmetode.

Sådan får du en komplet liste over understøttede kommandoer:

1. Åbn Chat på din computer.
2. Åbn en direkte besked, eller gå til et rum, hvor GitHub-appen er installeret.
3. Skriv: /github_help.

Find og løs problemer med GitHub-appen i Chat

Hvis du får en fejl, når du abonnerer på notifikationer i realtid

GitHub-app

Sådan konfigurerer du notifikationer i realtid i rum:

1. Gå til indstillingerne for GitHub-profilen i din browser.
2. Under "Integrationer" skal du klikke på Apps Godkendte GitHub-apps.
   • Når du har tilknyttet GitHub-appen i Google Chat, viser din liste over godkendte apps "Google Chat".
3. Installer Google Chat-appen til GitHub-lageret.
   • Du kan også anmode ejeren af organisationen/lageret om at installere appen.
4. Vent, indtil installationen er fuldført.
5. Åbn en direkte besked eller et rum med GitHub-appen i Google Chat.
6. I beskedfeltet skal du skrive følgende for at oprette et abonnement: /github_subscribe [organisation/repo] eller /github_settings.

OAuth-app

Hvis du vil konfigurere notifikationer i realtid i rum, skal du:

• Være organisationsejer af det foreslåede lager.
• Godkende appen i GitHub-organisationen.
  1. Gå til indstillingerne for GitHub-profilen i din browser.
  2. Under "Integrationer" skal du klikke på Apps Godkendte OAuth-apps.
     • Når du har tilknyttet GitHub-appen i Google Chat, viser din liste over godkendte apps "Google Chat".
  3. Giv appen adgang til den organisation, du vil have adgang til.

Hvis du modtager for mange notifikationer fra GitHub-appen

1. Skriv følgende i meddelelsesfeltet: /github_settings.
2. Klik på Indstillinger for notifikationer for at redigere dine indstillinger for notifikationer for lageret.
3. Du kan filtrere notifikationerne ved at klikke på menupilen ud for hver notifikationstype.
   • Den viser yderligere muligheder for at filtrere notifikationer.
4. Markér afkrydsningsfelterne ud for de notifikationer, du vil have.
5. Klik på Gem.

Hvis du ikke bliver @omtalt i planlagte påmindelser

Hvis du vil omtales i planlagte påmindelser, skal du have knyttet din Google Chat-konto til GitHub-kontoen.

1. Skriv følgende i meddelelsesfeltet: /github_settings.
2. Sådan tilknytter du din konto:
   1. I pop op-vinduet skal du klikke på Konfigurer adgang Log ind på GitHub.
   2. Log ind på din GitHub-konto.
   3. Godkend appen.
3. I den meddelelse, du modtager fra GitHub-appen, skal du vælge Planlæg påmindelser for dit team.
4. I pop op-vinduet:
   1. Klik på Opret en ny påmindelse.
   2. Konfigurer påmindelsesindstillingerne.
   3. Klik på Gem.

Hvis du ikke får påmindelser med GitHub-appen

Verificer installationen af Google Chat-appen til GitHub i det lager, hvorfra du vil modtage påmindelser.

_{Google, Google Workspace samt relaterede mærker og logoer er varemærker tilhørende Google LLC. Alle andre virksomheds- og produktnavne er varemærker tilhørende de virksomheder, de hver især er tilknyttet.}