Jira Data Center-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Jira Data Center mit Gemini Enterprise verbinden.

Hinweis

Hinweis: Wenn Sie die Zugriffssteuerung für Datenquellen erzwingen und Daten in Google Gemini Enterprise schützen möchten, müssen Sie Ihren Identitätsanbieter konfigurieren.

Führen Sie vor dem Einrichten der Verbindung die folgenden Schritte aus:

1. Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

   1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen

   2. Suchen Sie das Nutzerkonto und klicken Sie auf „Bearbeiten“ „Bearbeiten“.
   3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu. Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

2. Führen Sie die Schritte unter Authentifizierung einrichten und Client-Anmeldedaten abrufen aus, um die Client-ID und den Clientschlüssel abzurufen und OAuth-Bereiche einzurichten.

3. Wenn Ihre Jira Data Center-Instanz eine private IP-Adresse verwendet, veröffentlichen Sie einen Private Service Connect-Producer-Dienst für Ihre Jira Data Center-Instanz. Weitere Informationen zum Verwenden von Private Service Connect für die Verbindung von Gemini Enterprise mit selbst gehosteten Datenquellen finden Sie unter Einführung in selbst gehostete Datenquellen.

Wenn Sie den Verbindungsmodus „Datenaufnahme“ verwenden, müssen Sie die folgenden zusätzlichen Anforderungen erfüllen:

1. Prüfen Sie, ob Sie die Berechtigung für Jira System-Administratoren haben, um ACL-Informationen (Access Control List) abzurufen.

2. Wenn Sie Sicherheit auf Ausgabeebene in Jira eingerichtet haben, installieren Sie das Plug-in „Permission Accessor for Jira Data Center“. Das Plug-in stellt REST-Endpunkte für Gemini Enterprise bereit. Über diese Endpunkte kann Gemini Enterprise Details zu Bereichsberechtigungen, Inhaltsbeschränkungen und E‑Mail-Adressen von lizenzierten Nutzern abrufen. Diese Informationen werden dann verwendet, um sicherzustellen, dass in der Gemini Enterprise-Suchfunktion die richtigen Berechtigungen angewendet werden.

Jira Data Center-Datenspeicher erstellen

So erstellen Sie den Jira Data Center-Datenspeicher:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Projekt auswählen oder erstellen Google Cloud .

   Hinweis: Damit Sie auf den einheitlichen Ablauf zugreifen können, muss Ihr Projekt auf der Zulassungsliste stehen.

3. Klicken Sie im Navigationsmenü auf Datenspeicher.

4. Klicken Sie auf Datenspeicher erstellen.

5. Suchen Sie im Bereich Quelle nach Jira Data Center und klicken Sie auf Auswählen.

6. Im Bereich Daten:

   1. Wählen Sie im Abschnitt Connector-Modus eine der Optionen Datenaufnahme oder Föderierte Suche aus.

      Hinweis: Datenaufnahme befindet sich in der privaten Vorschauphase. Sie müssen auf der Zulassungsliste stehen, um den Datenspeicher für die Datenaufnahme verwenden zu können. Wenn Sie der Zulassungsliste hinzugefügt werden möchten, wenden Sie sich an Ihr Account-Management-Team oder das Vertriebsteam.

   2. Klicken Sie auf Weiter.

   3. Konfigurieren Sie im Abschnitt Authentifizierungseinstellungen die Authentifizierung basierend auf dem ausgewählten Verbindungsmodus.

      1. Geben Sie die Authentifizierungsdetails an.

         • Geben Sie für die Föderierte Suche die folgenden Details an:

           • Instanz-URI: Die Basis-URL Ihrer Jira Data Center-Instanz, z. B. https://jira.yourcompany.com.

             Hinweis: Die URL muss das Protokoll (https://) enthalten und darf nicht mit einem abschließenden Schrägstrich enden.

           • Client-ID: Die eindeutige Kennung für die in Jira Data Center registrierte OAuth-Anwendung.

           • Clientschlüssel: Das Secret Manager-Secret mit dem Clientschlüssel zur Authentifizierung von Anfragen.

           Informationen zum Abrufen dieser Anmeldedaten finden Sie unter Authentifizierung einrichten und Client-Anmeldedaten abrufen.

         • Wählen Sie für Datenaufnahme eine der folgenden Authentifizierungsmethoden aus: Nutzername und Passwort, Persönliches Zugriffstoken oder API-Token. Geben Sie dann die erforderlichen Details ein.

      2. Klicken Sie auf Weiter.

   4. Wählen Sie in der Liste Zieltyp die eine der Optionen Öffentlich oder Privat aus.

      • Wenn Sie den Zieltyp Öffentlich ausgewählt haben, geben Sie unter Domain-URL Ihre öffentliche URL ein. Sie muss mit dem Instanz-URI übereinstimmen.

      • Wenn Sie den Zieltyp Privat ausgewählt haben, geben Sie die folgenden Informationen ein:

        1. Dienstanhang: Geben Sie Ihren Private Service Connect-Dienstanhang ein. Dazu müssen Sie einen Private Service Connect-Producer-Dienst für Ihre Jira Data Center-Instanz veröffentlichen.
        2. Wenn sich die Region Ihres Private Service Connect-Dienstanhangs von der Region Ihres Datenspeichers unterscheidet, markieren Sie das Kästchen PSC Global Access aktivieren.
        3. Instanz mit Domain-URL:
           • Optional: Basisdomainname: Geben Sie Ihre Basisdomain ein. Geben Sie einen eindeutigen und detaillierten Domainnamen als Basis (z. B. jira.example.com) und nicht eine gemeinsame Stammdomain (z. B. example.com) an. Wenn Sie mehrere Daten-Connectors im selben Projekt haben, z. B. sowohl Jira Data Center als auch Confluence Data Center, muss jeder seine eigene vollständige Instanzdomain als Basisdomain verwenden, um Netzwerkkollisionen zu vermeiden. Im selben Projekt können nicht zwei Daten-Connectors mit privater Verbindung und demselben Basisdomainnamen erstellt werden.
           • Domain-URL: Geben Sie die URL Ihrer Domain ein. Sie muss mit dem Instanz-URI übereinstimmen.
           • Optional: Zielport: Geben Sie den Zielport ein.
        4. Instanz ohne Domain-URL:
           • Zielport: Geben Sie den Zielport ein.
        Hinweis: Eine private Verbindung ist erforderlich, wenn Sie eine Verbindung zu privaten, lokalen Authentifizierungsendpunkten herstellen.

   5. Klicken Sie auf Weiter.

   6. (Optional) Klicken Sie auf Erweiterte Optionen.

      • Wenn Sie Föderierte Suche ausgewählt haben, gehen Sie so vor:

        1. Wenn Sie das Kästchen SSL-Einstellungen aktivieren, wählen Sie unter Vertrauensmodell eine der Optionen Privat, Öffentlich oder Unsicher aus und konfigurieren die erforderlichen Felder. Weitere Informationen zu Vertrauensmodellen finden Sie unter Vertrauensmodelle.

           • Öffentlich: Verwenden Sie diese Option, wenn Ihre Jira Data Center-Instanz Zertifikate verwendet, die von einer öffentlich vertrauenswürdigen Zertifizierungsstelle ausgestellt wurden.
           • Privat: Verwenden Sie diese Option, wenn Ihre Jira Data Center-Instanz Zertifikate verwendet, die von einer privaten oder internen Zertifizierungsstelle signiert wurden.
           • Unsicher: Bei dieser Option wird die Zertifikatsvalidierung umgangen. Für Produktionsumgebungen wird dies nicht empfohlen, da Ihre Verbindung dadurch Sicherheitsrisiken ausgesetzt sein kann.

           Die folgenden Felder sind für alle Vertrauensmodelle üblich:

           • Clientschlüssel des Schlüsselspeichers: Das Clientzertifikat im PEM-Format. Beispiel: -----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----.
           • Privater Clientschlüssel des Schlüsselspeichers: Der private Schlüssel für das Clientzertifikat im PEM-Format.
           • Passphrase für den privaten Clientschlüssel des Schlüsselspeichers: Die Passphrase für den privaten Clientschlüssel, falls relevant.

           Für das Vertrauensmodell Private sind die folgenden zusätzlichen Details erforderlich:

           • Privates Zertifikat: Das öffentliche Zertifikat der privaten Zertifizierungsstelle im PEM-Format.

        2. Sie können den Umfang Ihrer Suchanfragen und Aktionen eingrenzen, indem Sie angeben, welche Jira Data Center-Projektschlüssel ein- oder ausgeschlossen werden sollen. Sie können Daten nur in den eingeschlossenen Projekten ändern oder abrufen. Anfragen für Daten außerhalb des Umfangs schlagen entweder fehl oder geben keine Ergebnisse zurück.

           Sie können dem Datenspeicher Filter über die Google Cloud Console oder die API hinzufügen:

           Console

           Hinweis: Wenn Sie mehrere Projektschlüssel eingeben, trennen Sie sie durch Kommas. Sie können auch eine Liste direkt aus einer CSV-Datei kopieren und einfügen.

           1. Im Bereich „Projektfilter“:
              • Wählen Sie den Filtertyp aus: In Suche einschließen oder Von Suche ausschließen.
              • Geben Sie im Feld Projektfilter die genauen Jira Data Center-Projektschlüssel ein, nach denen gefiltert werden soll (z. B. ENG, HR, SUPPORT).

           REST

           Wenn Sie beim Erstellen eines Datenspeichers Filter hinzufügen möchten, rufen Sie die setUpDataConnector Methode auf.

           curl -X POST \
                   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
                   -H "Content-Type: application/json" \
                   -H "X-Goog-User-Project: PROJECT_ID" \
                   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
                   -d '{
                   "collectionId": "COLLECTION_ID",
                   "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
                   "dataConnector": {
                       "dataSource": "jira_datacenter",
                       "params": {
                       "client_id": "CLIENT_ID",
                       "client_secret": "CLIENT_SECRET",
                       "instance_uri": "INSTANCE_URI",
                       "FILTER_TYPE": {
                           "FILTER_KEY": [
                           "FILTER_VALUE1",
                           "FILTER_VALUE2"
                           ]
                       }
                       },
                       "entities": [
                       {
                           "entityName": "project"
                       },
                       {
                           "entityName": "issue"
                       }
                       ],
                       "refreshInterval": "7200s",
                       "connectorType": "THIRD_PARTY_FEDERATED",
                       "connectorModes": [
                       "FEDERATED"
                       ]
                   }
                   }'
                   

           Ersetzen Sie Folgendes:

           • PROJECT_ID: Die Projekt-ID.
           • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
           • us für die Multiregion „USA“
           • eu für die Multiregion „EU“
           • global für den Standort „Global“

           Weitere Informationen finden Sie unter Festlegen multiregionaler Standorte für Ihren Datenspeicher.
        3. LOCATION: die Multiregion Ihres Datenspeichers: global, us oder eu.
        4. COLLECTION_ID: die eindeutige ID des Datenspeichers.
        5. COLLECTION_DISPLAY_NAME: der Anzeigename des Datenspeichers.
        6. CLIENT_ID: die Client-ID für die Jira Data Center-Authentifizierung.
        7. CLIENT_SECRET: der Clientschlüssel für die Jira Data Center-Authentifizierung.
        8. INSTANCE_URI: der Instanz-URI für Jira Data Center.
        9. FILTER_TYPE: der Typ des Filters, der Ihren Jira Data Center-Datenspeichern hinzugefügt wurde. Weitere Informationen finden Sie unter Filtertypen.
        10. FILTER_KEY: der Schlüssel für den Filter (`Project`). Weitere Informationen finden Sie unter Filterschlüssel.
        11. FILTER_VALUES: der Wert oder die Werte, nach denen gefiltert werden soll (`ENG`, `HR`, `SUPPORT`).