Datenquelle von Drittanbietern verbinden

Auf dieser Seite wird beschrieben, wie Sie Datenquellen von Drittanbietern mit Vertex AI Search verbinden.

Wenn Sie eine Drittanbieterdatenquelle verbinden, erstellt Vertex AI Search einen Daten-Connector und verknüpft Datenspeicher (Entitätsdatenspeicher) für die von Ihnen angegebenen Entitäten damit. Entitätstypen sind spezifisch für die Datenquelle, mit der Sie eine Verbindung herstellen. Beispiele für Jira Cloud-Entitäten sind Probleme, Anhänge, Kommentare und Arbeitsprotokolle.

Datenquellen von Drittanbietern sind nur für allgemeine Suchanwendungen verfügbar. Für Chat, Empfehlungen und Kundenservicemitarbeiter-Apps dürfen keine Drittanbieterdatenquellen verwendet werden.

Connectors von Drittanbietern sind nicht CMEK-kompatibel.

Wenn Sie stattdessen Daten aus einer Google-Datenquelle importieren möchten, lesen Sie den Hilfeartikel Suchdatenspeicher erstellen.

Hinweise

1. Wenden Sie sich an Ihr Google Konten-Team und bitten Sie darum, der Zulassungsliste für Connectors von Drittanbieterdatenquellen hinzugefügt zu werden.

2. Rufen Sie den Abschnitt für die Quelle auf, die Sie verwenden möchten:

   • Confluence Cloud verbinden
   • On-Premises-Confluence Data Center verbinden
   • Jira Cloud verbinden
   • On-Premises-Jira Data Center verbinden
   • Salesforce verbinden
   • ServiceNow verbinden
   • SharePoint Online verbinden
   • Slack verbinden
   • Dropbox verbinden
   • Connect-Box
   • OneDrive verbinden

Confluence Cloud verbinden

So synchronisieren Sie Daten aus Confluence Cloud mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Authentifizierungsinformationen bereit:

  • Instanz-URL. Im Format https://EXAMPLE.atlassian.net, z. B. https://google.atlassian.net.

  • Instanz-ID. Das ist der cloudid. Sie finden ihn unter https://EXAMPLE.atlassian.net/_edge/tenant_info. Kopieren Sie dazu den Wert von cloudId.

• Aktivieren Sie OAuth 2.0 und rufen Sie die Client-ID und den Clientschlüssel ab.

  Verwenden Sie https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html als Callback-URL. Informationen zum Aktivieren von OAuth 2.0 für Confluence Cloud und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der Atlassian Developer-Dokumentation unter OAuth 2.0 (3LO)-Apps.

• Konfigurieren Sie beim Festlegen von OAuth 2.0-Berechtigungsbereichen die folgenden Bereiche:

  Bereiche ansehen

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

• Damit Nutzerberechtigungen richtig angewendet werden können, muss jeder Confluence Cloud-Nutzer seine E-Mail-Adresse für alle Nutzer sichtbar machen. Ändern Sie dazu die Einstellungen für die E-Mail-Sichtbarkeit in Confluence Cloud und legen Sie die Sichtbarkeit auf Anyone fest. Weitere Informationen finden Sie in der Atlassian-Dokumentation unter E-Mail-Sichtbarkeit festlegen.

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Confluence Data Center On-Premises verbinden

Mit dieser Anleitung können Sie einen Confluence Data Center-Datenspeicher und eine Suchanwendung in Agent Builder erstellen und vor Ort gespeicherte Confluence-Daten mit Vertex AI Search synchronisieren.

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten, benötigen Sie Folgendes:

• Dienstanhänge (nur für privaten Zieltyp erforderlich): Konfigurieren Sie einen Dienstanhang für die sichere Datenübertragung.
• Nutzername und Passwort: Wenden Sie sich an Ihren Confluence-Administrator, um gültige Anmeldedaten für die Authentifizierung zu erhalten.
• Domain-URL (optional für den privaten Zieltyp): Geben Sie die URL der Confluence Data Center-Instanz an.
• Basisdomainname (optional): Geben Sie den Basisdomainnamen für die Confluence-Instanz an.
• Zielport (optional): Geben Sie den Port an, der für die Kommunikation mit dem Confluence Data Center verwendet wird.

Konfigurationsrichtlinien für Private Service Connect

Folgen Sie den folgenden Konfigurationsrichtlinien, um Verbindungen mit Private Service Connect(PSC) herzustellen. Passen Sie die Ressourcen nach Bedarf an oder fügen Sie weitere hinzu. Achten Sie darauf, dass der PSC-Dienstanhang richtig für die Verbindung mit der privaten Instanz konfiguriert ist und die Anforderungen für einen veröffentlichten Dienst erfüllt.

• Netzwerkkonfiguration:

  a. Platzieren Sie den PSC-Dienstanhang und den Load Balancer in verschiedenen Subnetzen innerhalb desselben Virtual Private Cloud-Netzwerks.

  b. Das Backend-System muss aus Sicherheitsgründen für das öffentliche Netzwerk geschlossen bleiben. Achten Sie jedoch darauf, dass Traffic von den folgenden Quellen akzeptiert werden kann:

  • Konfigurieren Sie für proxybasierte/HTTP(S)-Load Balancer (L4-Proxy-ILB, L7-ILB) das Back-End so, dass es Anfragen vom Proxy-Subnetz im Virtual Private Cloud-Netzwerk akzeptiert.
  • Weitere Informationen finden Sie in der Dokumentation Nur-Proxy-Subnetze für Envoy-basierte Load Balancer.

• Firewallregeln:

  a. Regeln für eingehenden Traffic:

  • Lassen Sie Traffic vom Subnetz der PSC-Dienstanwendung zum Subnetz des internen Load Balancers (ILB) zu.
  • Achten Sie darauf, dass der ILB Traffic an das Backend senden kann.
  • Erlauben Sie Systemdiagnosetests, das Backend zu erreichen.

  b. Regeln für ausgehenden Traffic:

  • Aktivieren Sie ausgehenden Traffic standardmäßig, es sei denn, bestimmte Regeln zum Ablehnen gelten.

Weitere Überlegungen:

• Achten Sie darauf, dass sich alle Komponenten, einschließlich des PSC-Dienstanhangs und des Load Balancers, in derselben Region befinden.

Dienstanhang generieren

So generieren Sie einen Dienstanhang:

1. Endpunkttyp auswählen: Wählen Sie Öffentlich oder Privat aus.

2. Öffentlicher Endpunkt: Wenn der Zieltyp des Confluence-Rechenzentrums Öffentlich ist, müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Stattdessen können Sie beim Erstellen des Connectors Ihre öffentliche URL im Feld Domain-URL der Google Cloud Console verwenden.

3. Für den privaten Endpunkt:

   a. Verwenden Sie Private Service Connect (PSC), um Verbindungen von privaten Instanzen zu Google Cloud zu ermöglichen.

   b. Erstellen Sie ein Virtual Private Cloud-Netzwerk und die erforderlichen Subnetze.

   c. Erstellen Sie eine VM-Instanz und installieren Sie den Back-End-Dienst.

   d. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Backends zu überwachen.

   e. Fügen Sie einen Load Balancer hinzu, um den Traffic an die VM oder das Back-End weiterzuleiten.

   f. Definieren Sie Firewallregeln, um Traffic zwischen dem PSC-Endpunkt und dem Backend zuzulassen.

   g. Veröffentlichen Sie den Endpunkt, indem Sie einen PSC-Dienstanhang erstellen.

Confluence Data Center-Nutzer erstellen und Berechtigungen einrichten

Damit Vertex AI Search Daten aus Confluence abrufen kann, müssen Sie einen neuen Nutzer mit den erforderlichen Mindestberechtigungen erstellen. So erstellen Sie den Nutzer und richten die erforderlichen Berechtigungen ein:

Als Administrator anmelden

1. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Confluence Data Center-Instanz.
2. Geben Sie den Nutzernamen und das Passwort des Administrators ein.
3. Klicken Sie auf Log In (Anmelden).

Neuen Nutzer erstellen

Wenn Sie einen Datenspeicher erstellen, müssen Sie einen Nutzer erstellen, um Daten von der Drittanbieterinstanz abzurufen.

1. Klicken Sie auf das Symbol für die Einstellungen.
2. Wählen Sie Nutzerverwaltung aus.
3. Geben Sie die Administratoranmeldedaten ein, wenn Sie dazu aufgefordert werden.
4. Klicken Sie auf der Seite Verwaltung auf Nutzer erstellen.
5. Geben Sie die E-Mail-Adresse, den vollständigen Namen, den Nutzernamen und das Passwort ein.
6. Klicken Sie auf Nutzer erstellen.

Nutzer einer Gruppe zuweisen

1. Rufen Sie auf der Seite Confluence-Verwaltung den Tab „Nutzer und Sicherheit“ auf und klicken Sie auf Gruppen.
2. Klicken Sie auf Gruppe hinzufügen. Geben Sie einen Namen für die Gruppe ein und erstellen Sie sie.
3. Geben Sie im Feld Gruppe suchen den Namen der Gruppe ein, um sie zu finden.
4. Klicken Sie auf das Symbol für die Einstellungen.
5. Wählen Sie das Profilkonto aus und rufen Sie Nutzerverwaltung auf.
6. Suchen Sie auf der Seite Nutzer unter Nutzerliste im Feld Nutzer suchen nach dem neu erstellten Nutzer.
7. Klicken Sie auf den Nutzer, um die Seite Nutzer ansehen zu öffnen.
8. Klicken Sie auf Gruppen bearbeiten, um die Seite Nutzergruppe bearbeiten zu öffnen.
9. Klicken Sie das Kästchen für die erstellte Nutzergruppe an.
10. Klicken Sie auf Speichern, um den Nutzer der neu erstellten Gruppe zuzuweisen.

Der hinzugefügte Nutzer wird im Bereich Gruppenmitglieder zugewiesen.

Nutzerberechtigungen konfigurieren

1. Rufen Sie auf der Seite Confluence-Verwaltung den Tab Probleme auf.
2. Suchen Sie Berechtigungen.
3. Wählen Sie Globale Berechtigungen ansehen aus.
4. Wählen Sie Berechtigungen bearbeiten aus.
5. Suchen Sie auf der Seite Globale Berechtigungen bearbeiten nach der Gruppe, die dem Nutzer zugewiesen ist, und aktivieren Sie die Option kann verwenden.

Dokumentationsbereich konfigurieren

1. Klicken Sie auf das Symbol Confluence, um die Seite Dashboard aufzurufen.
2. Klicken Sie auf Gruppenbereich erstellen.
3. Wählen Sie Documentation space (Dokumentationsbereich) aus und klicken Sie auf Weiter.
4. Geben Sie alle erforderlichen Details ein und klicken Sie auf Erstellen, um den Dokumentbereich zu erstellen.
5. Klicken Sie unter Meine Gruppenbereiche auf den neu erstellten Gruppenbereich.
6. Rufen Sie Seiten auf und öffnen Sie das Dreipunkt-Menü.
7. Wählen Sie Einschränkungen aus.
8. Wählen Sie im Drop-down-Menü Einschränkungen die Option Ansehen und Bearbeiten eingeschränkt aus.
9. Suchen Sie nach der Gruppe und weisen Sie die Berechtigung kann ansehen zu.
10. Klicken Sie auf Anwenden. Der Nutzer wird mit minimalem Zugriff erstellt und es werden Berechtigungen für Gruppenbereiche festgelegt. Sie können den Blogs auch Berechtigungen zuweisen.

On-Premises-Connector für Confluence Data Center erstellen

Richten Sie einen lokalen Confluence Data Center-Connector ein, um Daten mit Google Cloud zu synchronisieren. Erstellen Sie zuerst einen Datenspeicher in Agent Builder und konfigurieren Sie die Verbindungseinstellungen, einschließlich Authentifizierungs- und Synchronisierungseinstellungen.

#### On-Premises-Connector für Confluence Data Center erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Jira Cloud verbinden

So synchronisieren Sie Daten aus Jira Cloud mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung ein. Prüfen Sie, ob die Zugriffssteuerung für Ihre Datenquelle richtig konfiguriert ist. So wird sichergestellt, dass nur autorisierte Nutzer auf die Daten zugreifen und sie verwalten können. Weitere Informationen finden Sie in der Dokumentation Zugriffssteuerung für Datenquellen verwenden.
• Damit Nutzerberechtigungen richtig angewendet werden können, müssen Jira Cloud-Nutzer ihre Einwilligung zur Freigabe erteilen.
• Sie benötigen ein Atlassian-Konto, eine Jira-Instanz und ein Projekt.
• Prüfen Sie, ob Sie Administratorzugriff auf die Jira-Instanz und das Projekt haben.

Authentifizierung und Berechtigungen in Jira einrichten

Anhand der Anleitungen in den folgenden Abschnitten können Sie prüfen, ob Sie die erforderlichen Authentifizierungsdetails und den Administratorzugriff auf Ihre Jira-Instanz haben. Erstellen Sie eine Client-ID und einen Clientschlüssel über die Atlassian Developer Console, konfigurieren Sie die erforderlichen OAuth 2.0-Bereiche und richten Sie Berechtigungen für Nutzer ein. Rufen Sie abschließend die Instanz-URL und ‑ID ab, konfigurieren Sie Rollen und authentifizieren Sie sich, um Daten zwischen Jira Cloud und Vertex AI Search zu synchronisieren.

Client-ID und Clientschlüssel erstellen

1. Melden Sie sich unter developer.atlassian.com an.
2. Klicken Sie rechts oben auf das Profilsymbol und wählen Sie Developer Console (Entwicklerkonsole) aus.
3. Klicken Sie auf Erstellen und wählen Sie OAuth 2.0-Integration aus.
4. Geben Sie einen Namen für die App ein.
   • Klicken Sie das Kästchen für die Nutzungsbedingungen an.
   • Klicken Sie auf Erstellen.

5. Sie sehen fünf Optionen: Übersicht, Verteilung, Berechtigungen, Autorisierung und Einstellungen. Beginnen Sie mit Autorisierung:

   a. Klicken Sie auf Autorisierung.

   b. Wählen Sie in der Tabelle Autorisierungstyp für OAuth 2.0 (3LO) die Option Hinzufügen aus.

6. Geben Sie im Feld Callback-URL https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html ein und klicken Sie dann auf Änderungen speichern.

   HINWEIS: Wenn Sie die Warnung Ihre App hat keine APIs sehen, Ihrer App APIs hinzufügen.Dies wird im nächsten Abschnitt behandelt.

7. Wählen Sie Berechtigungen aus:

   a. Rufen Sie die Jira API auf, klicken Sie auf Hinzufügen und dann auf Konfigurieren.

   HINWEIS:Wenn Sie auf Hinzufügen klicken, ändert sich die Schaltfläche in Konfigurieren.

   b. Rufen Sie den Tab Klassische Berechtigungen auf und klicken Sie auf Berechtigungen bearbeiten. Wählen Sie die folgenden Bereiche aus:

   Bereiche ansehen

   • read:avatar:jira
   • read:audit-log:jira
   • read:group:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:jira-user
   • read:jira-work
   • read:user:jira

   Prüfen Sie, ob sieben Bereiche ausgewählt sind, und speichern Sie dann die Änderungen.

8. Klicken Sie auf Verteilung, wählen Sie Bearbeiten aus und gehen Sie so vor:

   • Wählen Sie zuerst das Optionsfeld Freigabe aus, um andere Felder bearbeiten zu können.
   • Füllen Sie die restlichen Felder aus.
   • Wählen Sie Ja aus, wenn Sie gefragt werden: Does your app store personal data?

9. Wähle Einstellungen aus, um deine Client-ID und dein Client-Secret zu kopieren.

Instanz-URL und Instanz-ID abrufen

So rufen Sie die Instanz-URL ab:

1. Rufen Sie atlassian.net auf und melden Sie sich mit Ihrem Administratorkonto an.
2. Wählen Sie die App aus, die Sie synchronisieren möchten. Synchronisieren Sie beispielsweise die erste App.
3. Suchen Sie die Instanz-URL, also die Subdomain in der Adressleiste. Er sieht so aus: Assign appropriate permissions.

So rufen Sie die Instanz-ID ab:

1. Öffnen Sie einen neuen Tab, kopieren Sie die Instanz-URL und hängen Sie /_edge/tenant_info an die Instanz-URL an. Beispiel: https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
2. Rufen Sie den Link auf, um den Wert für cloudId zu finden. cloudId ist Ihre Instanz-ID.

Berechtigungen und Rollen einrichten

1. Melden Sie sich mit Ihrem Administratorkonto unter atlassian.com an.
2. Klicken Sie auf das Menüsymbol links oben oder rufen Sie admin.atlassian.com auf.

3. Klicken Sie auf der Seite Verwaltung auf Nutzer verwalten und rufen Sie die Seite Gruppen auf.

4. Klicken Sie auf Gruppe erstellen. Geben Sie einen Namen für die Gruppe ein und erstellen Sie sie.

5. Klicken Sie auf der Seite der neuen Gruppe im Abschnitt Produktzugriff gruppieren auf Produkte zur Gruppe hinzufügen.

6. Wählen Sie für Jira die Produktrolle Administrator für den Nutzerzugriff aus.

7. Wählen Sie für Jira-Administrator die Produktrolle Produktadministrator aus und speichern Sie die Änderungen.

8. Klicken Sie auf der Seite Gruppen auf Gruppenmitglieder hinzufügen und fügen Sie Nutzer oder Konten hinzu, als die sich der Connector authentifizieren soll.

Jira Cloud-Connector erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Jira Data Center On-Premises verbinden

Mit dieser Anleitung können Sie einen Jira Data Center-Datenspeicher und eine Suchanwendung in Agent Builder erstellen und On-Premises-Jira-Daten mit Vertex AI Search synchronisieren.

Nachdem Sie die Datenquelle eingerichtet und Daten zum ersten Mal importiert haben, können Sie festlegen, wie oft der Datenspeicher mit dieser Quelle synchronisiert wird.

Hinweise

Bevor Sie die Verbindung einrichten, benötigen Sie Folgendes:

• Dienstanhänge (nur für privaten Zieltyp erforderlich): Konfigurieren Sie einen Dienstanhang für die sichere Datenübertragung.
• Nutzername und Passwort: Wenden Sie sich an Ihren Jira-Administrator, um gültige Anmeldedaten für die Authentifizierung zu erhalten.
• Domain-URL (optional für den privaten Zieltyp): Geben Sie die URL der Jira Data Center-Instanz an.
• Basisdomainname (optional): Geben Sie den Basisdomainnamen für die Jira-Instanz an.
• Zielport (optional): Geben Sie den Port an, der für die Kommunikation mit dem Jira Data Center verwendet wird.

Konfigurationsrichtlinien für Private Service Connect

Folgen Sie den folgenden Konfigurationsrichtlinien, um Verbindungen mit Private Service Connect(PSC) herzustellen. Passen Sie die Ressourcen nach Bedarf an oder fügen Sie weitere hinzu. Achten Sie darauf, dass der PSC-Dienstanhang richtig für die Verbindung mit der privaten Instanz konfiguriert ist und die Anforderungen für einen veröffentlichten Dienst erfüllt.

• Netzwerkkonfiguration:

  a. Platzieren Sie den PSC-Dienstanhang und den Load Balancer in verschiedenen Subnetzen innerhalb desselben Virtual Private Cloud-Netzwerks.

  b. Das Backend-System muss aus Sicherheitsgründen für das öffentliche Netzwerk geschlossen bleiben. Achten Sie jedoch darauf, dass Traffic von den folgenden Quellen akzeptiert werden kann:

  • Konfigurieren Sie für proxybasierte/HTTP(S)-Load Balancer (L4-Proxy-ILB, L7-ILB) das Back-End so, dass es Anfragen vom Proxy-Subnetz im Virtual Private Cloud-Netzwerk akzeptiert.

  • Weitere Informationen finden Sie in der Dokumentation Nur-Proxy-Subnetze für Envoy-basierte Load Balancer.

• Firewallregeln:

  a. Regeln für eingehenden Traffic:

  • Lassen Sie Traffic vom Subnetz der PSC-Dienstanwendung zum Subnetz des internen Load Balancers (ILB) zu.
  • Achten Sie darauf, dass der ILB Traffic an das Backend senden kann.
  • Erlauben Sie Systemdiagnosetests, das Backend zu erreichen.

  b. Regeln für ausgehenden Traffic:

  • Aktivieren Sie ausgehenden Traffic standardmäßig, es sei denn, bestimmte Regeln zum Ablehnen gelten.

Weitere Überlegungen:

• Achten Sie darauf, dass sich alle Komponenten, einschließlich des PSC-Dienstanhangs und des Load Balancers, in derselben Region befinden.

Dienstanhang generieren

So generieren Sie einen Dienstanhang:

1. Endpunkttyp auswählen: Wählen Sie Öffentlich oder Privat aus.

2. Für öffentlichen Endpunkt: Wenn der Zieltyp des Jira-Rechenzentrums öffentlich ist, müssen Sie die Einrichtung für den Dienstanhang nicht erstellen. Sie können stattdessen Ihre öffentliche URL im Feld Domain-URL der Google Cloud Console verwenden.

3. Für den privaten Endpunkt:

   a. Verwenden Sie PSC, um Verbindungen von privaten Instanzen zu Google Cloud zu ermöglichen.

   b. Erstellen Sie ein Virtual Private Cloud-Netzwerk und die erforderlichen Subnetze.

   c. Erstellen Sie eine VM-Instanz und installieren Sie den Back-End-Dienst.

   d. Optional: Richten Sie einen Systemdiagnose-Test ein, um den Zustand des Backends zu überwachen.

   e. Fügen Sie einen Load Balancer hinzu, um den Traffic an die VM oder das Back-End weiterzuleiten.

   f. Definieren Sie Firewallregeln, um Traffic zwischen dem PSC-Endpunkt und dem Backend zuzulassen.

   g. Veröffentlichen Sie den Endpunkt, indem Sie einen PSC-Dienstanhang erstellen.

Jira Data Center-Nutzer erstellen und Berechtigungen einrichten

Damit Vertex AI Search Daten aus Jira abrufen kann, müssen Sie einen neuen Nutzer mit den erforderlichen Mindestberechtigungen erstellen. So erstellen Sie den Nutzer und richten die erforderlichen Berechtigungen ein:

Als Administrator anmelden

1. Rufen Sie die Website Ihrer Atlassian-Domain auf und öffnen Sie die Jira Data Center-Instanz.
2. Geben Sie den Nutzernamen und das Passwort des Administrators ein.
3. Klicken Sie auf Log In (Anmelden).

Neuen Nutzer erstellen

Wenn Sie einen Datenspeicher erstellen, müssen Sie einen Nutzer erstellen, um Daten von der Drittanbieterinstanz abzurufen.

1. Klicken Sie auf das Symbol für die Einstellungen.
2. Wählen Sie Nutzerverwaltung aus.
3. Geben Sie die Administratoranmeldedaten ein, wenn Sie dazu aufgefordert werden.
4. Klicken Sie auf der Seite Verwaltung auf Nutzer erstellen.
5. Geben Sie die E-Mail-Adresse, den vollständigen Namen, den Nutzernamen und das Passwort ein.
6. Klicken Sie auf Nutzer erstellen.

Nutzer einer Gruppe zuweisen

1. Klicken Sie auf der Seite Verwaltung unter Nutzerverwaltung auf Gruppen.
2. Erstellen Sie eine Gruppe, indem Sie einen Namen eingeben und auf Gruppe hinzufügen klicken.
3. Wählen Sie die neu erstellte Gruppe aus.
4. Klicken Sie auf Nutzer hinzufügen/entfernen.
5. Klicken Sie auf das Mitgliedssymbol neben dem Feld Ausgewählten Gruppen Mitglieder hinzufügen.
6. Wählen Sie den neu erstellten Nutzer aus und klicken Sie auf Auswahl speichern.
7. Klicken Sie auf Ausgewählten Nutzer hinzufügen, um neue Nutzer im Bereich „Gruppenmitglieder“ zu sehen.

Sie sehen, dass der hinzugefügte Nutzer im Bereich Gruppenmitglieder zugewiesen ist.

Nutzerberechtigungen konfigurieren

1. Rufen Sie auf der Seite Verwaltung den Tab Probleme auf.
2. Wählen Sie Berechtigungsschemata aus.
3. Klicken Sie auf Berechtigungsschema hinzufügen.
4. Geben Sie einen Namen für das Schema ein und klicken Sie auf Hinzufügen.
5. Wählen Sie das Schema aus und klicken Sie auf das Symbol Berechtigung.
6. Klicken Sie auf Berechtigung gewähren.
7. Fügen Sie die folgenden Berechtigungen hinzu, weisen Sie sie der zuvor erstellten Gruppe zu und klicken Sie auf Gewähren:
   • Projekte durchsuchen
   • Projekte im Archiv durchsuchen

Sie können dieses Schema den Projekten hinzufügen, in denen die Nutzer in dieser Gruppe Zugriff benötigen, um das Projekt und die zugehörigen Probleme, Kommentare, Arbeitsprotokolle und Anhänge aufzurufen.

Anwendungszugriff konfigurieren

1. Rufen Sie auf der Seite Verwaltung den Tab Anwendungen auf.
2. Wählen Sie auf dem Tab Anwendungen die Option Anwendungszugriff aus.
3. Suchen Sie nach der erstellten Gruppe und wählen Sie sie aus.
4. Prüfen Sie, ob die Gruppe in der Zugriffsliste aufgeführt ist.

Der Nutzer wird mit minimalen Zugriffsberechtigungen erstellt. Dieses Schema wird den Projekten hinzugefügt. Der Jira-Administrator kann dieser Gruppe weitere Mitglieder oder dem Projekt weitere Nutzer hinzufügen.

On-Premises-Connector für Jira Data Center erstellen

Richten Sie einen lokalen Jira Data Center-Connector ein, um Daten mit Google Cloud zu synchronisieren. Erstellen Sie zuerst einen Datenspeicher in Agent Builder und konfigurieren Sie die Verbindungseinstellungen, einschließlich Authentifizierungs- und Synchronisierungseinstellungen.

On-Premises-Connector für Jira Data Center erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Drittanbieterzugriffssteuerung.

Salesforce verbinden

So synchronisieren Sie Daten aus Salesforce mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Authentifizierungsinformationen bereit. Informationen zum Einrichten der Client-ID und des Clientsecrets in Salesforce finden Sie in der Salesforce-Dokumentation unter Verbundene App für den OAuth 2.0-Client-Anmeldedatenfluss konfigurieren.

  • Instanz-URL: Der Domainname Ihrer Salesforce-Instanz. Suchen Sie nach Meine Domain, kopieren Sie die Domain, die auf my.salesforce.com endet, und fügen Sie https:// an den Anfang an.
  • Client-ID: Klicken Sie auf Kundendetails verwalten, um die Client-ID aus der verbundenen App zu kopieren. Wenn das Aktualisierungstoken aktiviert ist, prüfen Sie, ob das Token aktualisiert wird, und geben Sie beim Erstellen eines Datenspeichers das aktuelle Token an.
  • Clientschlüssel: Klicken Sie auf Kundendetails verwalten, um den Clientschlüssel aus der verbundenen App zu kopieren. Wenn das Aktualisierungstoken aktiviert ist, prüfen Sie, ob das Token aktualisiert wird, und geben Sie beim Erstellen eines Datenspeichers das aktuelle Token an.

• Damit Nutzerberechtigungen richtig angewendet werden können, müssen Salesforce-Nutzer ihre Einwilligung zur Freigabe erteilen.

• Sie haben ein Enterprise- oder Entwickler-Abo. Testkonten werden nicht unterstützt.

• Sie müssen Sales Cloud verwenden. Service Cloud wird nicht unterstützt.

• Fügen Sie Google Cloud der CORS-Zulassungsliste von Salesforce hinzu. Wenn Sie diese Aufgabe bereits erledigt haben, fahren Sie mit dem Abschnitt „App erstellen“ fort.

  • Folgen Sie der Anleitung in der Salesforce-Dokumentation, um die CORS-Zulassungsliste zu konfigurieren.
  • Geben Sie https://console.cloud.google.com/ als Ursprungs-URL ein und speichern Sie die Konfiguration.

App erstellen

Salesforce unterstützt die folgenden Apps:

1. Verbundene App
2. Externe Client-App

Verbundene App erstellen

So richten Sie eine verbundene Anwendung in Salesforce für die Einbindung in Google Cloud ein:

1. Melden Sie sich in Salesforce an.
2. Klicken Sie auf das Zahnradsymbol und gehen Sie zu Einrichtung.
3. Gehen Sie im Menü Einrichtung zu App-Manager.
4. Klicken Sie auf Neue verbundene App.

5. So konfigurieren Sie die verbundene App:

   a. Führen Sie auf der Seite zum Erstellen der verbundenen App die folgenden Schritte aus:

   • Klicken Sie das Kästchen OAuth-Einstellungen aktivieren an.
   • Legen Sie die Callback-URL auf https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html fest.
   • Wählen Sie die folgenden OAuth-Bereiche aus:
     • Vollzugriff (full)
     • Anfragen jederzeit ausführen (refresh_token, offline_access)

   b. Aktivieren Sie die folgenden Abläufe:

   • Ablauf der Clientanmeldedaten
   • Ablauf für Autorisierungscode und Anmeldedaten
   • Nutzeranmeldedaten im POST-Text für Autorisierungscode und Anmeldedatenablauf
   • Weisen Sie für den Ablauf der Clientanmeldedaten im Feld Als ausführen Ihren Nutzernamen zu. Sie benötigen Leseberechtigungen für alle Entitäten, die Ihr Connector extrahieren kann.

Gehen Sie nach dem Erstellen der verbundenen App so vor:

1. App-Richtlinien bearbeiten:

   • Rufen Sie den App-Manager auf und bearbeiten Sie die neu erstellte App.
   • Legen Sie für IP-Lockerung den Wert Relax IP restrictions fest.
   • Konfigurieren Sie die Richtlinie für das Aktualisierungstoken nach Bedarf auf Valid until revoked oder auf eine restriktivere Einstellung.
   • Achten Sie darauf, dass Zulässige Nutzer auf All users may self-authorize festgelegt ist.

2. Konfigurieren Sie IP-Einschränkungen:

   • Wenn die Durchsetzung von IP-Bereichen auf Organisationsebene aktiviert ist, legen Sie unter Sicherheit > Netzwerkzugriff die Vertrauenswürdigen IP-Bereiche fest. Weitere Informationen finden Sie in der Dokumentation IP-Lockerung und kontinuierliche IP-Durchsetzung für verbundene Apps.
   • Deaktivieren Sie IP-Bereiche für Anmeldungen bei jeder Anfrage erzwingen, wenn keine IP-Einschränkungen erforderlich sind.

3. So konfigurieren Sie eine mit OAuth verbundene App:

   • Mit den folgenden Anleitungen können Sie eine OAuth-verbundene App konfigurieren:
     • Grundlagen zu verbundenen Apps
     • API-Integration
     • Einrichtung von Clientanmeldedaten

4. So speichern Sie die verbundene App:

   • Speichern Sie die verbundene App und schließen Sie sie.
   • Suchen Sie in der Suchleiste nach OAuth- und OpenId Connect-Einstellungen.
   • Aktivieren Sie Autorisierungscode- und Anmeldedatenabläufe zulassen und OAuth-Abläufe mit Nutzernamen und Passwort.

Externe Client-App erstellen

So erstellen und konfigurieren Sie eine externe Client-App in Salesforce, um die OAuth-basierte Authentifizierung für Integrationen zu aktivieren:

1. Client-ID und Clientschlüssel abrufen:

   • Melden Sie sich in Salesforce an.
   • Klicken Sie auf das Zahnradsymbol und gehen Sie zu Einrichtung.
   • Gehen Sie zu Einrichtung > Apps > Externe Client-Apps.
   • Klicken Sie auf Neue externe Client-App.

2. Geben Sie die erforderlichen Informationen an:

   • Geben Sie den Namen der App und Ihre E-Mail-Adresse ein. Der API-Name wird standardmäßig automatisch ausgefüllt.
   • Belassen Sie den Vertriebsstatus bei Local.

3. Aktivieren Sie die OAuth-Einstellungen:

   • Maximieren Sie API (OAuth-Einstellungen aktivieren) und wählen Sie OAuth aktivieren aus.
   • Konfigurieren:
     • Callback-URL: https://login.salesforce.com/services/oauth2/callback
     • OAuth-Bereiche: Nutzerdaten über APIs verwalten (api).
     • Wählen Sie unter Flow-Aktivierung die Option Clientanmeldedatenfluss aktivieren aus.
     • Klicken Sie auf Erstellen, um die externe Client-App zu erstellen. Gehen Sie zum Verwaltungstool für externe Client-Apps, um die App aufzurufen, die Sie der Liste hinzugefügt haben.

4. App-Richtlinien bearbeiten:

   • Öffnen Sie die erstellte App.
   • Klicken Sie auf Richtlinien und dann auf Bearbeiten.
   • Setzen Sie unter OAuth-Abläufe und Verbesserungen für externe Clientanwendungen ein Häkchen bei Ablauf für Clientanmeldedaten aktivieren.
   • Geben Sie Ihren Salesforce-Nutzernamen in das Feld Als ausführen ein.

5. Auf OAuth-Anmeldedaten zugreifen:

   • Klicken Sie auf Einstellungen.
   • Klicken Sie auf OAuth-Einstellungen.
   • Klicken Sie auf Consumer-Key und Secret, um auf die Anmeldedaten zuzugreifen. Der Bestätigungscode wird an Ihre E-Mail-Adresse gesendet.
   • Gib den Bestätigungscode ein und klicke auf Bestätigen.
   • Kopieren Sie den Consumer-Schlüssel und verwenden Sie ihn als Client-ID.
   • Kopieren Sie das Consumer Secret und verwenden Sie es als Clientschlüssel.

Salesforce-Connector erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

ServiceNow verbinden

So synchronisieren Sie Daten aus ServiceNow mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Authentifizierungsinformationen bereit:

  • Instanz-URL im Format https://<domain-name>.service-now.com/.
  • Client-ID und Clientschlüssel Informationen zur Endpunkteinrichtung und zum Abrufen der Client-ID und des Clientschlüssels finden Sie in der ServiceNow-Dokumentation unter Endpunkt für den Zugriff von Clients auf die Instanz erstellen.

  • Nutzername und Passwort für eine der folgenden ServiceNow-Rollentypen:

    • Administratorrolle Weitere Informationen finden Sie in der ServiceNow-Dokumentation unter Base system roles (Grundlegende Systemrollen).

    • Eine benutzerdefinierte ServiceNow-Rolle. Dies ist eine Alternative zur Verwendung einer Administratorrolle. Wenn Sie eine benutzerdefinierte ServiceNow-Rolle verwenden möchten, erstellen Sie Zugriffssteuerungsregeln mit den folgenden Feldern:

      Felder ansehen

      • Typ: record
      • Betrieb: read
      • Name (für jede Regel ist eine separate Zugriffssteuerungsregel erforderlich):
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • Rolle erforderlich: Name der benutzerdefinierten Rolle

      Weitere Informationen finden Sie in der ServiceNow-Dokumentation unter Rolle erstellen und ACL-Regel erstellen.

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

SharePoint Online verbinden

So synchronisieren Sie Daten aus SharePoint Online mit der Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Geben Sie die Einwilligung des Administrators. Informationen zum Gewähren der Einwilligung finden Sie in der Microsoft-Dokumentation unter Mandatenweite Administratorzustimmung für eine Anwendung gewähren.

• Bereiten Sie die folgenden Informationen zur SharePoint Online-Authentifizierung für die Einrichtung vor:

  • Instanz-URL. Im Formular http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Weitere Informationen zu URLs finden Sie in der SharePoint-Dokumentation unter URLs und Tokens in SharePoint.

  • Mieter-ID, Client-ID und Clientschlüssel. Wählen Sie zum Registrieren der Anwendung für die Zielgruppe für die Anmeldung Nur Konten in diesem Organisationsverzeichnis aus und suchen Sie dann nach diesen Authentifizierungsinformationen. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Schnellstart: Anwendung bei der Microsoft-Identitätsplattform registrieren.

  • Verwenden Sie bei der Registrierung der Anwendung https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html als Webanfrage-URL.

  • Fügen Sie beim Konfigurieren von Anwendungsberechtigungen die folgenden Anwendungsberechtigungen für die Graph API hinzu:

    Bereiche ansehen

    • GroupMember.Read.All
    • Sites.FullControl.All
    • User.Read.All

  • Fügen Sie beim Konfigurieren der Anwendungsberechtigungen die folgenden delegierten Berechtigungen für die Sharepoint REST API hinzu:

    Bereiche ansehen

    • AllSites.FullControl

• In der folgenden Tabelle werden die für die Konfiguration empfohlenen Rollen und ihre Einschränkungen beschrieben.

  Rollen ansehen

  Rollen	Registrierung der Clientanwendung	Kann Inhalte aller Entitäten abrufen	ACL abrufen	Kann Identität abrufen	Hinweise
  Websiteadministratoren	Nein	Ja	Ja	Ja
  Administrator der Websitesammlung	Nein	Ja	Ja	Ja
  Globaler Administrator	Ja	Nein	Ja	Nein	Einschränkung: Identität oder die Entitäten „Kommentar“ und „Anhang“ können nicht abgerufen werden.
  Websiteinhaber	Nein	Ja	Ja	Nein	Einschränkung: Identität kann nicht abgerufen werden
  Anwendungsadministrator	Ja	–	–	–	Die Rolle „Anwendungsadministrator“ bezieht sich auf das Microsoft 365 Admin Center bzw. das Entra Admin Center. Sie ist nicht auf SharePoint beschränkt.

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Slack verbinden

So synchronisieren Sie Daten aus Slack mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Wenden Sie sich an den Workspace-Inhaber, um die Berechtigungen zum Installieren neuer Apps in Ihrem Arbeitsbereich zu erhalten.

• Bereiten Sie die folgenden Informationen zur Slack-Authentifizierung vor:

  • Arbeitsbereichs-ID: Folgen Sie der Anleitung unter Slack-Quelle für Ihren Datenspeicher angeben in der Slack-Dokumentation, um die Arbeitsbereichs-ID abzurufen.
  • Zugriffstoken: Erstellen Sie eine Clientanwendung und definieren Sie die erforderlichen Bereiche. Weitere Informationen finden Sie in der Slack-Dokumentation unter Schnellstart und So rufen Sie schnell ein Slack API-Token ab und verwenden es.
  • Konfigurieren Sie beim Festlegen von OAuth 2.0-Berechtigungsbereichen die folgenden Bereiche:

    Bereiche ansehen

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users:read
    • files:read

• Standardmäßig schränkt Slack das Crawling und die Synchronisierung von Inhalten aus privaten Channels, Gruppennachrichten und Direktnachrichten ein.

Slack-App konfigurieren

Holen Sie sich ein Zugriffstoken, damit Vertex AI Search Dokumente aus Ihrem Slack-Arbeitsbereich aufnehmen kann.

Bot-Token generieren

Erstellen Sie ein Bot-Token, um sicher auf private Kanäle, Instant Messages (IMs) und Multi-Party-Instant Messages (MPIMs) zuzugreifen. Das Bot-Token kann nicht in öffentliche Kanäle gecrawlt werden, zu denen es nicht gehört. Wenn es einem öffentlichen Kanal beitritt, wird eine entsprechende Nachricht generiert.

1. Melden Sie sich in Slack API-Apps an.
2. Klicken Sie auf Neue App erstellen.
3. Wählen Sie Neu beginnen aus.
4. Geben Sie einen Namen für die App ein und wählen Sie den Arbeitsbereich für die Integration aus.
5. Klicken Sie auf Anwendung erstellen.
6. Klicken Sie auf OAuth und Berechtigungen.

7. Fügen Sie unter Bereiche für Bot-Token die folgenden erforderlichen Bereiche hinzu:

   Bereiche ansehen

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • team:read
   • users:read
   • files:read

   Standardmäßig liest der Bot aus den Kanälen #general und #random. So aktivieren Sie das Crawling:

   • Gewähren Sie für öffentliche Kanäle den Zugriffsumfang channels:join, damit der Bot automatisch beitreten kann.
   • Bei privaten Kanälen müssen Sie den Bot manuell einladen.

8. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

9. Folgen Sie der Anleitung auf dem Bildschirm, um die App zu installieren und das Bot-Token abzurufen.

Nutzertoken generieren

Nutzertoken generieren, um auf alle öffentlichen Kanäle zuzugreifen, ohne ihnen zuerst beitreten zu müssen Das Nutzertoken kann keine privaten Kanäle, IMs oder MPIMs crawlen, es sei denn, der Nutzer hat Zugriff.

1. Melden Sie sich in Slack API-Apps an.
2. Klicken Sie auf Neue App erstellen.
3. Wählen Sie Neu beginnen aus.
4. Geben Sie einen Namen für die App ein und wählen Sie den Arbeitsbereich für die Integration aus.
5. Klicken Sie auf Anwendung erstellen.
6. Klicken Sie auf OAuth und Berechtigungen.

7. Fügen Sie unter Umfang des Nutzertokens die folgenden erforderlichen Bereiche hinzu:

   Bereiche ansehen

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • users:read
   • files:read

8. Klicken Sie auf Im Arbeitsbereich Ihres Nutzernamens installieren.

9. Folgen Sie der Anleitung auf dem Bildschirm, um die App zu installieren und das Nutzertoken abzurufen.

Slack Cloud-Connector erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Weitere Informationen finden Sie unter Vorschauergebnisse für Apps mit Zugriffssteuerung für Drittanbieter.

Dropbox verbinden

So synchronisieren Sie Daten aus Dropbox mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Weitere Informationen finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Informationen zur Dropbox-Authentifizierung bereit. Informationen zum Einrichten dieser Parameter finden Sie im OAuth-Leitfaden in der Dropbox-Dokumentation.

  • Client-ID
  • Clientschlüssel

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

Connect Box

So synchronisieren Sie Daten aus Box mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Informationen zur Box-Authentifizierung bereit. Informationen zum Einrichten dieser Parameter finden Sie in der Box-Entwicklerdokumentation unter JWT Auth.

  • Unternehmens-ID
  • Client-ID
  • Clientschlüssel
  • ID des öffentlichen Schlüssels
  • Privater Schlüssel
  • Passphrase

• Konfigurieren Sie beim Erstellen des JWT-Endpunkts die folgenden Bereiche:

  Bereiche ansehen

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

Die Synchronisierung von inkrementellen Änderungen an Kommentaren kann länger dauern als das konfigurierte Häufigkeitsintervall. Wenn ein Ordner mit einem Element kopiert oder verschoben wird, kann die Synchronisierung inkrementeller Änderungen länger als das konfigurierte Häufigkeitsintervall dauern.

Box-App erstellen

1. Melden Sie sich mit Ihrem Administratorkonto in der Box Developer Console an.
2. Klicken Sie auf Neue App erstellen.
3. Wählen Sie den Typ Benutzerdefinierte App aus.
4. Geben Sie den App-Namen ein.
5. Legen Sie den Zweck der App fest: Integration, KI oder Google Cloud Agent Builder.
6. Wählen Sie Server Authentication with JWT (Serverauthentifizierung mit JWT) aus.

Box App konfigurieren

Konfigurieren Sie die Einstellungen für die Box App.

Öffentlichen/privaten Schlüssel erstellen

1. Rufen Sie die Box Developer Console auf.

2. Klicken Sie auf dem Tab Konfiguration auf Paar aus öffentlichem und privatem Schlüssel erstellen.

   • Der öffentliche Schlüssel wird automatisch mit einer ID in die Console hochgeladen. Diese ID wird beim Erstellen einer Verbindung verwendet.
   • Eine Konfigurationsdatei mit dem privaten Schlüssel und der Passphrase kann lokal heruntergeladen werden. Bewahren Sie diese Konfigurationsdatei für später auf.
   • Wenn Sie einen eigenen Schlüssel generieren möchten, lesen Sie den Leitfaden zur Einrichtung von Box-Schlüsselpaaren.

Erforderliche Berechtigungen konfigurieren

1. Wählen Sie im Bereich Anwendungsbereich die folgende Berechtigung aus:
   • Alle in Box gespeicherten Dateien und Ordner lesen

App autorisieren

1. Klicken Sie auf dem Tab Autorisierung auf Überprüfen und senden und warten Sie auf die Genehmigung Ihres Administrators.
2. Administratoren können die App in der Admin-Konsole genehmigen.

Nach der Autorisierung richtet Box die App vollständig ein.

Box-Connector erstellen

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.

OneDrive verbinden

So synchronisieren Sie Daten aus OneDrive mit Vertex AI Search:

Nachdem Sie die Datenquelle eingerichtet und zum ersten Mal Daten importiert haben, werden die Daten aus dieser Quelle mit der Häufigkeit synchronisiert, die Sie bei der Einrichtung ausgewählt haben.

Hinweise

Bevor Sie die Verbindung einrichten:

• Richten Sie die Zugriffssteuerung für Ihre Datenquelle ein. Informationen zum Einrichten der Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

• Halten Sie die folgenden Informationen zur OneDrive-Authentifizierung bereit:

  • Client-ID, Clientschlüssel und Mandanten-ID. Informationen zum Einrichten dieser Parameter finden Sie in der Microsoft-Dokumentation unter Kurzanleitung: Anwendung bei der Microsoft Identity Platform registrieren.

  • Geben Sie Zugriffsbereiche an. Eine Administratorrolle ist erforderlich. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Kurzanleitung: Clientanwendung für den Zugriff auf eine Web-API konfigurieren.

    Konfigurieren Sie die folgenden Zugriffsbereiche:

    Bereiche ansehen

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

Nächste Schritte

• Wenn Sie Ihren Datenspeicher an eine App anhängen möchten, erstellen Sie eine App und wählen Sie Ihren Datenspeicher aus. Folgen Sie dazu der Anleitung unter Suchanwendung erstellen.

• Eine Vorschau, wie Ihre Suchergebnisse nach der Einrichtung Ihrer App und Ihres Datenspeichers aussehen, finden Sie unter Suchergebnisse abrufen. Wenn Sie die Zugriffssteuerung von Drittanbietern verwendet haben, lesen Sie den Hilfeartikel Vorschauergebnisse für Apps mit Zugriffssteuerung von Drittanbietern.