Dropbox

PDFRSS

Dropbox ist ein Datei-Hosting-Dienst, der Cloud-Speicher, Dokumentenorganisation und Dokumentenvorlagen anbietet. Wenn Sie ein Dropbox-Nutzer sind, können Sie Amazon Kendra damit Ihre Dropbox-Dateien, Dropbox Paper, Dropbox Paper-Vorlagen und gespeicherte Verknüpfungen zu Webseiten indexieren. Sie können auch so konfigurieren Amazon Kendra , dass bestimmte Dropbox-Dateien, Dropbox Paper, Dropbox Paper-Vorlagen und gespeicherte Verknüpfungen zu Webseiten indexiert werden.

Amazon Kendra unterstützt sowohl Dropbox als auch Dropbox Advanced für Dropbox Business.

Sie können über Amazon Kendra die Amazon Kendra Konsole und die TemplateConfigurationAPI eine Verbindung zu Ihrer Dropbox-Datenquelle herstellen.

Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Dropbox-Datenquellen-Connector finden Sie unterProblembehandlung bei Datenquellen.

Unterstützte Features

Amazon Kendra Der Dropbox-Datenquellen-Connector unterstützt die folgenden Funktionen:

• Feldzuordnungen

• Steuerung des Benutzerzugriffs

• Einschluss-/Ausschlussfilter

• Vollständige und inkrementelle Inhaltssynchronisierung

• Virtual Private Cloud (VPC)

Voraussetzungen

Bevor Sie Ihre Dropbox-Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihrer Dropbox und AWS Ihren Konten vornehmen.

Stellen Sie in Dropbox sicher, dass Sie über Folgendes verfügen:

• Sie haben ein Dropbox Advanced-Konto erstellt und einen Admin-Benutzer eingerichtet.

• Hat eine Dropbox-App mit einem eindeutigen App-Namen konfiguriert und Scoped Access aktiviert. Informationen zum Erstellen einer App finden Sie in der Dropbox-Dokumentation.

• Die vollständigen Dropbox-Berechtigungen wurden auf der Dropbox-Konsole aktiviert und die folgenden Berechtigungen hinzugefügt:

  • files.content.read

  • files.metadata.read

  • teilen.lesen

  • Dateianforderungen.lesen

  • gruppen.lesen

  • team_info.lesen

  • team_data.content.read

• Sie haben Ihren Dropbox-App-Schlüssel, den geheimen Dropbox-App-Schlüssel und das Dropbox-Zugriffstoken für die Basisauthentifizierung zur Kenntnis genommen.

  Anmerkung

  Wir empfehlen Ihnen, Ihre Anmeldedaten und Ihr Passwort regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

• Sie haben ein temporäres OAuth 2.0-Zugriffstoken für Ihre Dropbox-App konfiguriert und kopiert. Dieses Token ist temporär und läuft nach 4 Stunden ab. Weitere Informationen zur OAuth-Authentifizierung finden Sie in der Dropbox-Dokumentation.

  Anmerkung

  Es wird empfohlen, ein Dropbox-Zugriffstoken für die Aktualisierung zu erstellen, das nie abläuft, anstatt sich auf ein einmaliges Zugriffstoken zu verlassen, das nach 4 Stunden abläuft. Ein Aktualisierungszugriffstoken ist permanent und läuft nie ab, sodass Sie Ihre Datenquelle auch in future synchronisieren können.

• Empfehlung: Es wurde ein permanentes Dropbox-Aktualisierungstoken konfiguriert, das nie abläuft, damit Amazon Kendra Sie Ihre Datenquelle weiterhin ohne Unterbrechungen synchronisieren können. Informationen zu Aktualisierungstoken finden Sie in der Dropbox-Dokumentation.

• Aktiviert, dass jedes Dokument in Dropbox und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokument-IDs gelten für einen Index global und müssen pro Index eindeutig sein.

Stellen Sie sicher AWS-Konto, dass Sie Folgendes in Ihrem haben:

• Hat einen Amazon Kendra Index erstellt und bei Verwendung der API die Index-ID notiert.

• Sie haben eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.

  Anmerkung

  Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.

• Haben Ihre Dropbox-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.

  Anmerkung

  Wir empfehlen Ihnen, Ihre Anmeldedaten und Ihr Passwort regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Dropbox-Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.

Anweisungen zur Verbindung

Um eine Verbindung Amazon Kendra zu Ihrer Dropbox-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Dropbox-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Dropbox noch nicht für konfiguriert haben Amazon Kendra, finden Sie weitere Informationen unterVoraussetzungen.

Console

So stellen Sie eine Verbindung Amazon Kendra zu Dropbox her

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon Kendra Konsole.

2. Wählen Sie im linken Navigationsbereich Indizes und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.

   Anmerkung

   Sie können Ihre Einstellungen für die Benutzerzugriffskontrolle unter Indexeinstellungen konfigurieren oder bearbeiten.

3. Wählen Sie auf der Seite Erste Schritte die Option Datenquelle hinzufügen aus.

4. Wählen Sie auf der Seite Datenquelle hinzufügen die Option Dropbox-Connector und dann Connector hinzufügen aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den Dropbox-Connector mit dem Tag „V2.0".

5. Geben Sie auf der Seite „Datenquellendetails angeben“ die folgenden Informationen ein:

   1. Geben Sie im Feld Name und Beschreibung für Datenquellenname einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.

   2. (Optional) Beschreibung — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.

   3. In Standardsprache — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.

   4. Unter Tags für Neues Tag hinzufügen — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS

   5. Wählen Sie Weiter aus.

6. Geben Sie auf der Seite Zugriff und Sicherheit definieren die folgenden Informationen ein:

   1. Autorisierung — Aktivieren oder deaktivieren Sie die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter Benutzerkontextfilterung.

   2. Art des Authentifizierungstokens — Wählen Sie entweder ein permanentes Token (empfohlen) oder ein temporäres Zugriffstoken.

   3. AWS Secrets Manager geheim — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Dropbox-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.

      1. Geben Sie die folgenden Informationen in das Fenster Create an AWS Secrets Manager Secret ein:

         1. Geheimer Name — Ein Name für Ihr Geheimnis. Das Präfix 'AmazonKendra-Dropbox' wird automatisch zu Ihrem geheimen Namen hinzugefügt.

         2. Für Informationen zum App-Schlüssel, zum geheimen App-Schlüssel und zum Token (permanent oder temporär): Geben Sie die in Dropbox konfigurierten Werte für die Authentifizierungsdaten ein.

      2. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.

   4. Virtual Private Cloud (VPC) — Sie können wählen, ob Sie eine VPC verwenden möchten. In diesem Fall müssen Sie Subnetze und VPC-Sicherheitsgruppen hinzufügen.

   5. Identity Crawler — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die Benutzerkontextfilterung der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn Identity Crawler ausgeschaltet ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die PutPrincipalMappingAPI verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.

   6. IAM Rolle — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.

      Anmerkung

      IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder eine häufig gestellte Frage verwendet wird, wählen Sie Neue Rolle erstellen, um Fehler zu vermeiden.

   7. Wählen Sie Weiter aus.

7. Geben Sie auf der Seite „Synchronisierungseinstellungen konfigurieren“ die folgenden Informationen ein:

   1. Für Entitäten oder Inhaltstypen auswählen — Wählen Sie Dropbox-Entitäten oder Inhaltstypen aus, die Sie crawlen möchten.

   2. In Zusätzliche Konfiguration für Regex-Muster — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Dateien ein- oder auszuschließen.

   3. Synchronisierungsmodus — Wählen Sie aus, wie Sie Ihren Index aktualisieren möchten, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen.

      • Vollständige Synchronisierung: Indizieren Sie den gesamten Inhalt neu und ersetzen die vorhandenen Inhalte jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.

      • Neue, geänderte Synchronisierung: Indizieren Sie jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.

      • Neue, geänderte, gelöschte Synchronisierung: Indizieren Sie bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.

   4. Wählen Sie im Zeitplan für die Synchronisierungsausführung unter Frequenz aus, wie oft der Inhalt Ihrer Datenquelle synchronisiert und der Index aktualisiert werden soll.

   5. Wählen Sie Weiter aus.

8. Geben Sie auf der Seite Feldzuordnungen festlegen die folgenden Informationen ein:

   1. Vorlagen für Dateien, Dropbox Paper und Dropbox Paper — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern, die Sie Ihrem Index zuordnen möchten.

   2. Feld hinzufügen — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.

   3. Wählen Sie Weiter aus.

9. Überprüfen Sie auf der Seite Überprüfen und erstellen, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle hinzufügen aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite Datenquellen angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.

API

Um eine Verbindung Amazon Kendra zu Dropbox herzustellen

Sie müssen mithilfe der TemplateConfigurationAPI ein JSON des Datenquellenschemas angeben. Sie müssen die folgenden Informationen angeben:

• Datenquelle — Geben Sie den Datenquellentyp wie DROPBOX bei der Verwendung des TemplateConfigurationJSON-Schemas an. Geben Sie außerdem die Datenquelle so anTEMPLATE, wie Sie die CreateDataSourceAPI aufrufen.

• Synchronisierungsmodus — Geben Sie an, wie Ihr Index aktualisiert Amazon Kendra werden soll, wenn sich der Inhalt Ihrer Datenquelle ändert. Wenn Sie Ihre Datenquelle Amazon Kendra zum ersten Mal synchronisieren, werden alle Inhalte standardmäßig gecrawlt und indexiert. Sie müssen eine vollständige Synchronisierung Ihrer Daten durchführen, falls Ihre erste Synchronisierung fehlgeschlagen ist, auch wenn Sie die Option Vollsynchronisierung nicht als Synchronisierungsmodusoption wählen. Sie können wählen zwischen:

  • FORCED_FULL_CRAWLum den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.

  • FULL_CRAWLum bei jeder Synchronisierung Ihrer Datenquelle mit Ihrem Index nur neue, geänderte und gelöschte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.

  • CHANGE_LOGum jedes Mal, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird, nur neue und geänderte Inhalte zu indizieren. Amazon Kendra kann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.

• Zugriffstokentyp — Geben Sie an, ob Sie ein permanentes oder ein temporäres Zugriffstoken für Ihr AWS Secrets Manager Geheimnis verwenden möchten, in dem Ihre Authentifizierungsdaten gespeichert werden.

  Anmerkung

  Es wird empfohlen, ein Zugriffstoken für die Aktualisierung zu erstellen, das in Dropbox nie abläuft, anstatt sich auf ein einmaliges Zugriffstoken zu verlassen, das nach 4 Stunden abläuft. Sie erstellen eine App und ein Zugriffstoken für die Aktualisierung in der Dropbox-Entwicklerkonsole und geben das Zugriffstoken geheim an.

• Geheimer Amazon-Ressourcenname (ARN) — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Dropbox-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:

  {
      "appKey": "Dropbox app key",
      "appSecret": "Dropbox app secret",
      "accesstoken": "temporary access token or refresh access token"
  }

• Identity Crawler — Geben Sie an, ob der Identity Crawler aktiviert Amazon Kendra werden soll. Der Identity Crawler verwendet die Informationen der Zugriffskontrollliste (ACL) für Ihre Dokumente, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Wenn Sie über eine ACL für Ihre Dokumente verfügen und Ihre ACL verwenden möchten, können Sie auch den Identity Crawler aktivieren, um die Benutzerkontextfilterung der Suchergebnisse zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn Identity Crawler ausgeschaltet ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die PutPrincipalMappingAPI verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.

• IAM Rolle — Geben Sie anRoleArn, wann Sie anrufenCreateDataSource, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager geheimes Passwort und den Aufruf der erforderlichen öffentlichen APIs für den Dropbox-Connector und zum Aufrufen der erforderlichen öffentlichen APIs zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter IAM Rollen für Dropbox-Datenquellen.

Sie können auch die folgenden optionalen Funktionen hinzufügen:

• Virtual Private Cloud (VPC) — Geben Sie an, VpcConfiguration wann Sie anrufen. CreateDataSource Weitere Informationen finden Sie unter Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC.

• Dokument-/Inhaltstypen — Geben Sie an, ob Dateien in Ihrer Dropbox, Dropbox Paper-Dokumente, Dropbox Paper-Vorlagen und in Ihrer Dropbox gespeicherte Webseitenverknüpfungen gecrawlt werden sollen.

• Ein- und Ausschlussfilter — Geben Sie an, ob bestimmte Dateien ein- oder ausgeschlossen werden sollen.

  Anmerkung

  Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.

• Zugriffskontrollliste (ACL) — Geben Sie an, ob die ACL-Informationen für Ihre Dokumente gecrawlt werden sollen, wenn Sie über eine ACL verfügen und diese für die Zugriffskontrolle verwenden möchten. Die ACL gibt an, auf welche Dokumente Benutzer und Gruppen zugreifen können. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter Benutzerkontextfilterung.

• Feldzuordnungen — Wählen Sie, ob Sie Ihre Dropbox-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuordnen möchten. Weitere Informationen finden Sie unter Zuweisen von Datenquellenfeldern.

  Anmerkung

  Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen_document_body. Alle anderen Felder sind optional.

Eine Liste weiterer wichtiger JSON-Schlüssel, die konfiguriert werden müssen, finden Sie unter Dropbox-Vorlagenschema.

Weitere Informationen

Weitere Informationen zur Integration von Amazon Kendra in Ihre Dropbox-Datenquelle finden Sie unter:

• Indizieren Sie Ihre Dropbox-Inhalte mithilfe des Dropbox-Connectors für Amazon Kendra