Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Box (Kasten)
Box ist ein Cloud-Speicherdienst, der Funktionen zum Hosten von Dateien bietet. Sie können ihn verwendenAmazon Kendra, um Inhalte in Ihren Box-Inhalten zu indizieren, einschließlich Kommentare, Aufgaben und Weblinks.
Sie können über Amazon Kendra die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/) und die [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API eine Verbindung zu Ihrer Box-Datenquelle herstellen.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Box-Datenquellen-Connector finden Sie unter[Problembehandlung bei Datenquellen](troubleshooting-data-sources.md).
**Topics**
+ [Unterstützte Features](#supported-features-box)
+ [Voraussetzungen](#prerequisites-box)
+ [Anweisungen zur Verbindung](#data-source-procedure-box)
+ [Weitere Informationen](#box-learn-more)
+ [Hinweise](#box-notes)
## Unterstützte Features
Amazon KendraDer Box-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ Änderungsprotokoll, vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Box-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrer Box und AWS Ihren Konten vor.
**Stellen Sie in Box sicher, dass Sie über Folgendes verfügen:**
+ Ein Box Enterprise- oder Box Enterprise Plus-Konto.
+ In der Box Developer Console wurde eine benutzerdefinierte Box-App mit serverseitiger Authentifizierung mithilfe von JSON Web Tokens (JWT) konfiguriert. Weitere Informationen finden Sie in der [Box-Dokumentation zur Erstellung einer benutzerdefinierten App](https://developer.box.com/guides/applications/app-types/platform-apps/) und in der [Box-Dokumentation zur Konfiguration von JWT Auth.](https://developer.box.com/guides/authentication/jwt/)
+ Sie haben Ihre **App-Zugriffsebene** auf **App- und Unternehmenszugriff** festgelegt und die Option **API-Aufrufe mithilfe des Headers „as-user“** zugelassen.
+ Hat den Admin-Benutzer verwendet, um die folgenden **Anwendungsbereiche** zu Ihrer Box-App hinzuzufügen:
+ Alle in einer Box gespeicherten Dateien und Ordner schreiben
+ Benutzer verwalten
+ Gruppen verwalten
+ Unternehmenseigenschaften verwalten
+ Konfiguriertes Public/Private key pair mit einer Client-ID, einem geheimen Clientschlüssel, einer öffentlichen Schlüssel-ID, einer privaten Schlüssel-ID, einer Passphrase und einer Unternehmens-ID, die als Ihre Authentifizierungsdaten verwendet werden sollen. Weitere Informationen finden Sie unter [Paar aus öffentlichem und privatem Schlüssel](https://developer.box.com/guides/authentication/jwt/jwt-setup/#public-and-private-key-pair).
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Es wird **nicht** empfohlen, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.
+ Ihre Box Enterprise ID wurde entweder aus den Einstellungen der Box Developer Console oder aus Ihrer Box-App kopiert. Beispiel, *801234567*.
+ Aktiviert, dass jedes Dokument in Box 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. Dokumente IDs gelten für einen Index global und müssen für jeden Index eindeutig sein.
**Stellen Sie in Ihrem sicherAWS-Konto, dass Sie Folgendes haben:**
+ [Hat einen Amazon Kendra Index erstellt](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) und bei Verwendung der API die Index-ID notiert.
+ Sie [haben eine IAM Rolle für Ihre Datenquelle erstellt](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) 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.
+ Ihre Box-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie die API verwenden, den ARN des Geheimnisses notiert.
**Anmerkung**
Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. 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 Box-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 Box-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Box-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie Box für noch nicht konfiguriert habenAmazon Kendra, finden Sie weitere Informationen unter[Voraussetzungen](#prerequisites-box).
------
#### [ Console ]
**Um eine Verbindung Amazon Kendra zu Box herzustellen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amazon KendraKonsole](https://console.aws.amazon.com/kendra/).
1. 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.
1. Wählen Sie auf der Seite **Erste Schritte** die Option **Datenquelle hinzufügen** aus.
1. Wählen Sie auf der Seite **Datenquelle hinzufügen** die Option **Box-Konnektor** und dann **Konnektor hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie **Box Connector** mit dem Tag „V2.0".
1. **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.
1. (Optional) **Beschreibung** — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.
1. 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.
1. 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
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Zugriff und Sicherheit definieren** die folgenden Informationen ein:
1. **Box Enterprise ID** — Geben Sie Ihre Box Enterprise ID ein. Beispiel, *801234567*.
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](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managergeheim** — Wählen Sie ein vorhandenes Geheimnis aus, oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Box-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Box' wird automatisch zu Ihrem geheimen Namen hinzugefügt.
1. Geben Sie für **Client-ID**, **Client Secret**, **Public Key-ID**, **Private Key-ID** und **Passphrase** die Werte aus dem Public/Private Schlüssel ein, den Sie in Box konfiguriert haben.
1. Fügen Sie Ihr Geheimnis hinzu und speichern Sie es.
1. **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.
1. **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](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) von Suchergebnissen zu konfigurieren. Amazon Kendra Andernfalls können alle Dokumente öffentlich durchsucht werden, wenn der Identity Crawler deaktiviert ist. Wenn Sie die Zugriffskontrolle für Ihre Dokumente verwenden möchten und Identity Crawler ausgeschaltet ist, können Sie alternativ die [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API verwenden, um Benutzer- und Gruppenzugriffsinformationen für die Benutzerkontextfilterung hochzuladen.
1. **IAMRolle** — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.
**Anmerkung**
IAMRollen, 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.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. **Box-Dateien** — Wählen Sie aus, ob Weblinks, Kommentare und Aufgaben gecrawlt werden sollen.
1. Für **zusätzliche Konfigurationen** — Fügen Sie Muster für reguläre Ausdrücke hinzu, um bestimmte Inhalte ein- oder auszuschließen.
1. **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 Kendrakann 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 Kendrakann den Mechanismus Ihrer Datenquelle verwenden, um Inhaltsänderungen nachzuverfolgen und Inhalte zu indexieren, die sich seit der letzten Synchronisierung geändert haben.
1. **Zeitplan für In-Sync-Ausführung** für **Häufigkeit** — Wählen Sie aus, wie oft Ihre Datenquelleninhalte synchronisiert und Ihr Index aktualisiert werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. **Standard-Datenquellenfelder** — Wählen Sie eines der Amazon Kendra generierten Standard-Datenquellenfelder aus, die Sie Ihrem Index zuordnen möchten.
1. **Feld hinzufügen** — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.
1. Wählen Sie **Weiter** aus.
1. Ü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 Box herzustellen**
Mithilfe der [BoxConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BoxConfiguration.html)API müssen Sie Folgendes angeben:
**Box Enterprise ID** — Geben Sie Ihre Box Enterprise ID an. Sie finden die Unternehmens-ID in den Einstellungen der Box Developer Console oder bei der Konfiguration einer App in Box.
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Box-Konto enthält. Das Geheimnis wird in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"clientID": "client-id",
"clientSecret": "client-secret",
"publicKeyID": "public-key-id",
"privateKey": "private-key",
"passphrase": "pass-phrase"
}
```
+ **IAMrole** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis zu gewähren und die erforderliche Öffentlichkeit APIs für den Box-Connector und Amazon Kendra anzurufen. Weitere Informationen finden Sie unter [IAMRollen für Box-Datenquellen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Sie können auch die folgenden optionalen Funktionen hinzufügen:
+ **Virtual Private Cloud (VPC)** — Geben Sie dies `VpcConfiguration` als Teil der Datenquellenkonfiguration an. Siehe [Konfiguration Amazon Kendra für die Verwendung einer VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Änderungsprotokoll** — Gibt an, ob der Change-Log-Mechanismus der Box-Datenquelle verwendet werden Amazon Kendra soll, um zu ermitteln, ob ein Dokument im Index aktualisiert werden muss.
**Anmerkung**
Verwenden Sie das Änderungsprotokoll, wenn Sie nicht alle Dokumente scannen Amazon Kendra möchten. Wenn Ihr Änderungsprotokoll umfangreich ist, nimmt das Scannen der Dokumente in der Box-Datenquelle möglicherweise Amazon Kendra weniger Zeit in Anspruch als das Verarbeiten des Änderungsprotokolls. Wenn Sie Ihre Box-Datenquelle zum ersten Mal mit Ihrem Index synchronisieren, werden alle Dokumente gescannt.
+ **Kommentare, Aufgaben, Weblinks** — Geben Sie an, ob diese Inhaltstypen gecrawlt 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 Inklusionsfilter 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.
+ **Ein- und Ausschlussfilter** — Geben Sie an, ob bestimmte Box-Dateien und -Ordner 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.
+ **Benutzerkontextfilterung und Zugriffskontrolle** — Amazon Kendra durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie über eine ACL für Ihre Dokumente verfügen. Die ACL-Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter [Benutzerkontextfilterung](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Box-Datenquellenfelder Ihren Amazon Kendra Indexfeldern zuzuordnen. Weitere Informationen finden Sie unter [Zuweisen von Datenquellenfeldern](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**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.
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Box-Datenquelle finden Sie unter:
+ [Erste Schritte mit dem Amazon Kendra Box Connector](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-box-connector/)
## Hinweise
+ Wenn Zugriffskontrolllisten (ACLs) aktiviert sind, ist die Option „Nur neue oder geänderte Inhalte synchronisieren“ aufgrund von Box-API-Einschränkungen nicht verfügbar. Wir empfehlen, stattdessen die Modi „Vollständige Synchronisierung“ oder „Neue, geänderte oder gelöschte Inhalte“ zu verwenden oder sie zu deaktivieren, ACLs falls Sie diesen Synchronisierungsmodus verwenden müssen.