Microsoft Graph-Connector für Azure DevOps-Arbeitselemente
Mit dem Azure DevOps Graph-Connector kann Ihre Organisation Arbeitselemente in der Instanz des Azure DevOps-Diensts indizieren. Nachdem Sie den Connector und den Indexinhalt aus Azure DevOps konfiguriert haben, können Endbenutzer in Microsoft Search nach diesen Elementen suchen.
Hinweis
Lesen Sie den Artikel Setup für Ihren Microsoft Graph-Connector , um die allgemeinen Anweisungen zum Einrichten von Connectors zu verstehen.
Dieser Artikel richtet sich an alle Benutzer, die einen Azure DevOps-Connector konfigurieren, ausführen und überwachen. Es ergänzt den allgemeinen Einrichtungsprozess und zeigt Anweisungen, die nur für diesen Connector gelten.
Wichtig
Der Azure DevOps-Connector unterstützt nur den Azure DevOps-Clouddienst. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 und TFS 2013 werden von diesem Connector nicht unterstützt.
Bevor Sie beginnen
Sie müssen der Administrator für den M365-Mandanten Ihrer Organisation sowie der Administrator für die Azure DevOps-Instanz Ihrer Organisation sein.
Damit der Connector eine Verbindung mit Ihrer Azure DevOps-Organisation herstellen kann, müssen Sie den Anwendungszugriff von Drittanbietern über OAuth aktivieren. Weitere Informationen finden Sie in der Azure DevOps-Dokumentation zum Verwalten von Sicherheitsrichtlinien .
Sie benötigen die folgenden Berechtigungen, die dem Benutzerkonto gewährt werden, dessen Anmeldeinformationen während der Connectorkonfiguration verwendet werden:
| Berechtigungsname | Berechtigungstyp | Erforderlich für |
|---|---|---|
| Anzeigen von Informationen auf Projektebene | Projektberechtigung | Durchforsten von Azure DevOps-Arbeitselementen. Diese Berechtigung ist für die Projekte obligatorisch , die indiziert werden müssen. |
| Anzeigen von Analysen | Projektberechtigung | Durchforsten von Azure DevOps-Arbeitselementen. Diese Berechtigung ist für die Projekte obligatorisch , die indiziert werden müssen. |
| Anzeigen von Arbeitselementen in diesem Knoten | Bereichspfad | Durchforsten von Arbeitselementen in einem Bereichspfad. Diese Berechtigung ist optional. Es werden nur die Bereichspfade durchforstet, für die das Benutzerkonto über Berechtigungen verfügt. |
Wichtig
Das Benutzerkonto muss über die Zugriffsebene "Basic " verfügen. Weitere Informationen zu Zugriffsebenen in Azure DevOps finden Sie unter Unterstützte Zugriffsebenen.
Schritt 1: Hinzufügen eines Connectors im Microsoft 365 Admin Center
Hinzufügen des Azure DevOps-Connectors
(Weitere Informationen finden Sie in den allgemeinen Setupanweisungen .)
Schritt 2: Benennen der Verbindung
Befolgen Sie die allgemeinen Setupanweisungen.
Schritt 3: Konfigurieren der Verbindungseinstellungen
Um eine Verbindung mit Ihrer Azure DevOps-Instanz herzustellen, benötigen Sie den Namen Ihrer Azure DevOps-Organisation, die zugehörige App-ID und den geheimen Clientschlüssel für die OAuth-Authentifizierung.
Registrieren einer App
Registrieren Sie eine App in Azure DevOps, damit die Microsoft Search-App auf die Instanz zugreifen kann. Weitere Informationen finden Sie in der Azure DevOps-Dokumentation zum Registrieren einer App.
Die folgende Tabelle enthält Anleitungen zum Ausfüllen des App-Registrierungsformulars:
| Pflichtfelder | Beschreibung | Empfohlener Wert |
|---|---|---|
| Firmenname | Der Name Ihres Unternehmens. | Verwenden eines geeigneten Werts |
| Name der Anwendung | Ein eindeutiger Wert, der die anwendung identifiziert, die Sie autorisieren. | Microsoft Search |
| Anwendungswebsite | Die URL der Anwendung, die während der Einrichtung des Connectors Zugriff auf Ihre Azure DevOps-Instanz anzufordern. (Erforderlich). | Für M365 Enterprise: https:// gcs.office.com/, Für M365 Government: https:// gcsgcc.office.com/ |
| Autorisierungsrückruf-URL | Eine erforderliche Rückruf-URL, an die der Autorisierungsserver umleitet. | Für M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, Für M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback |
| Autorisierte Bereiche | Der Zugriffsbereich für die Anwendung | Wählen Sie die folgenden Bereiche aus: Identität (Lesen), Arbeitselemente (lesen), Variablengruppen (lesen), Projekt und Team (lesen), Graph (lesen), Analyse (lesen) |
Wichtig
Die autorisierten Bereiche, die Sie für die App auswählen, sollten genau wie oben aufgeführt mit den Bereichen übereinstimmen. Wenn Sie einen der autorisierten Bereiche in der Liste weglassen oder einen anderen Bereich hinzufügen, schlägt die Autorisierung fehl.
Wenn Sie die App mit den obigen Details registrieren, erhalten Sie die App-ID und den geheimen Clientschlüssel , die zum Konfigurieren des Connectors verwendet werden.
Hinweis
Um den Zugriff auf alle in Azure DevOps registrierten Apps zu widerrufen, wechseln Sie rechts oben in Ihrer Azure DevOps-Instanz zu Benutzereinstellungen. Wählen Sie Profil und dann autorisierungen im Abschnitt Sicherheit des Seitenbereichs aus. Zeigen Sie auf eine autorisierte OAuth-App, um die Schaltfläche Widerrufen in der Ecke der App-Details anzuzeigen.
Verbindungseinstellungen
Nachdem Sie die Microsoft Search-App bei Azure DevOps registriert haben, können Sie den Schritt mit den Verbindungseinstellungen ausführen. Geben Sie den Namen Ihrer Organisation, die App-ID und den geheimen Clientschlüssel ein.
Konfigurieren von Daten: Auswählen von Projekten und Feldern
Sie können für die Verbindung auswählen, um entweder die gesamte Organisation oder bestimmte Projekte zu indizieren.
Wenn Sie die gesamte Organisation indizieren, werden Elemente in allen Projekten in der Organisation indiziert. Neue Projekte und Elemente werden während der nächsten Durchforstung nach ihrer Erstellung indiziert.
Wenn Sie einzelne Projekte auswählen, werden nur Arbeitselemente in diesen Projekten indiziert.
Hinweis
Azure DevOps-Projekte können durchforstet werden, nachdem ihnen die Berechtigungen Informationen auf Projektebene anzeigen und Analyse anzeigen erteilt wurden.
Wählen Sie als Nächstes aus, welche Felder die Verbindung indizieren und eine Vorschau der Daten in diesen Feldern anzeigen soll, bevor Sie fortfahren.
Schritt 4: Verwalten von Suchberechtigungen
Der Azure DevOps-Connector unterstützt Suchberechtigungen, die für Nur Personen mit Zugriff auf diese Datenquelle oder Jeder sichtbar sind. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die Basierend auf Berechtigungen für Benutzer oder Gruppen auf Der Pfadebene Organisation, Projekt oder Bereich in Azure DevOps Zugriff darauf haben. Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt.
Schritt 5: Zuweisen von Eigenschaftenbezeichnungen
Befolgen Sie die allgemeinen Setupanweisungen.
Schritt 6: Verwalten des Schemas
Befolgen Sie die allgemeinen Setupanweisungen.
Schritt 7: Auswählen der Aktualisierungseinstellungen
Der Azure DevOps-Connector unterstützt Aktualisierungszeitpläne für vollständige und inkrementelle Durchforstungen. Der empfohlene Zeitplan ist eine Stunde für eine inkrementelle Durchforstung und ein Tag für eine vollständige Durchforstung.
Schritt 8: Überprüfen der Verbindung
Befolgen Sie die allgemeinen Setupanweisungen.
Tipp
Standardergebnistyp
- Der Azure DevOps-Connector registriert automatisch einen Ergebnistyp , nachdem der Connector veröffentlicht wurde. Der Ergebnistyp verwendet ein dynamisch generiertes Ergebnislayout , das auf den in Schritt 3 ausgewählten Feldern basiert.
- Sie können den Ergebnistyp verwalten, indem Sie im Microsoft 365 Admin Center zu Ergebnistypen navigieren. Der Standardergebnistyp wird als "
ConnectionIdStandard" bezeichnet. Wenn Ihre Verbindungs-ID beispielsweise lautetAzureDevOps, wird Ihr Ergebnislayout benannt: "AzureDevOpsDefault". - Außerdem können Sie bei Bedarf einen eigenen Ergebnistyp erstellen.
Problembehandlung
Nachdem Sie Ihre Verbindung veröffentlicht haben, können Sie den Status auf der Registerkarte Datenquellen im Admin Center überprüfen. Informationen zum Durchführen von Updates und Löschungen finden Sie unter Verwalten ihres Connectors. Schritte zur Problembehandlung für häufig auftretende Probleme finden Sie hier.
Wenn Sie andere Probleme haben oder Feedback geben möchten, schreiben Sie uns aka.ms/TalkToGraphConnectors.