Använda GitHub-appen i Google Chat

Använd GitHub-appen i Google Chat om du vill få aviseringar om GitHub-händelser, till exempel problem, hämtningsbegäranden och kommentarer.

Innan du börjar

Så här använder du GitHub-appen för Chat:

• Du behöver behörighet att installera appar från Google Workspace-administratören.
• Lägg till appen i Chat. Läs om att hitta appar och lägga till dem i Chat.
• Du behöver ett GitHub-konto.
• Du måste installera Google Chat-appen för din GitHub-lagringsplats.

Förstå autentiseringsmekanismer för GitHub-appar och OAuth-appar

Här beskriver vi de olika egenskaperna och driftsmodellerna för GitHub-appar och OAuth-appar, som är de primära mekanismerna för att tjänster från tredje part ska kunna integreras med och få åtkomst till GitHub-resurser. En omfattande förståelse för dessa skillnader är avgörande för att upprätthålla en optimal säkerhetsnivå inom en organisation.

1. Jämförande analys: Viktiga skillnader

De grundläggande skillnaderna mellan de två modellerna ligger i identiteten som används för åtkomst (huvudkontot) och mekanismen som styr resursauktoriseringen.

Attribut	GitHub-appen (rekommenderad inloggning)	OAuth-app (äldre inloggning)
Huvudidentitet	Fungerar som en oberoende programidentitet, separat från alla användare eller på uppdrag av den auktoriserande användaren, beroende på användningsfallet.	Agerar på uppdrag av den auktoriserande användaren och ärver hens behörigheter.
Auktoriseringsmodell	Detaljerade behörigheter (rekommenderas): Använder principen om lägsta behörighet, vilket ger åtkomst till specifika lagringsplatser och resurstyper. Exempel: Läsbehörighet endast för metadata.	Breda omfattningar: Åtkomst definieras av breda omfattningar, till exempel genom att bevilja åtkomst till alla resurser som är synliga för den auktoriserande användaren.
Användaruppgifternas livslängd	Kortlivade tokens: Åtkomsttokens har en begränsad livslängd (vanligtvis en timme) och måste förnyas ofta, vilket avsevärt minskar risken i händelse av intrång.	Tokens med lång livslängd: Åtkomsttokens finns kvar tills de återkallas manuellt av användaren, vilket innebär en långvarig exponeringsrisk.
Installationskrav	Måste installeras av en administratör eller organisationsägare, vilket skapar en formell länk till kontot eller organisationen och auktoriseras av användaren för användningsfall där appen agerar på användarens vägnar.	Måste vara auktoriserad av en enskild användare och länka åtkomsten direkt till användarens identitet.

Mer omfattande dokumentation finns i Skillnader mellan GitHub-appar och OAuth-appar.

2. Rekommendation

Baserat på rekommenderade metoder för säkerhet rekommenderas autentiseringsmekanismen för GitHub-appen för alla integrationer från tredje part och organisationer. Den här modellen tillämpar principen om lägsta behörighet och använder robusta, tidsbegränsade användaruppgifter, vilket ger en högre standard för säkerhet och driftsstabilitet jämfört med modellen för delegerad behörighet i OAuth-appar.

Installera Google Chat-appen för GitHub-lagringsplatser.

Konfigurera GitHub-appen i Chat

1. Öppna Chat.
2. Öppna ett direktmeddelande i appen eller öppna ett rum med appen.
3. Klicka på Logga in för att öppna konfigurationsfönstret.
4. Klicka på Konfigurera åtkomst Logga in på GitHub.
5. Slutför inloggningsprocessen och stäng popup-fönstret.
6. Klicka på Uppdatera för att uppdatera chattdialogrutan.
7. Under Lägg till lagringsplatser skriver du GitHub-lagringsplatsen du vill få aviseringar för.
8. Markera rutorna för de händelser du vill få aviseringar om.
9. Klicka på Spara.

Tips! Du måste konfigurera aviseringar i varje rum där du lägger till appen. Appen skickar aviseringar till alla rum där den är medlem.

Migrera från OAuth-appen (äldre) till GitHub-appen (rekommenderas)

Så här migrerar du din nuvarande anslutning från den äldre autentiseringsmetoden för OAuth-appar till den rekommenderade metoden för GitHub-appar:

1. Öppna Chat.
2. Öppna ett direktmeddelande eller rum med GitHub-appen.
3. Klicka på Google Workspace-verktyg i meddelandefältet.
4. Välj GitHub Reauthorize i kommandolistan.
5. Slutför migreringen och återauktoriseringen genom att följa anvisningarna på skärmen i chattdialogen.

Använda GitHub-appen i rum

Om du vill använda appen i rum måste du @omnämna eller /omnämna appen i varje meddelande och i svar på meddelanden från appen.

@omnämnandet eller /omnämnandet bekräftar att du har skickat meddelandet till appen och inte till andra i rummet.

1. Öppna Chat-appen .
2. Skriv @github eller /github följt av kommandot i ett rum.
   • När du omnämner @github eller /github skickas meddelandet till appen och inte till andra i rummet.

Ändra appinställningar

I rum får endast personen som har lagt till appen ändra inställningarna.

1. Öppna Chat.
2. Öppna ett direktmeddelande i appen eller öppna ett rum med appen.
3. Öppna de aktuella inställningarna för appen genom att ange /github_settings.
4. Ändra inställningarna efter behov.
5. Klicka på Spara.

Om du tar bort appen från ett rum raderas appinställningarna.

Läs mer om kommandon för GitHub-appen i Chat

I meddelandefältet i ett direktmeddelande eller rum med GitHub-appen i Chat kan du använda

• Snedstreckskommandon:
  • /github_settings: Öppnar dialogrutan för inställningar.
  • /github_reminders: Ställ in och redigera schemalagda påminnelser för personliga eller teambaserade öppna pull-begäranden.
  • /github_subscribe: Prenumererar på en GitHub-lagringsplats <repoURL> eller <owner/repo>.
  • /github_openIssue: Öppnar ett nytt GitHub-problem.
  • /github_logout: Loggar ut från ditt GitHub-konto.
  • /github_help: Visar hjälpmeddelandet.
  • /github_feedback: Skicka feedback om GitHub-appen.
• Snabbkommandon: Klicka på Google Workspace-verktyg för att komma åt snabbkommandona.
  • GitHub Connect: Visar ett meddelande med alternativen Logga in och Äldre inloggning.
  • GitHub Reauthorize: Gör att du kan migrera till en ny anslutningsmetod.

Så här får du en fullständig lista över kommandon som stöds:

1. Öppna Chat på datorn.
2. Öppna ett direktmeddelande eller gå till ett rum där GitHub-appen är installerad.
3. Ange: /github_help.

Felsöka problem med GitHub-appen i Chat

Om du får ett felmeddelande när du prenumererar på aviseringar i realtid

GitHub-app

Så här ställer du in aviseringar i realtid i rum:

1. Öppna inställningarna för GitHub-profilen i webbläsaren.
2. Klicka på Appar Auktoriserade GitHub-appar under Integreringar.
   • När du har anslutit GitHub-appen i Google Chat visas Google Chat i listan över auktoriserade appar.
3. Installera Google Chat-appen för GitHub-lagringsplatsen.
   • Du kan även begära installation från organisations-/lagringsägaren.
4. Vänta tills installationen är klar.
5. Öppna ett direktmeddelande eller rum med GitHub-appen i Google Chat.
6. Ange /github_subscribe [organisation/repo] eller /github_settings i meddelandefältet för att skapa en prenumeration.

OAuth-app

Så här konfigurerar du aviseringar i realtid i rum:

• vara organisationsägare till den föreslagna lagringsplatsen
• Auktorisera appen i GitHub-organisationen.
  1. Öppna inställningarna för GitHub-profilen i webbläsaren.
  2. Klicka på Appar Auktoriserade OAuth-appar under Integreringar.
     • När du har anslutit GitHub-appen i Google Chat visas Google Chat i listan över auktoriserade appar.
  3. Ge appen åtkomst till organisationen du vill komma åt.

Om du får för många aviseringar från GitHub-appen

1. Ange /github_settings i meddelandefältet.
2. Klicka på Aviseringsinställningar om du vill redigera inställningarna för aviseringar för lagringsplatsen.
3. Klicka på nedåtpilen bredvid varje aviseringstyp för att filtrera aviseringarna.
   • Här visas fler alternativ för att filtrera aviseringar.
4. Markera rutorna för de aviseringar du vill ha.
5. Klicka på Spara.

Om du inte blir @omnämns i schemalagda påminnelser

Om du vill bli omnämnd i schemalagda påminnelser måste du ha kopplat ditt Google Chat-konto till GitHub-kontot.

1. Ange /github_settings i meddelandefältet.
2. Så här ansluter du kontot:
   1. Klicka på Konfigurera åtkomst Logga in på GitHub i popup-fönstret.
   2. Logga in på ditt GitHub-konto.
   3. Auktorisera appen.
3. Välj Schedule reminders for your team i meddelandet du får från GitHub-appen.
4. Gör följande i popup-fönstret:
   1. Klicka på Skapa ny påminnelse.
   2. Konfigurera påminnelseinställningarna.
   3. Klicka på Spara.

Om du inte får påminnelser med GitHub-appen

Verifiera installationen av Google Chat-appen för GitHub på lagringsplatsen där du vill få påminnelser.

_{Google, Google Workspace och relaterade märken och logotyper är varumärken som tillhör Google LLC. Alla andra företags- och produktnamn är varumärken som tillhör de företag som de är kopplade till.}