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.
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.
Konfigurera GitHub-appen i Chat
- Öppna Chat-appen
.
- Öppna ett direktmeddelande i appen eller öppna ett rum med appen.
- Tryck på Logga in för att öppna konfigurationsfönstret.
- Tryck på Konfigurera åtkomst
Logga in på GitHub.
- Slutför inloggningsprocessen och stäng popup-fönstret.
- Tryck på Uppdatera för att uppdatera chattdialogrutan.
- Under Lägg till lagringsplatser skriver du GitHub-lagringsplatsen du vill få aviseringar för.
- Markera rutorna för de händelser du vill få aviseringar om.
- Tryck på Spara.
Logga in på GitHub.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:
- Öppna Chat-appen
- Öppna ett direktmeddelande eller rum med GitHub-appen.
- Tryck på Google Workspace-verktyg
i meddelandefältet.
- Välj GitHub Reauthorize i kommandolistan.
- Slutför migreringen och återauktoriseringen genom att följa anvisningarna på skärmen i chattdialogen.
i meddelandefältet.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.
- Öppna Chat-appen
- 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.
- Öppna Chat-appen
- Öppna ett direktmeddelande i appen eller öppna ett rum med appen.
- Om du vill öppna de aktuella inställningarna för appen anger du
/github_settings. - Ändra inställningarna efter behov.
- Tryck 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: Du kommer åt snabbkommandona genom att trycka på Google Workspace-verktyg
- 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:
- Öppna Chat-appen
- Öppna ett direktmeddelande eller gå till ett rum där GitHub-appen är installerad.
- Ange:
/github_help.
Felsöka problem med GitHub-appen i Chat
Om du får ett felmeddelande när du prenumererar på aviseringar i realtidGitHub-app
Så här ställer du in aviseringar i realtid i rum:
- Öppna inställningarna för GitHub-profilen i webbläsaren.
- Tryck på Appar
- När du har anslutit GitHub-appen i Google Chat visas Google Chat i listan över auktoriserade appar.
- Installera Google Chat-appen för GitHub-lagringsplatsen.
- Du kan även begära installation från organisations-/lagringsägaren.
- Vänta tills installationen är klar.
- Öppna ett direktmeddelande eller rum med GitHub-appen i Google Chat.
- Ange
/github_subscribe [organisation/repo]eller/github_settingsi 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.
- Öppna inställningarna för GitHub-profilen i webbläsaren.
- Tryck på Appar
- När du har anslutit GitHub-appen i Google Chat visas Google Chat i listan över auktoriserade appar.
- Ge appen åtkomst till organisationen du vill komma åt.
- Ange
/github_settingsi meddelandefältet. - Tryck på Aviseringsinställningar för att redigera inställningarna för aviseringar om lagringsplatsen.
- Om du vill filtrera aviseringarna trycker du på nedåtpilen
bredvid varje aviseringstyp.
- Här visas fler alternativ för att filtrera aviseringar.
- Markera rutorna för de aviseringar du vill ha.
- Tryck på Spara.
Om du vill bli omnämnd i schemalagda påminnelser måste du ha kopplat ditt Google Chat-konto till GitHub-kontot.
- Ange
/github_settingsi meddelandefältet. - Så här ansluter du kontot:
- Tryck på Konfigurera åtkomst
- Logga in på ditt GitHub-konto.
- Auktorisera appen.
- Tryck på Konfigurera åtkomst
- Välj Schedule reminders for your team i meddelandet du får från GitHub-appen.
- Gör följande i popup-fönstret:
- Tryck på Skapa ny påminnelse.
- Konfigurera påminnelseinställningarna.
- Tryck på Spara.
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.