

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connetti una fonte di dati Confluence Data Center
<a name="kb-managed-ds-confluence-onprem-connect"></a>

Dopo aver configurato la connettività VPC e archiviato le credenziali in modo AWS Secrets Manager segreto, crea l'origine dati di Confluence Data Center nella tua knowledge base. Questa pagina descrive come creare l'origine dati con Console di gestione AWS o l'API, seguita da un riferimento per i parametri del connettore che puoi configurare.

**Nota**  
Completa prima la configurazione e l'autenticazione del VPC. Consulta [Configurare la connettività VPC per un'origine dati](kb-managed-vpc-configuration.md) e [Configurare l'autenticazione Basic o PAT per Confluence Data Center](kb-managed-confluence-onprem-auth-setup.md). Sono necessari l'ID di configurazione VPC e l'ARN segreto.

## Crea l'origine dati
<a name="kb-managed-ds-confluence-onprem-create"></a>

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

**Per connettere Confluence Data Center alla tua knowledge base gestita**

1. In Fonte ** dati**, fornisci un nome per la tua fonte di dati.

1. Seleziona ** Confluence Data Center ** dal menu a discesa dell'origine dati.

1. In Configurazione ** VPC**, seleziona una configurazione VPC che raggiunga la tua istanza di Confluence Data Center o scegli ** Aggiungi configurazione VPC per crearne una. ** Per informazioni dettagliate, vedi [Configurare la connettività VPC per un'origine dati](kb-managed-vpc-configuration.md).

1. (Facoltativo) In Percorso contestuale ** dell'applicazione**, inserisci il percorso del ** contenuto ** in base al quale viene fornita l'API REST di Confluence Data Center (ad esempio,). `/wiki` Lascialo vuoto se l'API REST viene servita nella radice web.

1. (Facoltativo, solo HTTPS) In base al certificato ** TLS**, fornisci l'URI Amazon S3 del certificato TLS per la tua istanza di Confluence Data Center.

1. In ** Autenticazione**, seleziona Autenticazione ** di base ** o Token di accesso ** personale**, quindi seleziona il AWS Secrets Manager segreto che contiene le credenziali corrispondenti.

1. (Facoltativo) Espandi l'ambito ** di ** sincronizzazione per scegliere i tipi di entità da sottoporre a scansione (pagine, allegati di pagina, blog, allegati di blog, spazi personali).

1. (Facoltativo) Espandi gli URL delle ** entità ** per utilizzare i URL-based filtri per sincronizzare spazi, pagine e blog Confluence specifici.

1. (Facoltativo) Espandi i tipi ** MIME ** per includere o escludere tipi MIME specifici.

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

Per creare un'origine dati Confluence Data Center, invia una [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) richiesta con un endpoint build-time di Agents for Amazon Bedrock. L' AWS Command Line Interface esempio seguente crea un'origine dati che utilizza l'autenticazione di base. Per utilizzare invece un token di accesso personale, passa `authType` a`PERSONAL_TOKEN`. Per una descrizione di ogni campo, vedi il riferimento ai parametri del connettore che segue.

```
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
```

Il `confluence-onprem-connector.json` file contiene quanto segue:

```
{
    "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/}}"]
            }
        }
    }
}
```

Per le knowledge base gestite, `CreateDataSource` è asincrono: lo stato dell'origine dati passa da `CREATING` a `AVAILABLE` quando l'operazione viene completata.

------

## Parametri dei connettori
<a name="kb-managed-config-confluence-onprem"></a>

La configurazione dell'origine dati utilizza i seguenti parametri del connettore. Per connetterti a Confluence Data Center, specifica `CONFLUENCEONPREM` come tipo di connettore. `connectorParameters` Per i campi sovrapposti `connectorParameters` (ad esempio `deletionProtectionConfiguration` e`mediaExtractionConfiguration`), consulta. [Connettere un’origine dati](kb-managed-connect-ds.md)


**connectionConfiguration**  

| Campo | Richiesto | Descrizione | 
| --- | --- | --- | 
| authType | Sì | Il tipo di autenticazione. Impostato su BASIC oPERSONAL\_TOKEN. Consulta [Metodi di autenticazione](kb-managed-ds-confluence-onprem.md#kb-managed-confluence-onprem-auth-methods). | 
| secretArn | Sì | L'ARN del AWS Secrets Manager segreto contenente le credenziali del tuo Confluence Data Center. | 
| vpcConfiguration | Sì | Il percorso di rete privato verso la tua istanza di Confluence Data Center. Contiene un vpcConfigurationId campo impostato sull'ID di una configurazione VPC nella tua knowledge base. Consulta [Configurare la connettività VPC per un'origine dati](kb-managed-vpc-configuration.md). | 
| contextPath | No | Il percorso del contesto dell'applicazione in base al quale viene fornita l'API REST di Confluence Data Center (ad esempio,). /wiki Omettilo se l'API REST viene servita nella radice web. | 
| certificateS3Path | No | La posizione del certificato TLS per la tua istanza di Confluence Data Center, utilizzato quando ti connetti tramite HTTPS. Contiene e. s3BucketName s3KeyName | 


**dati EntityConfiguration (facoltativi)**  

| Campo | Richiesto | Description | 
| --- | --- | --- | 
| crawlPage | No | Se eseguire la scansione delle pagine. | 
| crawlBlog | No | Se eseguire la scansione dei post del blog. | 
| crawlPageAttachment | No | Se eseguire la scansione degli allegati delle pagine. È stato sottoposto a scansione solo quando lo è anche. crawlPage true | 
| crawlBlogAttachment | No | Se eseguire la scansione degli allegati dei post del blog. È stato sottoposto a scansione solo quando lo è anche. crawlBlog true | 
| crawlPersonalSpace | No | Se esplorare gli spazi personali. | 

**Nota**  
A differenza di Confluence Cloud, Confluence Data Center non supporta la scansione degli spazi archiviati o delle pagine archiviate.


**Configurazione del filtro (opzionale)**  

| Campo | Richiesto | Description | 
| --- | --- | --- | 
| inclusionSpaceUrls | No | URL spaziali da includere. | 
| inclusionPageUrls | No | URL delle pagine da includere. | 
| inclusionMimeTypes | No | Tipi MIME da includere. | 
| exclusionMimeTypes | No | Tipi MIME da escludere. | 
| maxFileSizeInMegaBytes | No | Dimensione massima, in megabyte, di ogni singolo file inserito dal connettore. Fornire come stringa numerica (ad esempio,). "50" | 

## Modificare il metodo di autenticazione
<a name="kb-managed-ds-confluence-onprem-change-auth"></a>

È possibile modificare il metodo di autenticazione di un'origine dati (ad esempio, da Basic a token di accesso personale) aggiornando l'origine dati con il nuovo `authType` e un segreto che contiene le credenziali corrispondenti, utilizzando l'[UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html)operazione o il Console di gestione AWS.

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

Dopo aver creato l'origine dati, sincronizzala per inserire i contenuti nella tua knowledge base. Per informazioni dettagliate, vedi [Sincronizzare un’origine dati](kb-managed-sync.md).