GitHub-App in Google Chat verwenden

Mit der GitHub App in Google Chat können Sie sich über GitHub-Ereignisse benachrichtigen lassen, beispielsweise über Probleme, Pull-Anfragen und Kommentare.

Hinweis

So verwenden Sie die GitHub App für Google Chat:

• Sie benötigen die entsprechende Berechtigung von Ihrem Google Workspace-Administrator, um Apps zu installieren.
• Fügen Sie die App zu Google Chat hinzu. Weitere Informationen
• Sie benötigen ein GitHub-Konto.
• Sie müssen die Google Chat App für Ihr GitHub-Repository installieren.

Authentifizierungsmechanismen für GitHub-Apps und OAuth-Apps

Hier werden die unterschiedlichen Merkmale und Betriebsmodelle von GitHub-Apps und OAuth-Apps beschrieben, die als primäre Mechanismen für die Integration von Drittanbieterdiensten in GitHub und den Zugriff auf GitHub-Ressourcen dienen. Ein umfassendes Verständnis dieser Unterschiede ist entscheidend, um ein optimales Sicherheitsniveau in einem Unternehmen aufrechtzuerhalten.

1. Vergleichsanalyse: Wichtige Unterschiede

Die grundlegenden Unterschiede zwischen den beiden Modellen liegen in der Identität, die für den Zugriff verwendet wird (das Hauptkonto), und im Mechanismus, der die Ressourcenautorisierung regelt.

Attribut	GitHub-App (empfohlene Anmeldung)	OAuth-App (Legacy-Anmeldung)
Prinzipalidentität	Dient als unabhängige Anwendungsidentität, die je nach Anwendungsfall unabhängig von einem Nutzer oder im Namen des autorisierenden Nutzers agiert.	Handelt im Namen des autorisierenden Nutzers und übernimmt dessen Berechtigungen.
Autorisierungsmodell	Feingranulare Berechtigungen (empfohlen): Hier wird das Prinzip der geringsten Berechtigung angewendet, das den Zugriff auf bestimmte Repositorys und Ressourcentypen ermöglicht. Beispiel: Nur Lesezugriff auf Metadaten.	Umfassende Bereiche: Der Zugriff wird durch umfassende Bereiche definiert, z. B. durch die Gewährung des Zugriffs auf alle Ressourcen, die für den autorisierenden Nutzer sichtbar sind.
Langlebigkeit von Anmeldedaten	Kurzlebige Tokens: Zugriffstokens haben eine begrenzte Lebensdauer (in der Regel 1 Stunde) und müssen häufig erneuert werden. Das Risiko im Falle eines Angriffs wird dadurch erheblich verringert.	Langlebige Tokens: Zugriffstokens bleiben bestehen, bis sie vom Nutzer manuell widerrufen werden. Dies stellt ein längeres Risiko dar.
Installationsanforderung	Muss von einem Administrator oder Organisationsinhaber installiert werden, um eine formale Verknüpfung mit dem Konto oder der Organisation herzustellen. Die Nutzung muss vom Nutzer für Anwendungsfälle autorisiert werden, in denen die App in seinem Namen agiert.	Muss von einem einzelnen Nutzer autorisiert werden, wobei der Zugriff direkt mit der Identität dieses Nutzers verknüpft wird.

Eine umfassendere Dokumentation finden Sie unter Unterschiede zwischen GitHub-Apps und OAuth-Apps.

2. Empfehlung

Gemäß den Best Practices für die Sicherheit wird der GitHub-App-Authentifizierungsmechanismus für alle Drittanbieter- und Organisationsintegrationen empfohlen. Dieses Modell erzwingt das Prinzip der geringsten Berechtigung und verwendet robuste, zeitlich begrenzte Anmeldedaten. Dadurch wird ein höherer Standard an Sicherheit und betrieblicher Stabilität als beim Modell mit delegierter Berechtigung von OAuth-Apps aufrechterhalten.

Installieren Sie die Google Chat App für GitHub-Repositories.

GitHub App in Google Chat einrichten

1. Öffnen Sie Google Chat.
2. Öffnen Sie eine Direktnachricht an die App oder rufen Sie einen Gruppenbereich auf, dem die App hinzugefügt wurde.
3. Klicken Sie auf Anmelden, um das Konfigurationsfenster zu öffnen.
4. Tippen Sie auf Zugriff konfigurieren Bei GitHub anmelden.
5. Schließen Sie den Anmeldevorgang ab und schließen Sie dann das Pop-up-Fenster.
6. Klicken Sie auf Aktualisieren, um das Chat-Dialogfeld zu aktualisieren.
7. Geben Sie unter Add Repositories (Repositories hinzufügen) das GitHub-Repository ein, für das Sie Benachrichtigungen erhalten möchten.
8. Klicken Sie die Kästchen neben den Ereignissen an, für die Sie Benachrichtigungen erhalten möchten.
9. Klicken Sie auf Speichern.

Tipp: Sie müssen Benachrichtigungen in jedem Gruppenbereich einrichten, dem Sie die App hinzufügen. Die App sendet Benachrichtigungen an alle Gruppenbereiche, in denen sie Mitglied ist.

Von OAuth-App (Legacy) zu GitHub-App (empfohlen) migrieren

So migrieren Sie Ihre aktuelle Verbindung von der älteren OAuth-App-Authentifizierungsmethode zur empfohlenen GitHub-App-Methode:

1. Öffnen Sie Google Chat.
2. Öffnen Sie eine Direktnachricht oder einen Gruppenbereich mit der GitHub App.
3. Klicken Sie im Nachrichtenfeld auf „Google Workspace-Tools“ .
4. Wählen Sie in der Befehlsliste GitHub Reauthorize (GitHub neu autorisieren) aus.
5. Folgen Sie der Anleitung auf dem Bildschirm im Chatdialog, um die Migration und die erneute Autorisierung abzuschließen.

GitHub App in Gruppenbereichen verwenden

Wenn Sie die App in Gruppenbereichen verwenden möchten, müssen Sie sie in jeder Nachricht und in Antworten auf Nachrichten der App @erwähnen oder /erwähnen.

Mit der @Erwähnung oder /Erwähnung wird bestätigt, dass Sie die Nachricht an die App und nicht an andere im Gruppenbereich senden.

1. Öffnen Sie die Google Chat App .
2. Geben Sie in einem Gruppenbereich @github oder /github gefolgt vom Befehl ein.
   • Wenn Sie @github oder /github erwähnen, wird die Nachricht an die App und nicht an andere im Gruppenbereich gesendet.

App-Einstellungen ändern

In Gruppenbereichen kann nur diejenige Person die Einstellungen ändern, die die App hinzugefügt hat.

1. Öffnen Sie Google Chat.
2. Öffnen Sie eine Direktnachricht an die App oder rufen Sie einen Gruppenbereich auf, dem die App hinzugefügt wurde.
3. Wenn Sie die aktuellen Einstellungen für die App aufrufen möchten, geben Sie /github_settings ein.
4. Ändern Sie die Einstellungen nach Bedarf.
5. Klicken Sie auf Speichern.

Wenn Sie die App aus einem Gruppenbereich entfernen, werden die App-Einstellungen gelöscht.

Befehle für die GitHub App in Google Chat

Im Nachrichtenfeld einer Direktnachricht oder eines Gruppenbereichs mit der GitHub-App in Chat können Sie Folgendes verwenden:

• Slash-Befehle:
  • /github_settings: Öffnet das Dialogfeld „Einstellungen“.
  • /github_reminders: Hiermit können Sie geplante Erinnerungen für persönliche oder Team-Pull-Anfragen einrichten und bearbeiten.
  • /github_subscribe: Hiermit können Sie ein GitHub-Repository <repoURL> oder <owner/repo> abonnieren.
  • /github_openIssue: Öffnet ein neues GitHub-Problem.
  • /github_logout: Meldet Sie von Ihrem GitHub-Konto ab.
  • /github_help: Hiermit wird die Hilfemeldung angezeigt.
  • /github_feedback: Feedback zur GitHub App senden.
• Schnellbefehle: Wenn Sie auf die Schnellbefehle zugreifen möchten, klicken Sie auf „Google Workspace-Tools“ .
  • GitHub Connect: Es wird eine Meldung mit den Optionen „Anmelden“ und „Alte Anmeldung“ angezeigt.
  • GitHub-Autorisierung erneuern: Ermöglicht die Migration zu einer neuen Verbindungsmethode.

So rufen Sie eine vollständige Liste der unterstützten Befehle auf:

1. Öffnen Sie Google Chat auf Ihrem Computer.
2. Öffnen Sie eine Direktnachricht oder rufen Sie einen Gruppenbereich auf, in dem die GitHub-App installiert ist.
3. Geben Sie /github_help ein.

Probleme mit der GitHub App in Google Chat beheben

Wenn beim Abonnieren von Echtzeitbenachrichtigungen ein Fehler auftritt

GitHub App

So richten Sie Echtzeitbenachrichtigungen in Bereichen ein:

1. Rufen Sie in Ihrem Browser die GitHub-Profileinstellungen auf.
2. Klicken Sie unter „Integrationen“ auf Anwendungen Autorisierte GitHub-Apps.
   • Nachdem Sie die GitHub-App in Google Chat verbunden haben, wird „Google Chat“ in Ihrer Liste der autorisierten Apps angezeigt.
3. Installieren Sie die Google Chat App für das GitHub-Repository.
   • Alternativ können Sie die Installation beim Inhaber der Organisation oder des Repositorys anfordern.
4. Warten Sie, bis die Installation abgeschlossen ist.
5. Öffnen Sie in Google Chat eine Direktnachricht oder einen Gruppenbereich mit der GitHub App.
6. Geben Sie im Nachrichtenfeld /github_subscribe [organisation/repo] oder /github_settings ein, um ein Abo zu erstellen.

OAuth-App

So richten Sie Echtzeitbenachrichtigungen in Bereichen ein:

• Sie müssen der Inhaber der Organisation des vorgeschlagenen Repositorys sein.
• Autorisieren Sie die App in der GitHub-Organisation.
  1. Rufen Sie in Ihrem Browser die GitHub-Profileinstellungen auf.
  2. Klicken Sie unter „Integrationen“ auf Anwendungen Autorisierte OAuth-Apps.
     • Nachdem Sie die GitHub-App in Google Chat verbunden haben, wird in Ihrer Liste der autorisierten Apps „Google Chat“ angezeigt.
  3. Gewähren Sie der App Zugriff auf die Organisation, auf die Sie zugreifen möchten.

Zu viele Benachrichtigungen von der GitHub-App

1. Geben Sie im Nachrichtenfeld /github_settings ein.
2. Klicken Sie auf Benachrichtigungseinstellungen, um die Benachrichtigungseinstellungen für das Repository zu bearbeiten.
3. Wenn Sie die Benachrichtigungen filtern möchten, klicken Sie neben den einzelnen Benachrichtigungstypen auf den Drop-down-Pfeil .
   • Es werden zusätzliche Optionen zum Filtern von Benachrichtigungen angezeigt.
4. Setzen Sie ein Häkchen in die Kästchen für die gewünschten Benachrichtigungen.
5. Klicken Sie auf Speichern.

Wenn Sie in geplanten Erinnerungen nicht @erwähnt werden

Damit Sie in geplanten Erinnerungen erwähnt werden, müssen Sie Ihr Google Chat-Konto mit dem GitHub-Konto verknüpft haben.

1. Geben Sie im Nachrichtenfeld /github_settings ein.
2. So verknüpfen Sie Ihr Konto:
   1. Klicken Sie im Pop-up-Fenster auf Zugriff konfigurieren Bei GitHub anmelden.
   2. Melden Sie sich in Ihrem GitHub-Konto an.
   3. Autorisieren Sie die App.
3. Wählen Sie in der Nachricht, die Sie von der GitHub-App erhalten, Schedule reminders for your team (Erinnerungen für Ihr Team planen) aus.
4. Im Pop-up-Fenster:
   1. Klicken Sie auf Neue Erinnerung erstellen.
   2. Konfigurieren Sie die Erinnerungseinstellungen.
   3. Klicken Sie auf Speichern.

Wenn Sie mit der GitHub App keine Erinnerungen erhalten

Prüfen Sie im Repository, aus dem Sie Erinnerungen erhalten möchten, die Installation der Google Chat App für GitHub.

Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der Unternehmen, mit denen sie verbunden sind.