

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

Tras configurar la conectividad de la VPC y almacenar tus credenciales de forma AWS Secrets Manager secreta, crea la fuente de datos del centro 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 VPC y la configuración de la autenticación. Consulte [Configurar la conectividad de VPC para una fuente de datos](kb-managed-vpc-configuration.md) y [Configurar la autenticación básica o PAT para Confluence Data Center](kb-managed-confluence-onprem-auth-setup.md). Necesitas el ID de configuración de la VPC y el ARN secreto.

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

------
#### [ Console ]

**Para conectar Confluence Data Center a tu base de conocimientos gestionada**

1. En Fuente ** de datos**, proporciona un nombre para tu fuente de datos.

1. Selecciona ** Confluence Data Center en el menú desplegable ** de fuentes de datos.

1. En Configuración de ** VPC**, selecciona una configuración de VPC que llegue a tu instancia de Confluence Data Center o elige ** Agregar configuración de VPC para crear una. ** Para obtener más información, consulte [Configurar la conectividad de VPC para una fuente de datos](kb-managed-vpc-configuration.md).

1. (Opcional) En ** la ruta del contexto de la aplicación**, introduce la ruta de ** contenido en la que se ** ofrece la API REST del centro de datos de Confluence (por ejemplo,). `/wiki` Déjala vacía si la API REST se publica en la raíz web.

1. (Opcional, solo HTTPS) En el certificado ** TLS**, proporciona el URI de Amazon S3 del certificado TLS de tu instancia de centro de datos de Confluence.

1. En ** Autenticación**, selecciona Autenticación ** básica ** o Token de acceso ** personal y**, a continuación, selecciona el AWS Secrets Manager secreto que contiene las credenciales coincidentes.

1. (Opcional) Amplíe el alcance de la ** sincronización ** para elegir los tipos de entidades que desea rastrear (páginas, archivos adjuntos de páginas, blogs, archivos adjuntos de blogs, espacios personales).

1. (Opcional) Amplía las URL de las ** entidades ** para usar el URL-based filtrado para sincronizar espacios, páginas y blogs específicos de Confluence.

1. (Opcional) Amplía los tipos ** MIME ** para incluir o excluir tipos MIME específicos.

------
#### [ API ]

Para crear una fuente de datos para el centro 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 construcció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 un token de acceso personal en su lugar, `authType` cámbielo a`PERSONAL_TOKEN`. 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-DataCenter-connector}}" \
 --knowledge-base-id "{{your-knowledge-base-id}}" \
 --data-source-configuration file://confluence-onprem-connector.json
```

El `confluence-onprem-connector.json` archivo contiene lo siguiente:

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCEONPREM",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "authType": "BASIC",
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-onprem-creds}}",
                "contextPath": "{{/wiki}}",
                "vpcConfiguration": {
                    "vpcConfigurationId": "{{your-vpc-configuration-id}}"
                },
                "certificateS3Path": {
                    "s3BucketName": "{{my-cert-bucket}}",
                    "s3KeyName": "{{confluence-dc-cert.pem}}"
                }
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceUrls": ["{{https://confluence.example.com/spaces/ENG/}}"]
            }
        }
    }
}
```

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

La configuración de la fuente de datos usa los siguientes parámetros de conector. Para conectarte al centro de datos de Confluence, `CONFLUENCEONPREM` especifícalo como tipo de conector. `connectorParameters` Para ver los campos que se `connectorParameters` agrupan (como `deletionProtectionConfiguration` y`mediaExtractionConfiguration`), consulte[Conexión de un origen de datos](kb-managed-connect-ds.md).


**connectionConfiguration**  

| Campo | Obligatorio | Descripción | 
| --- | --- | --- | 
| authType | Sí | El tipo de autenticación. Establézcalo en BASIC oPERSONAL\_TOKEN. Consulte [Métodos de autenticación](kb-managed-ds-confluence-onprem.md#kb-managed-confluence-onprem-auth-methods). | 
| secretArn | Sí | El ARN del AWS Secrets Manager secreto que contiene tus credenciales de Confluence Data Center. | 
| vpcConfiguration | Sí | La ruta de red privada a tu instancia de centro de datos de Confluence. Contiene un vpcConfigurationId campo establecido con el ID de una configuración de VPC en tu base de conocimientos. Consulte [Configurar la conectividad de VPC para una fuente de datos](kb-managed-vpc-configuration.md). | 
| contextPath | No | La ruta del contexto de la aplicación en la que se ofrece la API REST del centro de datos de Confluence (por ejemplo,/wiki). Ovítela si la API REST se ofrece en la raíz web. | 
| certificateS3Path | No | La ubicación del certificado TLS de tu instancia de centro de datos de Confluence, que se usa cuando te conectas a través de HTTPS. Contiene s3BucketName y. s3KeyName | 


**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 | 
| crawlPersonalSpace | No | Ya sea para rastrear espacios personales. | 

**nota**  
A diferencia de Confluence Cloud, Confluence Data Center no permite rastrear espacios archivados ni páginas archivadas.


**Configuración del filtro (opcional)**  

| Campo | Obligatorio | Description (Descripción) | 
| --- | --- | --- | 
| inclusionSpaceUrls | No | Espacie las URL para incluirlas. | 
| inclusionPageUrls | No | URL de página que se van a 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,). "50" | 

## Cambie el método de autenticación
<a name="kb-managed-ds-confluence-onprem-change-auth"></a>

Puede cambiar el método de autenticación de una fuente de datos (por ejemplo, pasar de un token de acceso básico a uno personal) 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.

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

Tras crear la fuente de datos, sincronícela para incorporar contenido a la base de conocimientos. Para obtener información, consulte [Sincronización de un origen de datos](kb-managed-sync.md).