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
<a name="kb-managed-ds-confluence-connect"></a>

Tras configurar la autenticación y almacenar las credenciales en AWS Secrets Manager secreto, cree la fuente de datos de Confluence en su 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, seguido de una referencia sobre los parámetros del conector que puedes configurar.

**nota**  
Complete primero la configuración de autenticación. Consulte [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). Necesitas el ARN secreto y la URL del host de Confluence.

## Crea la fuente de datos
<a name="kb-managed-ds-confluence-create"></a>

------
#### [ 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 **Autenticación básica o Autenticación** **OAuth 2.0.**

1. Selecciona o crea un AWS Secrets Manager secreto para almacenar tus 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 seleccione 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 desea 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 el URL-based filtrado y 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 con un punto final de 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 utilizar OAuth 2.0 en su lugar, cambie `authType` a. `OAUTH2` 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 siguiente referencia de parámetros del conector.

```
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 gestionadas, `CreateDataSource` es asíncrono: el estado de la fuente de datos pasa de `CREATING` a `AVAILABLE` cuando se completa la operación.

------

## Parámetros de conector
<a name="kb-managed-config-confluence"></a>

La configuración de la fuente de datos utiliza los siguientes parámetros de conector. Para conectarse a Confluence, especifique `CONFLUENCE` el tipo de conector. `connectorParameters` Para ver los campos que lo `connectorParameters` rodean (como `deletionProtectionConfiguration` y`mediaExtractionConfiguration`), consulte[Conexión de un origen de datos](kb-managed-connect-ds.md).

**Establezca una `ACL habilitada de forma explícita`**  
Si lo 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 una vez creada la fuente de datos, configúrela de `aclEnabled` forma explícita para que la fuente de datos tenga el comportamiento de control de acceso deseado. 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 despliegue de Confluence. Configurado en SAAS. No se admiten el servidor y el centro de datos de Confluence. | 
| authType | Sí | El tipo de autenticación. Establézcalo en 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 del blog. crawlBlogSe arrastraba solo cuando también lo era. true | 
| crawlArchivedSpace | No | Si se debe rastrear o no 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 de espacio para incluir. | 
| inclusionSpaceUrls | No | Espacie las direcciones URL que desee incluir. | 
| inclusionMimeTypes | No | Tipos de MIME que se van a incluir. | 
| exclusionMimeTypes | No | Tipos de MIME que se van a excluir. | 
| maxFileSizeInMegaBytes | No | Tamaño máximo, en megabytes, de cualquier archivo individual que ingiera el conector. Introdúzcalo 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á habilitado. trueConfigúrelo para habilitar o false deshabilitar. Si omite este campo, el valor predeterminado depende deauthType: el BASIC valor predeterminado estrue; el valor OAUTH2 predeterminado es. false ACL on BASIC requiere un secreto que incluya las credenciales de administrador de la organización de Atlassian. No puede 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
<a name="kb-managed-ds-confluence-change-auth"></a>

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 con la nueva `authType` y un secreto 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 se fija al crear una fuente de datos, por lo que para añadir o eliminar las ACL hay que crear una nueva fuente de datos.

## Siguientes pasos
<a name="kb-managed-ds-confluence-connect-next"></a>

Tras crear la fuente de datos, sincronícela para incorporar el contenido a su 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).