Freigeben über

Microsoft Graph-Connector im Azure DevOps-Wiki

  • Artikel

Mit dem Azure DevOps Wiki Graph-Connector können Ihre organization Wikis im instance des Azure DevOps-Diensts indizieren. Nach dem Konfigurieren des Connectors können Endbenutzer in Azure DevOps in Microsoft Search nach Projekt-Wikis und Code-Wikis suchen.

Hinweis

Dieser Artikel richtet sich an alle Benutzer, die einen Azure DevOps Wiki Graph-Connector konfigurieren, ausführen und überwachen. Es ergänzt den allgemeinen Einrichtungsprozess und zeigt Anweisungen, die nur für den Azure DevOps Wiki Graph-Connector gelten.

Wichtig

Der Azure DevOps Wiki-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 Suchadministrator für den M365-Mandanten Ihres organization sowie der Administrator für die Azure DevOps-instance Ihrer organization 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 .

Anwendungszugriff von Drittanbietern über OAuth

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.

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 Graph-Connectors im Microsoft 365 Admin Center

Hinzufügen des Azure DevOps-Wiki-Connectors

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 2: Benennen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 3: Konfigurieren der Verbindungseinstellungen

Um eine Verbindung mit Ihrer Azure DevOps-instance herzustellen, benötigen Sie die App-ID ihres Azure DevOps-Kontos 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 instance zugreifen kann. Um die App zu registrieren, besuchen Sie den Link zum Registrieren der Anwendung. 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 Connectoreinrichtung Zugriff auf Ihre Azure DevOps-instance 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: Identity (read), Code (read), Entitlements (Read), Project and team (read), Graph (read), MemberEntitlement Management (read), Wiki (read)

Wichtig

Die für die App ausgewählten autorisierten Bereiche sollten genau mit den oben aufgeführten Bereichen übereinstimmen. Wenn mehr oder weniger Bereiche ausgewählt sind, 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-instance 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 Ihre App-ID und den geheimen Clientschlüssel ein.

Verbindungsanwendungseinstellungen.

Daten konfigurieren: Wählen Sie organization, Projekte und Felder aus.

In diesem Schritt geben Sie den Datenbereich an, den Sie mithilfe des Azure DevOps Wiki Graph-Connectors indizieren möchten.

Im ersten Schritt können Sie aus allen Organisationen, auf die Sie Zugriff haben, die organization auswählen, auf die Sie Indizieren möchten. Sie können dann auswählen, dass die Verbindung entweder die gesamte organization oder bestimmte Projekte innerhalb der ausgewählten organization indiziert.

Wenn Sie die gesamte organization indizieren, werden Wikis in allen Projekten im organization indiziert. Neue Projekte und Wikis werden während der nächsten Durchforstung nach ihrer Erstellung indiziert.

Wenn Sie einzelne Projekte indizieren, werden nur Wikis in den ausgewählten Projekten indiziert.

Schritt 4: Verwalten von Suchberechtigungen

Der Azure DevOps-Connector unterstützt Suchberechtigungen, die für Alle sichtbar sind. Mit der Option Jeder 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 Wiki-Connector unterstützt Aktualisierungszeitpläne für vollständige und inkrementelle Durchforstungen. Der empfohlene Zeitplan ist eine Stunde für eine inkrementelle Durchforstung und eine Woche für eine vollständige Durchforstung.

Schritt 8: Überprüfen der Verbindung

Befolgen Sie die allgemeinen Setupanweisungen.

Schritt 9: Einrichten der Suchergebnisseite

Nachdem Sie die Verbindung veröffentlicht haben, müssen Sie die Suchergebnisseite mit Vertikalen und Ergebnistypen anpassen. Informationen zum Anpassen von Suchergebnissen finden Sie unter Verwalten von Vertikalen und Ergebnistypen. Sie können auch das Beispielergebnislayout für den Azure DevOps Wiki-Connector verwenden. Kopieren Sie einfach den JSON-Code des Ergebnislayouts, um zu beginnen.

Problembehandlung

Im Folgenden finden Sie häufige Fehler, die beim Konfigurieren des Connectors oder während der Durchforstung auftreten, und die möglichen Gründe.

Schritt Fehlermeldung Mögliche Gründe
Verbindungseinstellungen Invalid Credentials detected. Try signing in with a different account or check the permissions for your account Der Zugriff auf Anwendungen von Drittanbietern über OAuth kann deaktiviert werden. Führen Sie die Schritte zum Verwalten von Sicherheitsrichtlinien aus, um OAuth zu aktivieren.
Verbindungseinstellungen Bad state Nachricht im OAuth-Popupfenster mit url-Angabe error=InvalidScope Falsche Bereiche, die für die registrierte App bereitgestellt werden.
Verbindungseinstellungen 400 - Bad request Meldung im OAuth-Popupfenster Falsche App-ID
Verbindungseinstellungen BadRequest: Bad Request on api request Meldung im OAuth-Popupfenster Falscher geheimer Clientschlüssel
Durchforstungszeit (konfiguration nach dem Connector) The account associated with the connector doesn't have permission to access the item. Die registrierte App verfügt nicht über die erforderlichen OAuth-Bereiche.
Durchforstungszeit (konfiguration nach dem Connector) You don't have permission to access this data source. You can contact the owner of this data source to request permission. Der Anwendungszugriff von Drittanbietern über OAuth ist deaktiviert. Führen Sie die Schritte zum Verwalten von Sicherheitsrichtlinien aus, um OAuth zu aktivieren.
Durchforstungszeit (konfiguration nach dem Connector) Credentials associated with this data source have expired. Renew the credentials and then update the connection Die registrierte App wurde möglicherweise gelöscht oder abgelaufen.
Durchforstungszeit (konfiguration nach dem Connector) Item listed but no longer accessible or no longer exists Dem Durchforstungskonto fehlt möglicherweise die Zugriffsebene "Basic". Durchforstungen schlagen mit dem Zugriff "Stakeholder" fehl.