Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der GitHub Server Issues Microsoft 365 Copilot Connector integriert GitHub-Problemdaten in Microsoft 365. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des GitHub Server Issues-Connectors beschrieben.
Informationen zur erweiterten GitHub-Konfiguration finden Sie unter Einrichten des GitHub-Diensts für die Connectorerfassung.
Voraussetzungen
Stellen Sie vor der Bereitstellung des GitHub Server Issues-Connectors sicher, dass die GitHub-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der GitHub-Umgebung und zum Bereitstellen des Connectors zusammengefasst:
| Aufgabe | Rolle |
|---|---|
| Konfigurieren der Umgebung | GitHub-Administrator |
| Bereitstellen des Connectors im Microsoft 365 Admin Center | Microsoft 365 Admin |
| Anpassen der Connectoreinstellungen (optional) | Microsoft 365 Admin |
Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Sie sind ein Microsoft 365-Administrator.
- Auf Ihre GitHub Enterprise Server-instance kann über die API zugegriffen werden.
- Eine GitHub-App wird für die Authentifizierung erstellt und installiert.
- Der Microsoft Graph-Connector-Agent wird auf einem Gerät mit Zugriff auf die GitHub-instance (Version 3.1.11.0 oder höher) installiert.
- Benutzer, die auf indizierte GitHub-Daten zugreifen, verfügen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.
Bereitstellen des Connectors
So fügen Sie den GitHub Server Issues Connector für Ihre organization hinzu:
- Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
- Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
- Wählen Sie in der Liste der verfügbaren Connectors GitHub Server Issues (GitHub-Serverprobleme) aus.
Festlegen des Anzeigenamens
Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugeordnete Element erkennen können. Sie können den Standardmäßigen Anzeigenamen für GitHub Server Issues akzeptieren oder den Wert so anpassen, dass ein Anzeigename verwendet wird, den Benutzer in Ihrem organization erkennen.
Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.
Festlegen instance URL
Geben Sie die instance URL Ihres GitHub Enterprise Servers ein. Diese URL ist die Stammdomäne Ihres internen GitHub-Servers. Beispiel: https://github.<your-domain>.com
Auswählen des Authentifizierungstyps
Der Connector unterstützt die folgenden Authentifizierungstypen:
- GitHub-App (im Namen des Benutzers): Empfohlen für die meisten Szenarien. Geben Sie Ihre Client-ID und den geheimen Clientschlüssel aus der GitHub-App ein, und autorisieren Sie den Zugriff.
- GitHub-App (Installation):Verwenden Sie einen privaten Schlüssel, der aus Ihrer GitHub-App generiert wird. Geben Sie die Client-ID und organization Namen ein, und laden Sie den privaten Schlüssel hoch. Beachten Sie, dass sich dieser Authentifizierungstyp derzeit in der Vorschauphase befindet. Wenden Sie sich an den Microsoft-Support, um diesen Authentifizierungstyp zu verwenden.
Informationen zum Erstellen einer GitHub-App finden Sie unter Verwenden einer benutzerdefinierten GitHub-App für die Authentifizierung.
Rollout
Um das Rollout für eine begrenzte Zielgruppe durchzuführen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, für die der Connector rollout ausgeführt werden soll. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der Copilot-Connector von GitHub Server Issues beginnt sofort mit der Indizierung von Inhalten.
In der folgenden Tabelle sind die Standardwerte aufgeführt, die beim Bereitstellen des Connectors festgelegt werden.
| Kategorie | Standardwert |
|---|---|
| Benutzer | Identitätszuordnung basierend auf GitHub-E-Mail, Anmeldung oder Name |
| Inhalt | Zeitbereichsfilter auf 365 Tage festgelegt |
| Synchronisieren | Inkrementelle Durchforstung alle 15 Minuten; vollständige Durchforstung täglich |
Um diese Werte anzupassen, wählen Sie Benutzerdefiniertes Setup aus. Weitere Informationen finden Sie unter Anpassen von Einstellungen.
Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.
Anpassen von Einstellungen (optional)
Sie können die Standardwerte für die GitHub Server Issues Connector-Einstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.
Anpassen von Benutzereinstellungen
Zugriffsberechtigungen
Konfigurieren Sie Zugriffsberechtigungen, um sicherzustellen, dass nur autorisierte Benutzer GitHub-Probleme in Copilot und Microsoft Search anzeigen können.
Zuordnen von Identitäten
Ordnen Sie GitHub-Benutzeridentitäten Microsoft Entra ID zu, um sicherzustellen, dass Berechtigungen ordnungsgemäß angewendet werden. Wählen Sie eine der folgenden Optionen für die Zuordnung aus:
- Email: Ordnet GitHub-E-Mails Microsoft Entra ID Benutzereigenschaften zu.
- Einloggen: Ordnet GitHub-Anmeldungen mit Microsoft Entra ID Benutzereigenschaften zu.
- Namen: Ordnet gitHub-Namen Microsoft Entra ID Benutzereigenschaften zu.
Wenn bei der direkten Zuordnung ein Fehler auftritt, verwenden Sie reguläre Ausdrücke (regex), um die Daten zu transformieren. Beispiel: [a-zA-Z0-9]+. Weitere Informationen finden Sie unter Zuordnen Microsoft Entra Identitäten.
Wenn der organization Administrator Standardberechtigungen für Mitglieder festlegt, um den Repositoryzugriff einzuschränken, berücksichtigt der Connector diese Einstellung. Benutzer können organization Repositorys nur anzeigen, wenn sie explizit als Mitarbeiter hinzugefügt werden.
Für Unternehmen, die das BYOU-Modell (anstelle von unternehmensverwalteten Benutzern) verwenden, muss jeder Benutzer die Berechtigung zum Freigeben des spezifischen Benutzeridentitätsfelds aktivieren, das für die Zuordnung in seinen GitHub-Kontoeinstellungen erforderlich ist, um die Identitätszuordnung zu ermöglichen.
Anpassen von Inhaltseinstellungen
Inhaltsfilter
Sie können einen Zeitbereichsfilter für den Connector konfigurieren. Die Standardeinstellung ist 365 Tage.
Eigenschaften verwalten
Überprüfen Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibungen und Zeitstempel.
Anpassen von Synchronisierungsintervallen
Sie können inkrementelle und vollständige Durchforstungen konfigurieren. Dies wird jedoch nur für gesamtstrukturübergreifende Umgebungen empfohlen.
- Die inkrementelle Durchforstung wird alle 15 Minuten ausgeführt.
- Vollständige Durchforstung wird täglich ausgeführt.
Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.