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.
# Zusammenfluss
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Amazon Kendra unterstützt sowohl Confluence Center als auch Confluence Cloud. Server/Data Sie können die folgenden Amazon Kendra Confluence-Entitäten zum Indizieren verwenden:
+ **Bereiche** — Auf oberster Ebene ausgewiesene Bereiche für die Organisation verwandter Inhalte. Jeder Bereich dient als Container, der mehrere Seiten, Blogs und Anhänge aufnehmen kann.
+ **Seiten** — Einzelne Dokumente innerhalb eines Bereichs, in dem Benutzer Inhalte erstellen und verwalten. Seiten können Text, Bilder, Tabellen und Multimediaelemente enthalten und können verschachtelte Unterseiten haben. Jede Seite wird als einzelnes Dokument betrachtet.
+ **Blogs** – Inhalte, die Seiten ähneln und in der Regel für Updates oder Ankündigungen verwendet werden. Jeder Blogbeitrag wird als einzelnes Dokument betrachtet.
+ **Kommentare** — Ermöglicht es Benutzern, Feedback zu geben oder sich an Diskussionen zu bestimmten Inhalten innerhalb von Seiten oder Blogbeiträgen zu beteiligen.
+ **Anhänge** — Dateien, die auf Seiten oder Blogbeiträge in Confluence hochgeladen wurden, wie Bilder, Dokumente oder andere Dateitypen.
Standardmäßig indexiert Confluence-Archive und persönliche Bereiche Amazon Kendra nicht. Sie können wählen, ob sie bei der Erstellung der Datenquelle indexiert werden sollen. Wenn Sie einen Bereich nicht Amazon Kendra indexieren möchten, markieren Sie ihn in Confluence als privat.
Du kannst dich entweder über Amazon Kendra die [Amazon Kendra Konsole](https://console.aws.amazon.com/kendra/), die API oder die [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API mit deiner Confluence-Datenquelle verbinden. [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)
Amazon Kendra hat zwei Versionen des Confluence-Connectors. Die folgenden Funktionen werden unterstützt.
****Confluence-Konnektor V2.0//API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)****
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Muster von Inklusionen/Ausschlüssen
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
****Confluence Connector V1.0/[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API** (nicht mehr unterstützt)**
+ Feldzuordnungen
+ Kontrolle des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ (Nur Confluence Server) Virtuelle private Cloud (VPC)
**Anmerkung**
Confluence Connector V1.0/API endete 2023. ConfluenceConfiguration Wir empfehlen, zu Confluence Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## ACLs im Confluence Connector
](#data-source-confluence-acls)
+ [
# Confluence-Konnektor V2.0
](data-source-v2-confluence.md)
+ [
# Confluence-Konnektor V1.0
](data-source-v1-confluence.md)
## ACLs im Confluence Connector
Connectoren unterstützen das Crawlen von Zugriffskontrolllisten (ACLs) und die Identifizierung von Informationen, sofern zutreffend, anhand der Datenquelle. Wenn Sie Dokumente ohne diese Option indizieren ACLs, gelten alle Dokumente als öffentlich. Die Indizierung von Dokumenten mit ACLs gewährleistet die Datensicherheit.
Der Amazon Kendra Confluence-Connector scannt Bereiche, um Seiten und Blogbeiträge zusammen mit ihren Inhalten zu sammeln. ACLs Wenn für eine Seite oder einen Blog keine Einschränkung gilt, erbt der Connector die Berechtigungen von seinem Bereich. Wenn auf einer Seite eine bestimmte Benutzer- oder Gruppenbeschränkung angewendet wird, können nur diese Benutzer auf diese Seite zugreifen. Wenn die Seite verschachtelt ist, erbt die verschachtelte Seite die Berechtigungen der übergeordneten Seite, sofern keine Einschränkungen angewendet werden. Ein ähnliches Berechtigungsmodell gilt für Blogs. Confluence unterstützt jedoch keine verschachtelten Blogs.
Darüber hinaus crawlt Amazon Kendra Confluence Connector Benutzerprinzipalinformationen (lokaler Benutzeralias, lokale Gruppen- und Verbundgruppen-Identitätskonfigurationen) und deren Berechtigungen für jeden konfigurierten Bereich.
**Anmerkung**
Der Confluence Cloud Connector unterstützt das Crawlen von Makros, Whiteboards oder Datenbanken nicht.
Der Amazon Kendra Confluence-Connector aktualisiert die ACL-Änderungen jedes Mal, wenn er Ihre Datenquelleninhalte crawlt. Um sicherzustellen, dass die richtigen Benutzer Zugriff auf die richtigen Inhalte haben, sollten Sie Ihre Datenquelle regelmäßig erneut synchronisieren, um alle ACL-Aktualisierungen zu erfassen.
# Confluence-Konnektor V2.0
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Sie können Amazon Kendra es verwenden, um Ihre Confluence-Bereiche, Seiten (einschließlich verschachtelter Seiten), Blogs sowie Kommentare und Anhänge zu indexierten Seiten und Blogs zu indizieren.
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v2-confluence)
+ [
## Voraussetzungen
](#prerequisites-v2-confluence)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v2-confluence)
## Unterstützte Features
Amazon Kendra Der Confluence-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Muster von Inklusionen/Ausschlüssen
+ Vollständige und inkrementelle Inhaltssynchronisierung
+ Virtual Private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Confluence-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Confluence und Ihren Konten vor. AWS
**Stellen Sie in Confluence sicher, dass Sie:**
+ Die URL deiner Confluence-Instanz wurde kopiert. Zum Beispiel:*https://example.confluence.com*, oder*https://www.example.confluence.com/*, oder. *https:// atlassian.net/* Sie benötigen die URL Ihrer Confluence-Instanz, um eine Verbindung herzustellen. Amazon Kendra
Wenn du Confluence Cloud verwendest, muss deine Host-URL mit enden. *atlassian.net/*
**Anmerkung**
Die folgenden URL-Formate werden **nicht** unterstützt:
*https://example.confluence.com/xyz*
*https://www.example.confluence.com//wiki/spacekey/xxx*
*https://atlassian.net/xyz*
**Anmerkung**
(On-Premise/Server) Amazon Kendra überprüft, ob die in AWS Secrets Manager der Datei enthaltenen Endpunktinformationen mit den Endpunktinformationen übereinstimmen, die in den Konfigurationsdetails Ihrer Datenquelle angegeben sind. Dies trägt zum Schutz vor dem [Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) bei, bei dem es sich um ein Sicherheitsproblem handelt, bei dem ein Benutzer nicht berechtigt ist, eine Aktion auszuführen, sondern ihn Amazon Kendra als Proxy verwendet, um auf das konfigurierte Geheimnis zuzugreifen und die Aktion auszuführen. Wenn Sie Ihre Endpunktinformationen später ändern, müssen Sie ein neues Geheimnis erstellen, um diese Informationen zu synchronisieren.
+ Konfigurierte Basisauthentifizierungsdaten, die einen Benutzernamen (E-Mail-ID, die für die Anmeldung bei Confluence verwendet wurde) und ein Passwort (Confluence-API-Token als Passwort) enthalten. Weitere Informationen findest du unter [API-Token für dein Atlassian-Konto verwalten](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token).
**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.
+ **Optional:** Konfigurierte OAuth 2.0-Anmeldeinformationen, die einen Confluence-App-Schlüssel, ein Confluence-App-Secret, ein Confluence-Zugriffstoken und ein Confluence-Aktualisierungstoken enthalten, um eine Verbindung zu Ihrer Confluence-Instanz herzustellen. Amazon Kendra Wenn Ihr Zugriffstoken abläuft, können Sie entweder das Aktualisierungstoken verwenden, um Ihr Zugriffstoken und Ihr Aktualisierungstokenpaar neu zu generieren. Oder Sie können den Autorisierungsvorgang wiederholen. Weitere Informationen zu Zugriffstoken finden Sie unter [ OAuth Zugriffstoken verwalten](https://support.atlassian.com/confluence-cloud/docs/manage-oauth-access-tokens/).
+ (Nur für Confluence Server/Data Center) **Optional:** In Confluence wurde ein Personal Access Token (PAT) konfiguriert. Siehe Persönliche Zugriffstoken [verwenden](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
**Stellen Sie sicher AWS-Konto, dass Sie Folgendes in Ihrem 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.
+ Du hast deine Confluence-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Secrets 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 du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Confluence-Datenquelle mit verbindest. 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 Confluence-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Confluence-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Confluence noch nicht konfiguriert haben, finden Sie weitere Informationen unter. Amazon Kendra [Voraussetzungen](#prerequisites-v2-confluence)
------
#### [ Console ]
**Um eine Verbindung zu Confluence herzustellen Amazon Kendra **
1. [Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Kendra Konsole.](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 **Confluence-Konnektor und dann Konnektor** **hinzufügen** aus. Wenn Sie Version 2 verwenden (falls zutreffend), wählen Sie den **Confluence-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. Wählen Sie unter **Quelle** entweder **Confluence Cloud oder ** Server/Data Confluence**** Center aus.
1. **Confluence-URL — Geben Sie die Confluence-Host-URL ein**. Beispiel, *https://example.confluence.com*.
1. (Nur für Confluence Server/Data Center) **Speicherort des SSL-Zertifikats — *optional* — Geben Sie den Amazon S3 Pfad zu Ihrer SSL-Zertifikatsdatei** für Confluence Server ein.
1. (Nur für Confluence Server/Data Center) **Web-Proxy — *optional* — Geben Sie den Web-Proxy-Hostnamen** (ohne das `http://` `https://` OR-Protokoll) und die Portnummer (Port, der vom Host-URL-Transportprotokoll verwendet wird) ein. Die Portnummer sollte ein numerischer Wert zwischen 0 und 65535 sein.
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. **Authentifizierung** **— Wählen Sie entweder **Standardauthentifizierung**, **OAuth 2.0-Authentifizierung** oder (nur für Confluence Server/Data Center) Authentifizierung mit Personal Access Token.**
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet. Geben Sie die folgenden Informationen in das Fenster ein:
1. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Wenn Sie die **Standardauthentifizierung** verwenden — Geben Sie den geheimen Namen, den Benutzernamen und das Passwort (Confluence-API-Token als Passwort) ein, die Sie in Confluence konfiguriert haben.
Wenn Sie die **OAuth22.0-Authentifizierung** verwenden — Geben Sie den geheimen Namen, den App-Schlüssel, den geheimen App-Schlüssel, das Zugriffstoken und das Aktualisierungstoken ein, die Sie in Confluence konfiguriert haben.
(Nur Confluence Server/Data Center) Wenn Sie die **Authentifizierung mit einem Personal Access Token verwenden — Geben Sie den geheimen Namen und das Confluence-Token** ein, die Sie in Ihrem Confluence konfiguriert haben.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
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. **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.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Im **Bereich Synchronisieren** für **Inhalte synchronisieren** — Wählen Sie aus den folgenden Inhaltstypen aus, ob Sie synchronisieren möchten: Seiten, Seitenkommentare, Seitenanhänge, Blogs, Blogkommentare, Bloganhänge, persönliche Bereiche und archivierte Bereiche.
**Anmerkung**
**Seitenkommentare und Seitenanhänge können nur ausgewählt werden, wenn Sie Seiten synchronisieren möchten.** **Blogkommentare und Bloganhänge können nur ausgewählt werden, wenn Sie Blogs synchronisieren möchten.**
**Wichtig**
Wenn Sie unter **Zusätzliche Konfiguration** kein Regex-Muster mit Leertaste angeben, werden standardmäßig alle Seiten und Blogs gecrawlt.
1. Geben Sie unter **Zusätzliche Konfiguration** für **Maximale Dateigröße die Dateigrößenbeschränkung** an, die gecrawlt werden soll. MBs Amazon Kendra Amazon Kendra durchsucht nur die Dateien innerhalb der von Ihnen definierten Größenbeschränkung. Die Standarddateigröße beträgt 50 MB. Die maximale Dateigröße sollte größer als 0 MB und kleiner oder gleich 50 MB sein.
Für **Spaces-Regex-Muster** — Geben Sie wie folgt an, ob bestimmte Leerzeichen in Ihren Index aufgenommen oder ausgeschlossen werden sollen:
+ Leertaste (zum Beispiel) *my-space-123*
**Anmerkung**
Wenn Sie kein Regex-Muster für die Leertaste angeben, werden standardmäßig alle Seiten und Blogs gecrawlt.
+ URL (zum Beispiel) *.\$1/MySite/MyDocuments/*
+ Dateityp (zum Beispiel*.\$1\$1.pdf, .\$1\$1.txt*)
Für **Regex-Muster für Entitätstitel** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Blogs, Seiten, Kommentare und Anlagen anhand von Titeln ein- oder auszuschließen.
**Anmerkung**
Wenn Sie das Crawlen einer bestimmten Seite oder Unterseite ein- oder ausschließen möchten, können Sie Regex-Muster für Seitentitel verwenden.
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, 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.
1. 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.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten. Um benutzerdefinierte Datenquellenfelder hinzuzufügen, erstellen Sie einen Indexfeldnamen für die Zuordnung und den Felddatentyp.
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 Confluence herzustellen**
Sie müssen mithilfe der API ein JSON des [Datenquellenschemas](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) angeben. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Sie müssen die folgenden Informationen angeben:
+ **Datenquelle** — Geben Sie den Datenquellentyp wie `CONFLUENCEV2` bei der Verwendung des [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON-Schemas an. Geben Sie außerdem die Datenquelle so an`TEMPLATE`, wie Sie die [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API aufrufen.
+ **Host-URL** — Geben Sie die Confluence-Host-URL-Instanz an. Beispiel, *https://example.confluence.com*.
+ **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_CRAWL`um den gesamten Inhalt neu zu indizieren und vorhandene Inhalte jedes Mal zu ersetzen, wenn Ihre Datenquelle mit Ihrem Index synchronisiert wird.
+ `FULL_CRAWL`um 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.
+ **Authentifizierungstyp** — Geben Sie den Authentifizierungstyp an, ob`Basic`,`OAuth2`, (nur Confluence Server). `Personal-token`
+ (Optional — Nur für Confluence Server) **Speicherort des SSL-Zertifikats — Geben Sie das Land an, das Sie zum Speichern Ihres SSL-Zertifikats verwendet** haben. `S3bucketName` `s3certificateName`
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die von Ihnen in Confluence konfigurierten Authentifizierungsdaten enthält. Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"username": "email ID or user name",
"password": "Confluence API token"
}
```
Wenn Sie die OAuth 2.0-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"confluenceAppKey": "app key",
"confluenceAppSecret": "app secret",
"confluenceAccessToken": "access token",
"confluenceRefreshToken": "refresh token"
}
```
(Nur für Confluence Server) Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"hostUrl": "Confluence Server host URL",
"username": "Confluence Server user name",
"password": "Confluence Server password"
}
```
(Nur für Confluence Server) Wenn Sie die Authentifizierung mit dem Personal Access Token verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:
```
{
"hostUrl": "Confluence Server host URL",
"patToken": "personal access token"
}
```
+ **IAM role** — Geben Sie an`RoleArn`, wann Sie anrufen`CreateDataSource`, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager geheimes Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Confluence-Connector und zu erteilen. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Confluence-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 an, `VpcConfiguration` wann Sie anrufen. `CreateDataSource` Weitere Informationen finden Sie unter [Konfiguration für Amazon Kendra die Verwendung eines Amazon VPC](vpc-configuration.md).
+ **Dateigröße** — Geben Sie die maximale Dateigröße für das Crawlen an.
+ **Dokument-/Inhaltstypen** — Geben Sie an, ob Seiten, Seitenkommentare, Seitenanhänge, Blogs, Blogkommentare, Bloganhänge, Bereiche und archivierte Bereiche gecrawlt werden sollen.
+ **Inklusions- und Ausschlussfilter** — Geben Sie an, ob bestimmte Bereiche, Seiten, Blogs sowie deren Kommentare und Anlagen 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.
+ **Web-Proxy** — Geben Sie Ihre Web-Proxy-Informationen an, wenn Sie über einen Webproxy eine Verbindung zu Ihrer Confluence-URL-Instanz herstellen möchten. Sie können diese Option für Confluence Server verwenden.
+ **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](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **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.
+ **Feldzuordnungen** — Wählen Sie, ob Sie Ihre Confluence-Datenquellenfelder Ihren Indexfeldern zuordnen möchten. Amazon Kendra 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 zu können. Amazon Kendra 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 [Confluence-Template-Schema](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema).
------
### Hinweise
+ Personal Access Token (PAT) ist für Confluence Cloud nicht verfügbar.
# Confluence-Konnektor V1.0
Confluence ist ein kollaboratives Arbeitsmanagement-Tool, das für die gemeinsame Nutzung, Speicherung und Bearbeitung von Projekten, Softwareentwicklung und Produktmanagement entwickelt wurde. Sie können Amazon Kendra es verwenden, um Ihre Confluence-Bereiche, Seiten (einschließlich verschachtelter Seiten), Blogs sowie Kommentare und Anhänge zu indexierten Seiten und Blogs zu indizieren.
**Anmerkung**
Confluence Connector V1.0/API endete 2023. ConfluenceConfiguration Wir empfehlen, zu Confluence Connector V2.0/ API zu migrieren oder diesen zu verwenden. TemplateConfiguration
Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Confluence-Datenquellen-Connector finden Sie unter. [Problembehandlung bei Datenquellen](troubleshooting-data-sources.md)
**Topics**
+ [
## Unterstützte Features
](#supported-features-v1-confluence)
+ [
## Voraussetzungen
](#prerequisites-v1-confluence)
+ [
## Anweisungen zur Verbindung
](#data-source-procedure-v1-confluence)
+ [
## Weitere Informationen
](#confluence-v1-learn-more)
## Unterstützte Features
Amazon Kendra Der Confluence-Datenquellen-Connector unterstützt die folgenden Funktionen:
+ Feldzuordnungen
+ Steuerung des Benutzerzugriffs
+ Einschluss- und Ausschlussfilter
+ (Nur für Confluence Server) Virtuelle private Cloud (VPC)
## Voraussetzungen
Bevor Sie Ihre Confluence-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Confluence und Ihren Konten vor. AWS
**Stellen Sie in Confluence sicher, dass Sie über Folgendes verfügen:**
+ Du hast mir die Amazon Kendra Erlaubnis erteilt, alle Inhalte in deiner Confluence-Instanz anzusehen, indem du:
+ Mitglied Amazon Kendra einer Gruppe werden. `confluence-administrators`
+ Gewährung von Site-Admin-Rechten für alle vorhandenen Bereiche, Blogs und Seiten.
+ Die URL deiner Confluence-Instanz wurde kopiert.
+ **Für SSO-Benutzer (Single Sign-On):** Bei der Konfiguration der **Confluence-Authentifizierungsmethoden** in Confluence Data Center wurde die Option **Auf der Anmeldeseite anzeigen** für den Benutzernamen und das Passwort aktiviert.
+ **Für Confluence Server**
+ Haben Sie Ihre grundlegenden Authentifizierungsdaten notiert, die den Benutzernamen und das Passwort Ihres Confluence-Administratorkontos enthalten, mit dem Sie sich verbinden möchten. Amazon Kendra
**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 (falls zutreffend) wiederzuverwenden.
+ **Optional: Es** wurde ein persönliches Zugriffstoken in Ihrem Confluence-Konto generiert, mit dem Sie sich verbinden können. Amazon Kendra Weitere Informationen finden Sie in der [Confluence-Dokumentation zur Generierung persönlicher Zugriffstoken](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
+ **Für Confluence Cloud**
+ Haben Sie Ihre grundlegenden Authentifizierungsdaten notiert, die den Benutzernamen und das Passwort Ihres Confluence-Administratorkontos für die Verbindung enthalten. Amazon Kendra
+ Aktiviert, dass jedes Dokument in Confluence 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 sicher AWS-Konto, dass Sie:**
+ [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.
+ Du hast deine Confluence-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls du die API verwendest, den ARN des Secrets 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 du noch keine IAM Rolle oder keinen Schlüssel hast, kannst du die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn du deine Confluence-Datenquelle mit verbindest. 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 Confluence-Datenquelle herzustellen, müssen Sie Details zu Ihren Confluence-Anmeldeinformationen angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Confluence noch nicht konfiguriert haben, finden Sie weitere Informationen unter. Amazon Kendra [Voraussetzungen](#prerequisites-v1-confluence)
------
#### [ Console ]
**Um eine Verbindung zu Confluence herzustellen Amazon Kendra **
1. [Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Kendra Konsole.](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 **Confluence Connector V1.0** und dann Datenquelle **hinzufügen** aus.
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. Wählen Sie zwischen **Confluence Cloud** und **Confluence** Server.
1. Wenn Sie sich für **Confluence Cloud** entscheiden, geben Sie die folgenden Informationen ein:
1. **Confluence-URL — Ihre Confluence-URL**.
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-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. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie Ihren Confluence-Benutzernamen und Ihr Passwort ein.
1. **Wählen Sie Authentifizierung speichern.**
1. Wenn Sie **Confluence Server** wählen, geben Sie die folgenden Informationen ein:
1. **Confluence-URL** — Ihr Confluence-Benutzername und Ihr Passwort.
1. (Optional) Geben Sie für den **Web-Proxy** die folgenden Informationen ein:
1. **Hostname** — Hostname für Ihr Confluence-Konto.
1. **Portnummer — Port**, der vom Host-URL-Transportprotokoll verwendet wird.
1. Wählen Sie für **Authentifizierung** entweder **Standardauthentifizierung** oder **Personal** Access Token (nur Confluence Server).
1. **AWS Secrets Manager geheim** — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre Confluence-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. **Secret-Name** – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-Confluence-' wird Ihrem geheimen Namen automatisch hinzugefügt.
1. Für **Benutzername** und **Passwort** — Geben Sie die Werte für die Authentifizierungsdaten ein, die Sie in Confluence konfiguriert haben. Wenn Sie die Standardauthentifizierung verwenden, verwenden Sie Ihren Confluence-Benutzernamen (E-Mail-ID) und Ihr Passwort (API-Token). Wenn Sie ein persönliches Zugriffstoken verwenden, geben Sie die Details des **persönlichen Zugriffstokens** ein, das Sie im Confluence-Konto konfiguriert haben.
1. Speichern Sie Ihr Geheimnis und fügen Sie es hinzu.
1. **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.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **„Synchronisierungseinstellungen konfigurieren**“ die folgenden Informationen ein:
1. Für **Persönliche Bereiche einbeziehen** und **Archivierte Bereiche einbeziehen** — Wählen Sie die optionalen Bereichstypen aus, die in diese Datenquelle aufgenommen werden sollen.
1. Für **zusätzliche Konfigurationen** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Inhalte ein- oder auszuschließen. Sie können bis zu 100 Muster hinzufügen.
1. Sie können auch festlegen, dass **Anlagen innerhalb bestimmter Bereiche gecrawlt** werden.
1. Wählen Sie im **Zeitplan für die Synchronisierungsausführung unter** **Häufigkeit** aus, wie oft mit Ihrer Datenquelle synchronisiert Amazon Kendra werden soll.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Feldzuordnungen festlegen** die folgenden Informationen ein:
1. Für **Space**, **Page**, **Blog** — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern oder **Zusätzliche vorgeschlagene Feldzuordnungen**, um Indexfelder hinzuzufügen.
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 Confluence herzustellen**
Sie müssen mithilfe [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)der API Folgendes angeben:
+ **Confluence-Version** — Geben Sie die Version der Confluence-Instanz an, die Sie als oder verwenden. `CLOUD` `SERVER`
+ **Geheimer Amazon-Ressourcenname (ARN)** — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Secrets ein, das Ihre Confluence-Authentifizierungsdaten enthält.
Wenn Sie Confluence Server verwenden, können Sie entweder Ihren Confluence-Benutzernamen und Ihr Passwort oder Ihr persönliches Zugriffstoken als Authentifizierungsdaten verwenden.
Wenn Sie Ihren Confluence-Benutzernamen und Ihr Passwort als Authentifizierungsdaten verwenden, speichern Sie die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"username": "user name",
"password": "password"
}
```
Wenn Sie ein persönliches Zugriffstoken verwenden, um eine Verbindung zu Confluence Server herzustellen Amazon Kendra, speichern Sie die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"patToken": "personal access token"
}
```
Wenn Sie Confluence Cloud verwenden, verwenden Sie Ihren Confluence-Benutzernamen und ein in Confluence konfiguriertes API-Token als Passwort. Sie speichern die folgenden Anmeldeinformationen als JSON-Struktur in Ihrem Secret: Secrets Manager
```
{
"username": "user name",
"password": "API token"
}
```
+ **IAM role** — 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 Confluence-Connector aufzurufen und. Amazon Kendra Weitere Informationen finden Sie unter [IAM Rollen für Confluence-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:
+ **Web-Proxy** — Gibt an, ob Sie über einen Web-Proxy eine Verbindung zu Ihrer Confluence-URL-Instanz herstellen möchten. Sie können diese Option für Confluence Server verwenden.
+ (Nur für Confluence Server) **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).
+ **Inklusions- und Ausschlussfilter** — Geben Sie Muster für reguläre Ausdrücke an, um bestimmte Bereiche, Blogbeiträge, Seiten, Bereiche und Anlagen ein- oder auszuschließen. Wenn Sie Anlagen indexieren möchten, werden nur Anlagen zu den indizierten Seiten und Blogs indexiert.
**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.
+ **Feldzuordnungen** — Wählen Sie diese Option, um Ihre Confluence-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra 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 zu können. Amazon Kendra Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen`_document_body`. Alle anderen Felder sind optional.
+ **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).
------
## Weitere Informationen
Weitere Informationen zur Integration Amazon Kendra mit Ihrer Confluence-Datenquelle finden Sie unter:
+ [Konfiguration Ihres Amazon Kendra Confluence Server-Connectors](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)