Bereitstellen des connectors für Azure DevOps-Arbeitselemente Microsoft 365 Copilot

Der Azure DevOps-Arbeitselemente-Connector indiziert Arbeitselemente wie User Storys, Aufgaben, Fehler und Features aus Ihrem Azure DevOps Services organization in Microsoft 365. In diesem Leitfaden werden die Schritte zum Bereitstellen und Anpassen des Connectors beschrieben.

Informationen zur Azure DevOps-Konfiguration finden Sie unter Einrichten der Azure DevOps-Umgebung für die Connectorerfassung.

Voraussetzungen

Stellen Sie vor der Bereitstellung des Azure DevOps-Arbeitselemente-Connectors sicher, dass die Azure DevOps-Umgebung in Ihrem organization konfiguriert ist und die folgenden Voraussetzungen erfüllt sind:

• Sie müssen ein Microsoft 365-Administrator sein.
• Sie haben die Azure DevOps-organization identifiziert, die indiziert werden soll.
• Sie haben ein Durchforstungskonto in Azure DevOps konfiguriert, das mindestens über die erforderlichen Leseberechtigungen für alle zu indizierten Projekte und Bereichspfade verfügt.
• Sie haben eine Anwendung in Microsoft Entra ID mit delegierten Azure DevOps-REST-API-Berechtigungen erstellt.
• Sie haben einen geheimen Clientschlüssel für die Microsoft Entra-App für die OAuth-basierte Authentifizierung generiert.

Bereitstellen des Connectors

So fügen Sie den Azure DevOps-Arbeitselemente-Connector für Ihre organization hinzu:

1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
2. Wählen Sie die Registerkarte Katalog aus.
3. Wählen Sie in der Liste der verfügbaren Connectors Azure DevOps-Arbeitselemente aus.

Festlegen des Anzeigenamens

Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Inhaltsquelle erkennen können. Sie können den Standardanzeigenamen Azure DevOps-Arbeitselemente übernehmen oder ihn an Ihre organization anpassen.

Festlegen instance URL

Geben Sie den Namen Ihres Azure DevOps-organization an. Der name Azure DevOps organization ist das Segment nach https://dev.azure.com/. Zum Beispiel:

• URL: https://dev.azure.com/contoso
• Organisation: contoso

Es ist nur der organization Name erforderlich. Geben Sie nicht die vollständige URL an.

Auswählen des Authentifizierungstyps

Um Arbeitselemente aus Azure DevOps zu synchronisieren, wählen Sie eine der unterstützten Authentifizierungsmethoden aus, und schließen Sie die erforderliche Einrichtung ab:

• Verbundanmeldeinformationen (empfohlen): Verwendet einen Dienstprinzipal zum Durchforsten von Inhalten.
• Microsoft Entra ID OAuth: Verwendet das angemeldete Microsoft 365-Administratorkonto.

Verbundanmeldeinformationen (empfohlen)

Verbundanmeldeinformationen verwenden eine von Microsoft veröffentlichte Unternehmensanwendung als Durchforstungsdienstkonto. Sie müssen diesem Dienstprinzipal die erforderlichen Berechtigungen in Azure DevOps gewähren.

Vergewissern Sie sich, dass die Dienstprinzipal-App bereitgestellt wurde.

1. Wechseln Sie zum Microsoft Entra Admin Center.
2. Suchen Sie nach Graph Connector-Verbundanmeldeinformations-App , oder verwenden Sie die App-ID: 933838e2-bec1-440f-a634-9363c82e5b6d.
3. Wenn die App nicht bereitgestellt wird, öffnen Sie die Seite Copilot-Connectors im Microsoft 365 Admin Center. Die Bereitstellung kann mehrere Stunden dauern.

Gewähren des Zugriffs auf Azure DevOps-Projekte für die Microsoft Entra-App

Gewähren Sie dem Dienstprinzipal Zugriff auf die Azure DevOps-Projekte, die Sie indizieren möchten.

1. Wechseln Sie zu Azure DevOps, und wählen Sie die organization aus.
2. Wählen Sie Organisationseinstellungen aus.
3. Wählen Sie im linken Bereich unter Allgemein die Option Benutzer aus.
4. Wählen Sie Benutzer hinzufügen aus.
5. Geben Sie unter Benutzer oder Dienstprinzipale die App-ID ein: 933838e2-bec1-440f-a634-9363c82e5b6d.
6. Weisen Sie die Zugriffsebene Basic zu, wählen Sie die zu indizierenden Projekte aus, und fügen Sie die App der Gruppe Projektadministratoren (oder einer entsprechenden Gruppe) hinzu. Deaktivieren Sie die Option zum Senden einer E-Mail-Einladung.

Konfigurieren der Authentifizierung mit Verbundanmeldeinformationen

Wählen Sie Verbundanmeldeinformationen als Authentifizierungstyp aus, und authentifizieren Sie sich, wenn Sie dazu aufgefordert werden.

Microsoft Entra ID OAuth

Microsoft Entra ID OAuth verwendet das angemeldete Microsoft 365-Administratorkonto als Durchforstungsdienstkonto. Damit der Connector auf Azure DevOps zugreifen und Arbeitselemente aktualisieren kann, erteilen Sie die erforderlichen Berechtigungen.

Vergewissern Sie sich, dass Ihr Azure DevOps-organization mit Microsoft Entra

Der Connector kann nur Arbeitselemente aus einem Azure DevOps-organization indizieren, das mit dem Microsoft Entra ID Ihres Mandanten verknüpft ist.

1. Wechseln Sie zu Azure DevOps, und wählen Sie die organization aus.
2. Wählen Sie Organisationseinstellungen aus.
3. Wählen Sie im linken Bereich unter Allgemein die Option Microsoft Entra aus.
4. Vergewissern Sie sich, dass die organization mit dem Microsoft Entra Konto Ihres Mandanten verbunden ist.

Erstellen einer App in Microsoft Entra ID

1. Melden Sie sich mit Administratoranmeldeinformationen beim Azure-Portal an.
2. Wechseln Sie zu Microsoft Entra ID>Identity>Applications>App-Registrierungen, und wählen Sie dann Neue Registrierung aus.
3. Geben Sie einen Namen für die App ein, und wählen Sie Registrieren aus.
4. Notieren Sie sich die Anwendungs-ID (Client-ID). Sie verwenden sie, um Projektzugriff in Azure DevOps zu gewähren.
5. Öffnen Sie API-Berechtigungen, und wählen Sie Berechtigung hinzufügen aus.
6. Wählen Sie Azure DevOps>Delegierte Berechtigungen aus.
7. Fügen Sie die folgenden vso-Berechtigungen hinzu:
   • vso.analytics – Analytics (lesen)
   • vso.graph – Microsoft Graph (lesen)
   • vso.identity – Identität (lesen)
   • vso.project – Projekt und Team (lesen)
   • vso.variablegroups_read – Variablengruppen (lesen)
   • vso.work – Arbeitselemente (lesen)
8. Wählen Sie Administratoreinwilligung für <TenantName> erteilen und bestätigen Aus.
9. Vergewissern Sie sich, dass alle Berechtigungen als Gewährt angezeigt werden.
10. Öffnen Sie Authentifizierung, und wählen Sie Plattformweb> hinzufügen aus. Fügen Sie eine der folgenden Umleitungs-URIs hinzu:
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
11. Aktivieren Sie unter Implizite Genehmigung und HybridflowsID-Token , und wählen Sie Konfigurieren aus.
12. Wechseln Sie zu Zertifikate und Geheimnisse, und wählen Sie dann Neuer geheimer Clientschlüssel aus. Wählen Sie einen Ablaufzeitraum aus, und speichern Sie den generierten Geheimniswert.
13. Verwenden Sie den geheimen Clientschlüssel und die Anwendungs-ID , wenn Sie den Connector konfigurieren.

Authentifizieren der Microsoft Entra-App mit einem Durchforstungskonto

Die App verwendet einmaliges Anmelden, um sich mit dem angemeldeten Microsoft 365-Administratorkonto zu authentifizieren. Microsoft Entra ID stellt ein Zugriffstoken aus, das die dem Benutzer gewährten delegierten Berechtigungen enthält. Der Connector kann nur auf Daten zugreifen und Aktionen ausführen, für die der authentifizierte Benutzer autorisiert ist.

Rollout

Um den Connector für eine begrenzte Zielgruppe bereitzustellen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer oder Gruppen an, für die der Connector rollout ausgeführt werden soll. Dadurch können Sie den Connector vor einer vollständigen Bereitstellung überprüfen. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der Azure DevOps-Arbeitselemente-Connector beginnt sofort mit der Indizierung von Inhalten.

In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden.

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 Standardeinstellungen für den Azure DevOps-Arbeitselemente-Connector anpassen, indem Sie auf der Connectorseite Benutzerdefinierte Einrichtung auswählen.

Anpassen von Benutzereinstellungen

Zugriffsberechtigungen

Der Azure DevOps-Arbeitselemente-Connector unterstützt die folgenden Suchberechtigungen:

• Für alle sichtbar
• Nur Personen mit Zugriff auf diese Datenquelle

Wenn Sie Für alle sichtbar auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden in den Suchergebnissen für Benutzer, die Zugriff darauf haben, indizierte Daten angezeigt.

Zuordnen von Identitäten

Die Identitätszuordnung stellt sicher, dass Azure DevOps-Identitäten ordnungsgemäß Microsoft Entra ID Benutzern zugeordnet werden. Der Connector verwendet delegierten Zugriff und richtet Identitäten automatisch über das angemeldete Microsoft 365-Administratorkonto aus.

Anpassen von Inhaltseinstellungen

Eigenschaften verwalten

Sie können Ihrer Azure DevOps-Datenquelle Eigenschaften hinzufügen oder daraus entfernen, der Eigenschaft ein Schema zuweisen (definieren, ob eine Eigenschaft durchsuchbar, abfragbar, abrufbar oder verfeinernd ist), die semantische Bezeichnung ändern und der Eigenschaft einen Alias hinzufügen. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die standardmäßig indiziert sind.

Anpassen von Synchronisierungsintervallen

Sie können anpassen, wie häufig der Connector Ihre Azure DevOps-organization durchforstet. Die folgenden Synchronisierungsintervalle sind verfügbar:

• Vollständige Durchforstung: Durchforstet das gesamte Azure DevOps-Dataset.
• Inkrementelle Durchforstung: Durchforstet nur aktualisierte Elemente erneut.

Die Standardsynchronisierungseinstellungen sind für die meisten Organisationen optimiert.

Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Verwandte Inhalte

• Übersicht über Azure DevOps-Arbeitselementeconnectors
• Behandeln von Problemen mit dem Azure DevOps Work Items Connector
• Einrichten von Copilot-Connectors im Microsoft 365 Admin Center