Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Conectar una fuente de datos de Confluence Después de configurar la autenticación y almacenar tus credenciales en AWS Secrets Manager secreto, crea la fuente de datos de Confluence en tu base de conocimientos. En esta página, se describe cómo crear la fuente de datos con la API Consola de administración de AWS o la API, y se incluye una referencia para los parámetros del conector que puedes configurar. **nota** Complete primero la configuración de la autenticación. Consulte [User-managed configuración (3LO)](kb-managed-confluence-3lo-setup.md) (la más simple)[Configurar la autenticación básica para Confluence](kb-managed-confluence-basic-setup.md), o[Configurar la autenticación OAuth 2.0 para Confluence](kb-managed-confluence-oauth2-setup.md). En el caso de la configuración gestionada por el usuario (3LO), debes iniciar sesión a través de la consola y Amazon Bedrock crea el secreto automáticamente (con un ARN generado por el sistema); tú proporcionas la URL del host de Confluence, pero no un secreto. Para los demás métodos, necesitas el ARN secreto y la URL del host de Confluence. ## Crea la fuente de datos ------ #### [ Console ] **Para conectar Confluence a tu base de conocimientos gestionada** 1. En Fuente ** de datos**, proporciona un nombre para tu fuente de datos. 1. Selecciona ** Confluence en el menú desplegable ** de fuentes de datos. 1. En ** Fuente**, introduce tu URL de Confluence (por ejemplo,). `https://example.atlassian.net` 1. En ** Autenticación**, selecciona ** User-managed Configuración (3LO)**, Autenticación ** básica o Autenticación ** ** OAuth 2.0. ** Para la configuración gestionada por el usuario (3LO), si lo desea, introduzca un prefijo de nombre ** secreto y, a continuación**, seleccione ** Iniciar sesión ** para iniciar sesión en Confluence Cloud. No proporcionas ningún secreto. Amazon Bedrock crea un secreto con un ARN generado por el sistema para almacenar el token. Para obtener más información, consulte [User-managed configuración (3LO)](kb-managed-confluence-3lo-setup.md). 1. Seleccione o cree un AWS Secrets Manager secreto para almacenar sus credenciales. 1. (Opcional, solo autenticación básica) Para habilitar el control de acceso a nivel de documento, seleccione ** Controlar el acceso a los documentos con ACL. ** El secreto que selecciones debe incluir`adminApiKey`, y. `organizationId` `directoryId` Esta opción no se puede cambiar después de la creación. Para obtener más información, consulte [Document-level controles de acceso](kb-managed-ds-confluence-acl.md). 1. (Opcional) Amplíe el alcance de la ** sincronización ** para elegir qué tipos de entidades rastrear (páginas, blogs, archivos adjuntos de páginas, archivos adjuntos de blogs, espacios archivados, páginas archivadas, espacios personales). 1. (Opcional) Amplía las URL de las ** entidades ** para usar los URL-based filtros para sincronizar espacios, páginas y blogs específicos de Confluence. 1. (Opcional) Amplía el patrón de ** expresiones regulares de los tipos MIME ** para incluir o excluir tipos MIME específicos. ------ #### [ API ] Para crear una fuente de datos de Confluence, envía una [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) solicitud a un punto final en tiempo de compilación de Agents for Amazon Bedrock. En el siguiente AWS Command Line Interface ejemplo, se crea una fuente de datos que utiliza la autenticación básica. Para usar OAuth 2.0 en su lugar, cambie `authType` a. `OAUTH2` Para la configuración gestionada por el usuario (3LO), configúrela en. `authType` `MANAGED_OAUTH2` No puedes crear un secreto de 3LO a través de la API: primero inicia sesión en la consola para crear el secreto y, a continuación, establece `secretArn` el ARN de ese secreto (consulta). [User-managed configuración (3LO)](kb-managed-confluence-3lo-setup.md) Para habilitar el control de acceso a nivel de documento, configúrelo en. `aclEnabled` `true` Para obtener una descripción de cada campo, consulte la referencia a los parámetros del conector que aparece a continuación. ``` aws bedrock-agent create-data-source \ --name "{{Confluence-connector}}" \ --knowledge-base-id "{{your-knowledge-base-id}}" \ --data-source-configuration file://confluence-managed-connector.json ``` El `confluence-managed-connector.json` archivo contiene lo siguiente: ``` { "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}}"] } } } } ``` En el caso de las bases de conocimiento administradas, `CreateDataSource` es asincrónico: el estado de la fuente de datos pasa de `CREATING` a `AVAILABLE` cuando se completa la operación. ------ ## Parámetros de conector La configuración de la fuente de datos usa los siguientes parámetros de conector. Para conectarse a Confluence, especifique `CONFLUENCE` el tipo de conector. `connectorParameters` Para ver los campos que se `connectorParameters` agrupan (como `deletionProtectionConfiguration` y`mediaExtractionConfiguration`), consulta[Conexión de un origen de datos](kb-managed-connect-ds.md). **Establezca `AclEnabled explícitamente`** Si se omite`aclEnabled`, el valor predeterminado depende de`authType`: el valor predeterminado es y el `BASIC` valor predeterminado es. `true` `OAUTH2` `false` Como la configuración de la ACL es permanente después de crear la fuente de datos, configúrela `aclEnabled` explícitamente para que la fuente de datos tenga el comportamiento de control de acceso que desea. Para obtener más información, consulte [Document-level controles de acceso](kb-managed-ds-confluence-acl.md). **connectionConfiguration** | Campo | Obligatorio | Descripción | | --- | --- | --- | | secretArn | Sí | El ARN del AWS Secrets Manager secreto que contiene tus credenciales de Confluence. | | type | Sí | El tipo de implementación de Confluence. Configurado en SAAS. El servidor y el centro de datos de Confluence no son compatibles. | | authType | Sí | El tipo de autenticación. MANAGED\_OAUTH2Establézcalo en (configuración gestionada por el usuario, 3LO), BASIC o. OAUTH2 Consulte [Métodos de autenticación](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods). | | hostUrl | Sí | La URL base de tu instancia de Confluence Cloud (por ejemplo,). https://example.atlassian.net | **datos EntityConfiguration (opcional)** | Campo | Obligatorio | Description (Descripción) | | --- | --- | --- | | crawlPage | No | Si se deben rastrear las páginas. | | crawlBlog | No | Si se deben rastrear las publicaciones del blog. | | crawlPageAttachment | No | Si se deben rastrear los archivos adjuntos de la página. Se rastrea solo cuando también lo crawlPage es. true | | crawlBlogAttachment | No | Si se deben rastrear los archivos adjuntos de las publicaciones de blog. Se rastrea solo cuando también lo crawlBlog es. true | | crawlArchivedSpace | No | Si se deben rastrear los espacios archivados. | | crawlArchivedPage | No | Si se deben rastrear las páginas archivadas. | | crawlPersonalSpace | No | Si se deben rastrear los espacios personales. | **Configuración del filtro (opcional)** | Campo | Obligatorio | Description (Descripción) | | --- | --- | --- | | inclusionSpaceKeys | No | Teclas espaciadoras para incluir. | | inclusionSpaceUrls | No | Espacie las URL que desea incluir. | | inclusionMimeTypes | No | Tipos MIME que se van a incluir. | | exclusionMimeTypes | No | Tipos MIME que se van a excluir. | | maxFileSizeInMegaBytes | No | Tamaño máximo, en megabytes, de cualquier archivo individual que ingiera el conector. Proporciónelo como cadena numérica (por ejemplo,). "500" El valor predeterminado es "500". | **AclEnabled (opcional)** | Campo | Obligatorio | Description (Descripción) | | --- | --- | --- | | aclEnabled | No | Si el control de acceso a nivel de documento está activado. trueConfigúrelo para habilitarlo o false para deshabilitarlo. Si omite este campo, el valor predeterminado depende deauthType: el BASIC valor predeterminado estrue; el valor OAUTH2 predeterminado es. false La ACL activada BASIC requiere un secreto que incluya las credenciales de administrador de la organización de Atlassian. No puedes cambiar esta configuración después de crear la fuente de datos. Para obtener más información, consulte [Document-level controles de acceso](kb-managed-ds-confluence-acl.md). | ## Cambie el método de autenticación Puede cambiar el método de autenticación de una fuente de datos (por ejemplo, de OAuth 2.0 a Basic) actualizando la fuente de datos por la nueva `authType` y por una secreta que contenga las credenciales coincidentes, mediante la [ UpdateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) operación o la. Consola de administración de AWS La configuración de control de acceso a nivel de documento es fija al crear una fuente de datos, por lo que para agregar o eliminar las ACL, debe crear una nueva fuente de datos. ## Siguientes pasos Después de crear la fuente de datos, sincronícela para incorporar contenido a la base de conocimientos. Para obtener más información, consulte [Sincronización de un origen de datos](kb-managed-sync.md). Para filtrar los resultados de las consultas por permisos de usuario, consulte[Document-level controles de acceso](kb-managed-ds-confluence-acl.md).