Einrichten des GitHub-Diensts für die Erfassung des GitHub Cloud Issues-Connectors

Mit dem GitHub Cloud Issues Microsoft 365 Copilot Connector können Ihre organization in GitHub gespeicherte Probleme indizieren, um sie in Microsoft 365 Copilot- und Suchfunktionen verfügbar zu machen. Dieser Artikel enthält Informationen zu den Konfigurationsschritten, die GitHub-Administratoren ausführen müssen, bevor Ihr organization den GitHub Cloud Issues Connector bereitstellt.

Informationen zum Bereitstellen des Connectors finden Sie unter Bereitstellen des GitHub Issues-Connectors.

Prüfliste für das Setup

Die folgende Prüfliste enthält die Schritte zum Konfigurieren der Umgebung und Einrichten der Connectorvoraussetzungen.

Identifizieren des GitHub-organization Namens

Bestimmen Sie, welche GitHub-organization Sie beim Einrichten des Connectors indizieren möchten.

Sicherstellen des API-Zugriffs auf das GitHub-Ziel instance

Vergewissern Sie sich, dass auf Ihre GitHub-instance über die API zugegriffen werden kann.

Identifizieren von Entra-ID-Zuordnungsregeln

Definieren Sie die Entra ID-Zuordnungsregeln. Stellen Sie sicher, dass Benutzer, die auf die indizierten GitHub-Daten zugreifen, über entsprechende Entra-ID-Identitäten verfügen, um eine genaue Berechtigungszuordnung zu ermöglichen.

Anmelden beim GitHub-Konto

Stellen Sie für unternehmensverwaltete Benutzer, die sich über einmaliges Anmelden (Single Sign-On, SSO) authentifizieren, sicher, dass das Konto angemeldet ist, bevor Sie Setupaktionen ausführen. Derzeit unterstützt der GitHub-Authentifizierungsflow während der Konfiguration keine SSO-basierte Anmeldung.

Verwenden einer benutzerdefinierten GitHub-App für die Authentifizierung (optional)

Verwenden Sie die von Microsoft verwaltete GitHub-App, um die optimale Einrichtung zu erzielen.

Sie können auch Ihre eigene GitHub-App für die Authentifizierung verwenden. Wenn Sie diese Option auswählen, führen Sie die Schritte in der folgenden Prüfliste aus, um das Setup abzuschließen.

Erstellen und Konfigurieren der GitHub-App

So erstellen Sie eine GitHub-App für die Verwendung mit dem GitHub Cloud Issues Connector:

1. Wählen Sie in GitHub oben rechts Ihre Profilfoto aus, wählen Sie Ihre Organisationen und dann die organization aus, aus der der Connector Daten pullen soll.

2. Wählen Sie auf der Seite organization Übersicht die Option Einstellungen aus.

3. Scrollen Sie in der linken Randleiste nach unten zu Entwicklereinstellungen , und wählen Sie GitHub Apps aus.

4. Wählen Sie Neue GitHub-App aus.

5. Konfigurieren Sie die App:

   • GitHub-App-Name: Geben Sie den Namen Ihrer Wahl ein.
   • Homepage-URL: Kopieren Sie die URL aus der Adressleiste Ihres Browsers.
   • Rückruf-URL:
     • Für Microsoft 365 enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
     • Für Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

   

6. Deaktivieren Sie die Option Webhook .

7. Legen Sie die folgenden Berechtigungen fest:

   Repositoryberechtigungen

   • Verwaltung – Schreibgeschützt
   • Metadaten – Schreibgeschützt
   • Probleme – Schreibgeschützt
   • Webhooks – Lesen und Schreiben

   Berechtigungen für die Organisation

   • Verwaltung – Schreibgeschützt
   • Member – Schreibgeschützt
   • Webhooks – Lesen und Schreiben

   Kontoberechtigungen

   • Email Adressen – Schreibgeschützt

8. Wählen Sie unter Wo kann diese GitHub-App installiert werden, die Option Beliebiges Konto und dann GitHub-App erstellen aus.

Erstellen von Anmeldeinformationen für die GitHub-App

• Wählen Sie auf der Seite Allgemein der GitHub-App die Option Neuen geheimen Clientschlüssel generieren aus, um den geheimen Clientschlüssel zu generieren und zu kopieren.

  

Installieren des GitHub-App

1. Wählen Sie auf der Seite Allgemein der GitHub-App Die Option App installieren aus.

   

2. Wählen Sie die organization aus, in der Sie die App installieren möchten.

   

Konfigurieren von Firewalleinstellungen

Um die Sicherheit zu erhöhen, können Sie IP-Firewallregeln für Ihre Azure SQL Server oder Datenbank konfigurieren. Weitere Informationen finden Sie unter IP-Firewallregeln.

Fügen Sie die folgenden Client-IP-Adressbereiche in den Firewalleinstellungen hinzu.

IP-Einschränkungen können dazu führen, dass der Connector nicht mehr funktioniert und zu Durchforstungsfehlern führt. Um dieses Problem zu beheben, fügen Sie die IP-Adresse des Connectors zur Positivliste hinzu.

Nächster Schritt