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. # Eine Confluence-Datenquelle verbinden Nachdem Sie die Authentifizierung eingerichtet und Ihre Anmeldeinformationen AWS Secrets Manager geheim gespeichert haben, erstellen Sie die Confluence-Datenquelle in Ihrer Wissensdatenbank. Auf dieser Seite wird beschrieben, wie Sie die Datenquelle mit der AWS-Managementkonsole oder der API erstellen, gefolgt von einer Referenz für die Connector-Parameter, die Sie konfigurieren können. **Anmerkung** Schließen Sie zuerst die Einrichtung der Authentifizierung ab. Siehe [User-managed einrichten (3LO)](kb-managed-confluence-3lo-setup.md) (am einfachsten)[Standardauthentifizierung für Confluence einrichten](kb-managed-confluence-basic-setup.md), oder[OAuth 2.0-Authentifizierung für Confluence einrichten](kb-managed-confluence-oauth2-setup.md). Für ein benutzerverwaltetes Setup (3LO) melden Sie sich über die Konsole an und Amazon Bedrock erstellt das Geheimnis für Sie (mit einem vom System generierten ARN). Sie geben die Confluence-Host-URL an, aber kein Geheimnis. Für die anderen Methoden benötigen Sie den geheimen ARN und die Confluence-Host-URL. ## Erstellen Sie die Datenquelle ------ #### [ Console ] **Um Confluence mit deiner verwalteten Wissensdatenbank zu verbinden** 1. Geben Sie unter ** Datenquelle ** einen Namen für Ihre Datenquelle ein. 1. Wähle ** Confluence ** aus dem Drop-down-Menü „Datenquelle“ aus. 1. Geben Sie unter ** Quelle ** Ihre Confluence-URL ein (z. B.). `https://example.atlassian.net` 1. Wählen Sie unter ** Authentifizierung ** ** User-managed Setup (3LO)**, ** Standardauthentifizierung oder ** OAuth ** 2.0-Authentifizierung aus. ** Gib für das benutzerverwaltete Setup (3LO) optional ein ** geheimes Namenspräfix ein und wähle dann Anmelden**, ** um ** dich bei Confluence Cloud anzumelden. Du gibst kein Geheimnis an. Amazon Bedrock erstellt ein Geheimnis mit einem vom System generierten ARN zum Speichern des Tokens. Details hierzu finden Sie unter [User-managed einrichten (3LO)](kb-managed-confluence-3lo-setup.md). 1. Wählen oder erstellen Sie ein AWS Secrets Manager Geheimnis, um Ihre Anmeldeinformationen zu speichern. 1. (Optional, nur Standardauthentifizierung) Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, wählen Sie Dokumentenzugriff mit ** ACLs steuern aus. ** Der von Ihnen gewählte Schlüssel muss, und enthalten`adminApiKey`. `organizationId` `directoryId` Diese Option kann nach der Erstellung nicht mehr geändert werden. Details hierzu finden Sie unter [Document-level Zugriffskontrollen](kb-managed-ds-confluence-acl.md). 1. (Optional) Erweitern Sie den ** Synchronisierungsbereich, ** um auszuwählen, welche Entitätstypen gecrawlt werden sollen (Seiten, Blogs, Seitenanhänge, Bloganhänge, archivierte Bereiche, archivierte Seiten, persönliche Bereiche). 1. (Optional) Erweitern Sie ** Entitäts-URLs**, um mithilfe von URL-based Filtern bestimmte Confluence-Bereiche, -Seiten und Blogs zu synchronisieren. 1. (Optional) Erweitern Sie das Regex-Muster für ** MIME-Typen**, um bestimmte MIME-Typen ein- oder auszuschließen. ------ #### [ API ] Um eine Confluence-Datenquelle zu erstellen, senden Sie eine [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) Anfrage an einen Build-Time-Endpunkt von Agents for Amazon Bedrock. Im folgenden AWS Command Line Interface Beispiel wird eine Datenquelle erstellt, die die Standardauthentifizierung verwendet. Um stattdessen OAuth 2.0 zu verwenden, wechseln Sie `authType` zu. `OAUTH2` Für das benutzerverwaltete Setup (3LO) setzen Sie den Wert auf. `authType` `MANAGED_OAUTH2` Sie können kein 3LO-Geheimnis über die API erstellen: Melden Sie sich zuerst über die Konsole an, um das Geheimnis zu erstellen, und setzen Sie es dann `secretArn` auf den ARN dieses Secrets (siehe). [User-managed einrichten (3LO)](kb-managed-confluence-3lo-setup.md) Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, setzen Sie auf. `aclEnabled` `true` Eine Beschreibung der einzelnen Felder finden Sie in der folgenden Referenz zu den Konnektorparametern. ``` aws bedrock-agent create-data-source \ --name "{{Confluence-connector}}" \ --knowledge-base-id "{{your-knowledge-base-id}}" \ --data-source-configuration file://confluence-managed-connector.json ``` Die `confluence-managed-connector.json` Datei enthält Folgendes: ``` { "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "CONFLUENCE", "version": "1", "aclEnabled": false, "connectionConfiguration": { "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds}}", "type": "SAAS", "authType": "BASIC", "hostUrl": "{{https://example.atlassian.net}}" }, "dataEntityConfiguration": { "crawlPage": true, "crawlBlog": true, "crawlPageAttachment": true, "crawlBlogAttachment": true }, "filterConfiguration": { "inclusionSpaceKeys": ["{{ENG}}", "{{DOCS}}"] } } } } ``` Bei verwalteten Wissensdatenbanken `CreateDataSource` ist dies asynchron: Der Status der Datenquelle wechselt von `CREATING` zu, `AVAILABLE` wenn der Vorgang abgeschlossen ist. ------ ## Connector-Parameter Die Datenquellenkonfiguration verwendet die folgenden Connector-Parameter. Um eine Verbindung zu Confluence herzustellen, geben Sie `CONFLUENCE` als Connector Folgendes ein. `connectorParameters` Informationen zu Feldern, die umgebrochen werden `connectorParameters` (wie `deletionProtectionConfiguration` und`mediaExtractionConfiguration`), finden Sie unter. [Verbinden einer Datenquelle](kb-managed-connect-ds.md) **Setzen Sie `aclEnabled explizit`** Wenn Sie das Feld weglassen`aclEnabled`, hängt die Standardeinstellung ab von`authType`: `BASIC` standardmäßig auf und standardmäßig auf`true`. `OAUTH2` `false` Da die ACL-Konfiguration nach der Erstellung der Datenquelle permanent ist, sollten Sie sie `aclEnabled` explizit so einstellen, dass die Datenquelle das von Ihnen gewünschte Zugriffskontrollverhalten aufweist. Details hierzu finden Sie unter [Document-level Zugriffskontrollen](kb-managed-ds-confluence-acl.md). **connectionConfiguration** | Feld | Erforderlich | Beschreibung | | --- | --- | --- | | secretArn | Ja | Der ARN des AWS Secrets Manager Secrets, das Ihre Confluence-Anmeldeinformationen enthält. | | type | Ja | Der Confluence-Bereitstellungstyp. Setzen Sie diesen Wert auf SAAS. Confluence Server und Data Center werden nicht unterstützt. | | authType | Ja | Der Authentifizierungstyp. Stellen Sie diese Option auf MANAGED\_OAUTH2 (benutzerverwaltetes Setup, 3LO) ein, oder. BASIC OAUTH2 Siehe [Authentifizierungsmethoden](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods). | | hostUrl | Ja | Die Basis-URL Ihrer Confluence Cloud-Instanz (zum Beispiel). https://example.atlassian.net | **Daten EntityConfiguration (optional)** | Feld | Erforderlich | Description | | --- | --- | --- | | crawlPage | Nein | Ob Seiten gecrawlt werden sollen. | | crawlBlog | Nein | Ob Blogbeiträge gecrawlt werden sollen. | | crawlPageAttachment | Nein | Ob Seitenanhänge gecrawlt werden sollen. Nur gecrawlt, wenn es auch crawlPage ist. true | | crawlBlogAttachment | Nein | Ob Anhänge von Blogbeiträgen gecrawlt werden sollen. Nur gecrawlt, wenn es auch crawlBlog ist. true | | crawlArchivedSpace | Nein | Ob archivierte Bereiche gecrawlt werden sollen. | | crawlArchivedPage | Nein | Ob archivierte Seiten gecrawlt werden sollen. | | crawlPersonalSpace | Nein | Ob persönliche Bereiche gecrawlt werden sollen. | **Filterkonfiguration (optional)** | Feld | Erforderlich | Description | | --- | --- | --- | | inclusionSpaceKeys | Nein | Einzuschließende Leerzeichen. | | inclusionSpaceUrls | Nein | Platzieren Sie die einzuschließenden URLs. | | inclusionMimeTypes | Nein | Einzuschließende MIME-Typen. | | exclusionMimeTypes | Nein | Auszuschließende MIME-Typen. | | maxFileSizeInMegaBytes | Nein | Maximale Größe in Megabyte jeder einzelnen Datei, die der Connector aufnimmt. Geben Sie eine numerische Zeichenfolge an (z. B.). "500" Standardeinstellung: "500". | **aclEnabled (optional)** | Feld | Erforderlich | Description | | --- | --- | --- | | aclEnabled | Nein | Ob die Zugriffskontrolle auf Dokumentebene aktiviert ist. Auf „Aktivieren“ oder „Deaktivieren“ false setzen. true Wenn Sie dieses Feld weglassen, hängt die Standardeinstellung ab vonauthType: BASIC standardmäßig auftrue; OAUTH2 standardmäßig auf. false ACL on BASIC erfordert ein geheimes Passwort, das die Administratoranmeldeinformationen der Atlassian-Organisation enthält. Sie können diese Einstellung nicht mehr ändern, nachdem Sie die Datenquelle erstellt haben. Details hierzu finden Sie unter [Document-level Zugriffskontrollen](kb-managed-ds-confluence-acl.md). | ## Ändern Sie die Authentifizierungsmethode Sie können die Authentifizierungsmethode einer Datenquelle ändern (z. B. von OAuth 2.0 auf Basic), indem Sie die Datenquelle mit der neuen `authType` und einem geheimen Schlüssel aktualisieren, der die entsprechenden Anmeldeinformationen enthält. Verwenden Sie dazu den [ UpdateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) Vorgang oder den. AWS-Managementkonsole Die Einstellung für die Zugriffskontrolle auf Dokumentebene wird beim Erstellen einer Datenquelle festgelegt. Um ACLs hinzuzufügen oder zu entfernen, müssen Sie eine neue Datenquelle erstellen. ## Nächste Schritte Nachdem Sie die Datenquelle erstellt haben, synchronisieren Sie sie, um Inhalte in Ihre Wissensdatenbank aufzunehmen. Details hierzu finden Sie unter [Synchronisieren einer Datenquelle](kb-managed-sync.md). Informationen zum Filtern von Abfrageergebnissen nach Benutzerberechtigungen finden Sie unter[Document-level Zugriffskontrollen](kb-managed-ds-confluence-acl.md).