Atlassian Jira Cloud Microsoft Graph-Connector
Mit dem Microsoft Graph-Connector von Atlassian Jira Cloud können Ihre organization Jira-Probleme indizieren. Nachdem Sie den Connector und den Indexinhalt von der Jira-Website konfiguriert haben, können Endbenutzer in Microsoft Search nach diesen Elementen suchen.
Hinweis
Lesen Sie den Artikel Einrichten von Microsoft Graph-Connectors im Microsoft 365 Admin Center Artikel, um die allgemeinen Anweisungen zum Einrichten von Connectors zu verstehen.
Dieser Artikel richtet sich an alle Benutzer, die einen Atlassian Jira Cloud-Connector konfigurieren, ausführen und überwachen. Es ergänzt den allgemeinen Einrichtungsprozess und zeigt Anweisungen, die nur für den Atlassian Jira Cloud-Connector gelten.
Wichtig
Der Atlassian Jira Cloud-Connector unterstützt nur von Jira in der Cloud gehostete Instanzen. Jira Server- und Jira Data Center-Versionen werden von diesem Connector nicht unterstützt.
Bevor Sie beginnen
Sie müssen der Administrator für den Microsoft 365-Mandanten Ihres organization und der Administrator für die Jira-Website Ihrer organization sein.
Sie benötigen die folgenden Berechtigungen für das Benutzerkonto, dessen Anmeldeinformationen während der Connectorkonfiguration verwendet werden:
Berechtigungsname | Berechtigungstyp | Erforderlich für |
---|---|---|
Projekte durchsuchen | Projektberechtigung | Durchforstung von Jira-Problemen. Diese Berechtigung ist für die Projekte obligatorisch , die indiziert werden müssen. |
Sicherheitsberechtigungen auf Problemebene | Sicherheit auf Problemebene | Durchforsten verschiedener Problemtypen. Diese Berechtigung ist optional. |
Durchsuchen von Benutzern und Gruppen | Globale Berechtigungen | ACL-Kürzung von Suchergebnissen. Diese Berechtigung ist optional und ist erforderlich, um die Option in Schritt 4 unten auszuwählen Only people with access to this data source . |
Verwalten von Jira | Globale Berechtigungen | ACL-Kürzung von Suchergebnissen. Diese Berechtigung ist optional und ist erforderlich, um die Option in Schritt 4 unten auszuwählen Only people with access to this data source . |
Schritt 1: Hinzufügen eines Connectors im Microsoft 365 Admin Center
Hinzufügen des Jira-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 Jira-Website herzustellen, verwenden Sie die URL Ihrer Jira-Website. Eine Jira-Cloudwebsite-URL sieht in der Regel wie https://< organization_name.atlassian.net/> aus. Sie können entweder Die Standardauthentifizierung oder OAuth 2.0 (empfohlen) auswählen, um sich bei Ihrer Jira-Website zu authentifizieren.
Standardauthentifizierung
Geben Sie den Benutzernamen (in der Regel die E-Mail-ID) ihres Kontos und das API-Token ein, um sich mit der Standardauthentifizierung zu authentifizieren. Weitere Informationen zum Generieren eines API-Tokens finden Sie in der Atlassian-Dokumentation zum Verwalten von API-Token für Ihr Atlassian-Konto.
OAuth 2.0
Registrieren Sie eine App in Atlassian Jira, damit die Microsoft Search-App auf die instance zugreifen kann. Weitere Informationen finden Sie in der Atlassian-Supportdokumentation zum Aktivieren von OAuth 2.0.
Die folgenden Schritte enthalten Anleitungen zum Registrieren der App:
Melden Sie sich mit Ihrem Atlassian Jira-Administratorkonto bei der Atlassian Developer-Konsole an.
Wählen Sie ein aus
Create
, und wählen Sie ausOAuth 2.0 integration
.Geben Sie einen geeigneten Namen für die Anwendung an, und erstellen Sie die neue App.
Navigieren Sie im Navigationsbereich auf der linken Seite zu
Permissions
. Wählen Sie unter dem Header "Granular Permissions" (Granulare Berechtigungen) fürJira API
ausAdd
. Wählen Sie nach dem Hinzufügen einConfigure
aus, und fügen Sie die unten aufgeführten Bereiche hinzu.# Bereichsname Code 1 Felder anzeigen read:field:jira
2 Anzeigen von Avataren read:avatar:jira
3 Anzeigen von Projektkategorien read:project-category:jira
4 Projekte anzeigen read:project:jira
5 Lesen von Feldkonfigurationen read:field-configuration:jira
6 Anzeigen von Problemtypen read:issue-type:jira
7 Anzeigen von Projekteigenschaften read:project.property:jira
8 Benutzer anzeigen read:user:jira
9 Anzeigen von Anwendungsrollen read:application-role:jira
10 Gruppen anzeigen read:group:jira
11 Lesen von Problemtyphierarchien read:issue-type-hierarchy:jira
12 Anzeigen von Projektversionen read:project-version:jira
13 Anzeigen von Projektkomponenten read:project.component:jira
14 Anzeigen von Problemdetails read:issue-details:jira
15 Anzeigen von Überwachungsprotokollen read:audit-log:jira
16 Anzeigen der Problemmetadaten read:issue-meta:jira
17 Anzeigen von Projektrollen read:project-role:jira
18 Anzeigen von Sicherheitsstufen für Probleme read:issue-security-level:jira
19 Anzeigen von Sicherheitsschemas für Probleme read:issue-security-scheme:jira
20 Anzeigen von Berechtigungsschemas read:permission-scheme:jira
21 Berechtigungen anzeigen read:permission:jira
Navigieren Sie im Navigationsbereich auf der linken Seite zu
Authorization
. Fügen Sie die Rückruf-URL für M365 Enterprise hinzu:https://gcs.office.com/v1.0/admin/oauth/callback
für M365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
, und speichern Sie die Änderungen.Navigieren Sie im Navigationsbereich auf der linken Seite zu
Settings
. Sie erhalten undClient ID
Secret
von dieser Seite.
Führen Sie den Schritt mit den Verbindungseinstellungen mithilfe der Client-ID und des Geheimen Schlüssels aus.
Hinweis
- Weitere Informationen zu Jira-Berechtigungen finden Sie in der Liste der Bereiche für OAuth 2.0-Apps.
- Die ursprünglichen (klassischen) OAuth-Berechtigungen sind für Jira Cloud veraltet. Weitere Informationen finden Sie in der Änderungsprotokollankündigung .
Schritt 3a: Konfigurieren von Daten: Auswählen von Projekten
Sie können auswählen, dass die Verbindung entweder die gesamte Jira-Website oder nur bestimmte Projekte indiziert.
- Wenn Sie die gesamte Jira-Website indizieren möchten, werden Jira-Probleme in allen Projekten auf der Website indiziert. Neue Projekte und Probleme werden während der nächsten Durchforstung nach ihrer Erstellung indiziert.
- Wenn Sie einzelne Projekte auswählen, werden nur Jira-Issues in diesen Projekten indiziert.
Hinweis
Wenn Sie einem Jira-Projekt durchsuchen die Berechtigung Projekte durchsuchen erteilen, wird sie aufgelistet und kann durchforstet werden. Wenn ein Projekt fehlt, überprüfen Sie die Berechtigungen für Ihr Konto.
Sie können auch die Jira-Probleme filtern, die auf zwei Arten indiziert werden.
- Geben Sie den Zeitraum für die Änderung des Problems an. Dadurch werden nur die Jira-Probleme indiziert, die in dem zeitraum erstellt oder geändert werden, der auf fortlaufender Basis basierend auf der aktuellen Durchforstung ausgewählt wurde.
- Geben Sie den JQL an. Dadurch werden nur die Jira-Probleme indiziert, die nach dem Filtern basierend auf der bereitgestellten Jira-Abfragesprache (JQL) zurückgegeben werden. Weitere Informationen zur Verwendung von JQL finden Sie in der Atlassian-Supportdokumentation zur Verwendung der erweiterten Suche mit Jira Query Language.
Tipp
Sie können den JQL-Filter verwenden, um nur bestimmte Jira-Problemtypen mithilfe von "issueType in (Bug,Improvement)" zu indizieren.
Schritt 3b: Konfigurieren von Daten: Eigenschaften auswählen
Wählen Sie aus, welche Felder die Verbindung indizieren und Daten in diesen Feldern anzeigen soll, bevor Sie fortfahren. Einige Felder sind bereits standardmäßig ausgewählt und können nicht entfernt werden.
Der Atlassian Jira-Connector kann sowohl Standardproblemfelder als auch benutzerdefinierte Issuefelder indiziert werden.
Hinweis
Wenn ein ausgewähltes benutzerdefiniertes erstelltes Feld in einigen Jira-Problemtypen nicht vorhanden ist, wird das Feld als NULL (leer) erfasst.
Schritt 4: Verwalten von Suchberechtigungen
Der Atlassian Jira-Connector unterstützt Suchberechtigungen, die für "Jeder " oder "Nur Personen mit Zugriff auf diese Datenquelle" sichtbar sind. Wenn Sie Alle 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 indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die Zugriff darauf haben. In Atlassian Jira werden Sicherheitsberechtigungen mithilfe von Projektberechtigungsschemas definiert, die Gruppen auf Websiteebene und Projektrollen enthalten. Die Sicherheit auf Problemebene kann auch mithilfe von Berechtigungsschemas auf Problemebene definiert werden.
Wichtig
Der Jira Cloud Graph-Connector muss in der Lage sein, die E-Mail-ID eines Benutzers in Jira zu lesen, um sicherheitsrelevante Berechtigungen in Microsoft Search zuzuweisen. Dies erfordert, dass Sie eine der folgenden Punkte sicherstellen:
- Alle Benutzer sollten die Option "Jeder" für ihre Profilsichtbarkeitseinstellungen ausgewählt haben. Weitere Informationen zu Profilsichtbarkeitseinstellungen finden Sie in der Dokumentation von Atlassian.
- Für Organisationen, die "Verwaltete Konten" verwenden (Alle Atlassian-Konten mit E-Mail-Adressen aus Ihrer verifizierten Domäne werden zu verwalteten Konten. Weitere Informationen finden Sie in dieser Dokumentation .
- Für alle Benutzer, die Teil verwalteter Konten sind, muss die Einstellung für verwaltete Konten in den Profilsichtbarkeitseinstellungen ausgewählt sein.
- Benutzer, die nicht Teil des verwalteten Kontos sind (identisch mit dem Durchforstungskonto), müssen in ihren Profilsichtbarkeitseinstellungen die Option "Jeder" ausgewählt haben.
- Das während der Verbindungskonfiguration verwendete Durchforstungskonto muss über die Domäne des verwalteten Kontos verfügen.
Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, müssen Sie weiter auswählen, ob Ihre Jira-Website über Microsoft Entra ID bereitgestellte Benutzer oder Nicht-Azure AD-Benutzer verfügt.
So ermitteln Sie, welche Option für Ihre organization geeignet ist:
- Wählen Sie die Option Microsoft Entra ID aus, wenn die Email-ID von Jira-Benutzern mit dem UserPrincipalName (UPN) von Benutzern in Microsoft Entra ID identisch ist.
- Wählen Sie die Option Nicht-Azure AD aus, wenn sich die E-Mail-ID von Jira-Benutzern von der UserPrincipalName (UPN) der Benutzer in Microsoft Entra ID unterscheidet.
Hinweis
- Wenn Sie Microsoft Entra ID als Typ der Identitätsquelle auswählen, ordnet der Connector die Email-IDs von Benutzern, die von Jira direkt abgerufen wurden, der UPN-Eigenschaft aus Microsoft Entra ID zu.
- Wenn Sie "Nicht-Azure AD" als Identitätstyp ausgewählt haben, finden Sie anweisungen zum Zuordnen der Identitäten unter [Zuordnen Ihrer Nicht-Azure AD-Identitäten](zuordnung-non-Azure AD.md). Sie können diese Option verwenden, um den regulären Zuordnungsausdruck von Email-ID zum UPN bereitzustellen.
- Updates für Benutzer oder Gruppen, die Zugriffsberechtigungen steuern, werden nur in vollständigen Durchforstungen synchronisiert. Inkrementelle Durchforstungen unterstützen derzeit keine Verarbeitung von Updates für Berechtigungen.
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 Atlassian Jira-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.
Nachdem Sie die Verbindung veröffentlicht haben, müssen Sie die Suchergebnisseite anpassen. Informationen zum Anpassen von Suchergebnissen finden Sie unter Anpassen der Suchergebnisseite.
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 Jira-Connector verwenden. Kopieren Sie einfach den JSON-Code des Ergebnislayouts, um zu beginnen.
Problembehandlung
Im Folgenden finden Sie eine Liste der häufigen Fehler, die beim Konfigurieren des Connectors oder während Durchforstungen beobachtet wurden, und deren mögliche Ursachen.
Schritt | Fehlermeldung | Mögliche Gründe |
---|---|---|
Verbindungseinstellungen | Die Anforderung ist fehlerhaft oder falsch. | Falsche Jira-Website-URL. |
Verbindungseinstellungen | Der Jira-Clouddienst für Ihre Jira-Website kann nicht erreicht werden. | Falsche Jira-Website-URL. |
Verbindungseinstellungen | Der Client verfügt nicht über die Berechtigung zum Ausführen der Aktion. | Für die Standardauthentifizierung wurde ein ungültiges API-Token bereitgestellt. |
Verbindungseinstellungen | Fehler "Es ist ein Fehler aufgetreten" im OAuth-Popupfenster. | Die Bereiche, die der OAuth-App gewährt werden, stimmen nicht überein. Die nicht übereinstimmenden Bereiche werden im Popupfenster aufgeführt. |
Durchforstungszeit (konfiguration nach dem Connector) | Die Authentifizierung mit der Datenquelle ist nicht möglich. Vergewissern Sie sich, dass die dieser Datenquelle zugeordneten Anmeldeinformationen korrekt sind. | Der Benutzer verfügt nicht über eine oder mehrere Berechtigungen, die zum Durchforsten von Jira erforderlich sind. |
Durchforstungszeit (konfiguration nach dem Connector) | Sie sind nicht berechtigt, auf diese Datenquelle zuzugreifen. Sie können sich an den Besitzer dieser Datenquelle wenden, um die Berechtigung anzufordern. | Wenn Sie OAuth verwenden, haben sich die App-Bereiche möglicherweise geändert, oder die App ist abgelaufen oder gelöscht. Wenn Sie die Standardauthentifizierung verwenden, ist das API-Token möglicherweise abgelaufen oder gelöscht. |
Begrenzungen
Im Folgenden sind die Einschränkungen des Atlassian Jira-Connectors bekannt:
- Der Connector unterstützt die Anwendungsrolle "Angemeldeter Benutzer" nicht, um Zugriff auf Probleme zu gewähren.
- Jira Server- und Data Center-Versionen werden nicht unterstützt.