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 Connect 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 zu den Konnektorparametern, die Sie konfigurieren können. **Anmerkung** Schließen Sie zuerst die Einrichtung der Authentifizierung ab. Weitere Informationen unter [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). Sie benötigen den geheimen ARN und die Confluence-Host-URL. ## Erstellen Sie die Datenquelle ------ #### [ Console ] **Um Confluence mit Ihrer verwalteten Wissensdatenbank zu verbinden** 1. Geben Sie unter **Datenquelle** einen Namen für Ihre Datenquelle ein. 1. Wählen Sie **Confluence aus dem Drop-down-Menü** für die Datenquelle aus. 1. Geben Sie unter **Quelle** Ihre Confluence-URL ein (z. B.). `https://example.atlassian.net` 1. Wählen Sie unter **Authentifizierung** die Option **Standardauthentifizierung oder **OAuth** 2.0-Authentifizierung** aus. 1. Wählen Sie ein AWS Secrets Manager Geheimnis aus, um Ihre Anmeldeinformationen zu speichern, oder erstellen Sie ein solches. 1. (Optional, nur Standardauthentifizierung) Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, wählen Sie **Dokumentenzugriff mit ACLs kontrollieren** aus. Das von Ihnen ausgewählte Geheimnis muss, und enthalten`adminApiKey`. `organizationId` `directoryId` Diese Option kann nach der Erstellung nicht 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 mit einem 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` Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, setzen Sie auf. `aclEnabled` `true` Eine Beschreibung der einzelnen Felder finden Sie in der nachfolgenden 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` erfolgt der Vorgang asynchron: Der Status der Datenquelle wechselt von `CREATING` zu, `AVAILABLE` wenn der Vorgang abgeschlossen ist. ------ ## Connector-Parameter Die Datenquellenkonfiguration verwendet die folgenden Konnektorparameter. Um eine Verbindung zu Confluence herzustellen, geben Sie `CONFLUENCE` als Konnektortyp in an. `connectorParameters` Informationen zu Feldern, die umbrechen `connectorParameters` (z. B. `deletionProtectionConfiguration` und`mediaExtractionConfiguration`), finden Sie unter. [Verbinden einer Datenquelle](kb-managed-connect-ds.md) **Legen Sie `ACLEnabled explizit fest`** Wenn Sie den Wert weglassen`aclEnabled`, hängt der Standardwert von folgenden Faktoren ab`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 beabsichtigte Zugriffssteuerungsverhalten 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. Auf oder eingestellt. BASIC OAUTH2 Siehe [Authentifizierungsmethoden](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods). | | hostUrl | Ja | Die Basis-URL Ihrer Confluence Cloud-Instanz (zum Beispielhttps://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 die 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 | Leertaste, die hinzugefügt werden soll. | | inclusionSpaceUrls | Nein | Einzuschließende Leerzeichen-URLs. | | inclusionMimeTypes | Nein | Einzuschließende MIME-Typen. | | exclusionMimeTypes | Nein | Auszuschließende MIME-Typen. | | maxFileSizeInMegaBytes | Nein | Maximale Größe jeder einzelnen Datei, die der Connector aufnimmt, in Megabyte. Geben Sie eine numerische Zeichenfolge an (z. B.). "500" Standardeinstellung: "500". | **ACL aktiviert (optional)** | Feld | Erforderlich | Description | | --- | --- | --- | | aclEnabled | Nein | Ob die Zugriffskontrolle auf Dokumentebene aktiviert ist. Stellen Sie true auf „Aktivieren“ oder „Deaktivieren“ false ein. Wenn Sie dieses Feld weglassen, hängt die Standardeinstellung von folgenden Faktoren abauthType: BASIC standardmäßig auftrue; OAUTH2 standardmäßig auf. false Für ACL on BASIC ist ein geheimer Schlüssel erforderlich, der die Administratoranmeldedaten der Atlassian-Organisation enthält. Du kannst diese Einstellung nicht ändern, nachdem du die Datenquelle erstellt hast. 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 dem neuen `authType` und einem geheimen Schlüssel, der die entsprechenden Anmeldeinformationen enthält, aktualisieren. 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 ist festgelegt, wenn Sie eine Datenquelle erstellen. Um ACLs hinzuzufügen oder zu entfernen, müssen Sie also 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).