Freigeben über

Bereitstellen des GitHub Cloud Issues Microsoft 365 Copilot Connector

Der GitHub Cloud Issues Microsoft 365 Copilot Connector ermöglicht es Ihrem organization, GitHub-Probleme zu indizieren, damit sie in Microsoft 365 Copilot- und Microsoft Search-Umgebungen angezeigt werden können. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des Connectors im Microsoft 365 Admin Center 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 Cloud Issues-Connectors sicher, dass die GitHub Cloud-Umgebung in Ihrem organization konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der Umgebung und 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 GitHub Cloud Issues-Connectors Folgendes sicher:

  • Sie sind ein Microsoft 365-Administrator.
  • Ihre GitHub-Umgebung ist über die API konfiguriert und zugänglich.
  • Für die Authentifizierung mit den erforderlichen Berechtigungen wird ein GitHub-App erstellt.
  • Benutzer, die auf indizierte GitHub-Daten zugreifen, verfügen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.
  • Für unternehmensverwaltete Benutzer, die sich über einmaliges Anmelden (Single Sign-On, SSO) authentifizieren, werden Konten vor dem Setup angemeldet. Der GitHub-Authentifizierungsflow unterstützt SSO während der Konfiguration nicht.

Bereitstellen des Connectors

So fügen Sie den GitHub Cloud Issues Connector für Ihre organization hinzu:

  1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
  2. Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
  3. Wählen Sie in der Liste der verfügbaren Connectors GitHub Cloud Issues aus.

Festlegen des Anzeigenamens

Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, die zugeordnete Inhaltsquelle zu erkennen. Sie können den Standardmäßigen Anzeigenamen für GitHub Cloud Issues akzeptieren oder anpassen.

Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.

Auswählen des Authentifizierungstyps

Der Connector unterstützt die folgenden Authentifizierungstypen:

  • OAuth (empfohlen):So verwenden Sie die OAuth-Authentifizierung:

    • Installieren Sie die GitHub-App GitHub Issues im GitHub-organization.
    • Wählen Sie einen Anzeigenamen aus, mit dem Benutzer die Verbindung erkennen können.
    • Geben Sie Ihren organization Namen ein.
    • Wählen Sie Autorisieren aus, um sich anzumelden und Zugriff zu gewähren.

    Hinweis

    Diese Authentifizierungsmethode befindet sich derzeit in der Vorschauphase.

  • Angepasste GitHub-App (im Namen des Benutzers): Geben Sie Ihre Client-ID und ihren geheimen Clientschlüssel aus der GitHub-App ein, und autorisieren Sie den Zugriff.

  • Angepasste 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.

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. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der GitHub Cloud Issues-Connector 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 E-Mail
Inhalt Probleme, die mit Metadaten, Bezeichnungen und Zeitstempeln indiziert wurden
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, überprüfen Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center.

Anpassen von Einstellungen (optional)

Sie können die Standardwerte für die GitHub Cloud 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

Geben Sie an, welche Benutzer und Gruppen Zugriff auf indizierte GitHub-Inhalte haben.

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 anstelle von ENTERPRISE Managed Users (EMU) das BYOK-Modell (Bring Your Own Key) verwenden, muss jeder Benutzer die Berechtigung zum Freigeben des erforderlichen Identitätsfelds in seinen GitHub-Kontoeinstellungen aktivieren. Dieser Schritt stellt eine ordnungsgemäße Identitätszuordnung zwischen GitHub und dem Verzeichnis Ihrer organization sicher.

Anpassen von Inhaltseinstellungen

Auf der Registerkarte Inhalt können Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibungen und Zeitstempel überprüfen.

Inhaltsfilter

Sie können einen Zeitbereichsfilter für den Connector konfigurieren. Die Standardeinstellung ist 365 Tage.

Eigenschaften verwalten

Sie können der Datenquelle verfügbare Eigenschaften hinzufügen oder daraus entfernen, der Eigenschaft ein Schema zuweisen (durchsuchbar, abfragbar, abrufbar oder verfeinernd), die semantische Bezeichnung ändern und der Eigenschaft einen Alias hinzufügen. Der Connector indiziert standardmäßig die folgenden Eigenschaften.

Eigenschaft Semantische Bezeichnung Beschreibung Schemaattribute
title Position Problemtitel Searchable
description Inhalt Problembeschreibung Searchable
Etiketten Tags Problembezeichnungen Refinable
Zeitstempel Datum Erstellungs- und Aktualisierungstermine Sortierbar

Anpassen von Synchronisierungsintervallen

Konfigurieren Sie die vollständigen und inkrementellen Durchforstungssynchronisierungsintervalle. Im Folgenden sind die Standardwerte aufgeführt:

  • Inkrementelle Durchforstung: Alle 15 Minuten
  • Vollständige Durchforstung: Täglich

Sie können diese Intervalle an die Anforderungen Ihrer organization anpassen. Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Hinweis

Webhookunterstützung ist jetzt in der Vorschau verfügbar. Achten Sie darauf, die Webhooks-Berechtigungen (Lesen und Schreiben) sowohl auf Repository- als auch auf Organisationsebene festzulegen. Webhooks ermöglichen es Ihnen, die Vorteile der erweiterten Automatisierung und Echtzeitupdates zu nutzen, um eine nahtlose und reaktionsschnellere Integration zu gewährleisten.

Verwandte Inhalte

  • Last updated on