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à.
# Connect una fonte di dati Confluence
Dopo aver configurato l'autenticazione e archiviato le credenziali in modo AWS Secrets Manager segreto, crea la fonte di dati Confluence nella tua knowledge base. Questa pagina descrive come creare l'origine dati con l' Console di gestione AWS o l'API, seguita da un riferimento per i parametri del connettore che è possibile configurare.
**Nota**
Completa prima la configurazione dell'autenticazione. Vedi [Configurare l'autenticazione di base per Confluence](kb-managed-confluence-basic-setup.md) o [Configurare l'autenticazione OAuth 2.0 per Confluence](kb-managed-confluence-oauth2-setup.md). Sono necessari l'ARN segreto e l'URL dell'host Confluence.
## Crea la fonte di dati
------
#### [ Console ]
**Per connettere Confluence alla tua knowledge base gestita**
1. In **Origine dati, fornisci un nome per la tua fonte** di dati.
1. Seleziona **Confluence** dal menu a discesa delle fonti di dati.
1. In **Source**, inserisci l'URL di Confluence (ad esempio,). `https://example.atlassian.net`
1. In **Autenticazione**, seleziona **Autenticazione di base o Autenticazione** **OAuth 2.0**.
1. Seleziona o crea un AWS Secrets Manager segreto per archiviare le tue credenziali.
1. (Facoltativo, solo autenticazione di base) Per abilitare il controllo degli accessi a livello di **documento, seleziona Controlla** l'accesso ai documenti con gli ACL. Il segreto selezionato deve includere`adminApiKey`, e. `organizationId` `directoryId` Questa opzione non può essere modificata dopo la creazione. Per informazioni dettagliate, vedi [Document-level controlli di accesso](kb-managed-ds-confluence-acl.md).
1. (Facoltativo) Espandi l'**ambito di sincronizzazione** per scegliere i tipi di entità da sottoporre a scansione (pagine, blog, allegati di pagine, allegati di blog, spazi archiviati, pagine archiviate, spazi personali).
1. (Facoltativo) Espandi **gli URL delle entità** per utilizzare URL-based filtri per sincronizzare spazi, pagine e blog di Confluence specifici.
1. (Facoltativo) Espandi il **pattern regex dei tipi MIME** per includere o escludere tipi MIME specifici.
------
#### [ API ]
Per creare un'origine dati Confluence, invia una [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html)richiesta a un endpoint in fase di costruzione Agents for Amazon Bedrock. L' AWS Command Line Interface esempio seguente crea un'origine dati che utilizza l'autenticazione di base. Per utilizzare invece OAuth 2.0, passare `authType` a. `OAUTH2` Per abilitare il controllo degli accessi a livello di documento, imposta su. `aclEnabled` `true` Per una descrizione di ogni campo, consulta il riferimento ai parametri del connettore che segue.
```
aws bedrock-agent create-data-source \
--name "{{Confluence-connector}}" \
--knowledge-base-id "{{your-knowledge-base-id}}" \
--data-source-configuration file://confluence-managed-connector.json
```
Il `confluence-managed-connector.json` file contiene quanto segue:
```
{
"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}}"]
}
}
}
}
```
Per le knowledge base gestite, `CreateDataSource` è asincrono: lo stato dell'origine dati passa dal momento in `AVAILABLE` cui l'operazione viene `CREATING` completata.
------
## Parametri dei connettori
La configurazione dell'origine dati utilizza i seguenti parametri del connettore. Per connetterti a Confluence, specifica `CONFLUENCE` come tipo di connettore. `connectorParameters` Per i campi racchiusi `connectorParameters` (come `deletionProtectionConfiguration` e`mediaExtractionConfiguration`), vedi. [Connettere un’origine dati](kb-managed-connect-ds.md)
**Imposta `aclEnabled` in modo esplicito**
Se si omette`aclEnabled`, l'impostazione predefinita dipende da`authType`: il valore predefinito è e il `BASIC` valore predefinito è. `true` `OAUTH2` `false` Poiché la configurazione ACL è permanente dopo la creazione dell'origine dati, impostala in modo `aclEnabled` esplicito in modo che l'origine dati abbia il comportamento di controllo dell'accesso desiderato. Per informazioni dettagliate, vedi [Document-level controlli di accesso](kb-managed-ds-confluence-acl.md).
**connectionConfiguration**
| Campo | Richiesto | Descrizione |
| --- | --- | --- |
| secretArn | Sì | L'ARN del AWS Secrets Manager segreto contenente le tue credenziali Confluence. |
| type | Sì | Il tipo di distribuzione di Confluence. Imposta su SAAS. Confluence Server e Data Center non sono supportati. |
| authType | Sì | Il tipo di autenticazione. Impostato su o. BASIC OAUTH2 Per informazioni, consulta [Metodi di autenticazione](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods). |
| hostUrl | Sì | L'URL di base dell'istanza di Confluence Cloud (ad esempio,https://example.atlassian.net). |
**dati EntityConfiguration (opzionale)**
| 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. Scansionato solo quando lo è anche. crawlPage true |
| crawlBlogAttachment | No | Indica se scansionare gli allegati dei post del blog. Scansionato solo quando lo è anche. crawlBlog true |
| crawlArchivedSpace | No | Indica se eseguire la scansione degli spazi archiviati. |
| crawlArchivedPage | No | Se eseguire la scansione delle pagine archiviate. |
| crawlPersonalSpace | No | Se eseguire la scansione degli spazi personali. |
**Configurazione del filtro (opzionale)**
| Campo | Richiesto | Description |
| --- | --- | --- |
| inclusionSpaceKeys | No | Tasti spaziatori da includere. |
| inclusionSpaceUrls | No | URL spaziali da includere. |
| inclusionMimeTypes | No | Tipi MIME da includere. |
| exclusionMimeTypes | No | Tipi MIME da escludere. |
| maxFileSizeInMegaBytes | No | Dimensione massima, in megabyte, di ogni singolo file importato dal connettore. Fornisci come stringa numerica (ad esempio,). "500" L’impostazione predefinita è "500". |
**AclEnabled (opzionale)**
| Campo | Richiesto | Description |
| --- | --- | --- |
| aclEnabled | No | Se il controllo degli accessi a livello di documento è abilitato. Imposta su true per abilitare o disabilitarefalse. Se si omette questo campo, l'impostazione predefinita dipende daauthType: il valore BASIC predefinito ètrue; OAUTH2 il valore predefinito è. false ACL on BASIC richiede un segreto che includa le credenziali di amministratore dell'organizzazione Atlassian. Non è possibile modificare questa impostazione dopo aver creato l'origine dati. Per informazioni dettagliate, vedi [Document-level controlli di accesso](kb-managed-ds-confluence-acl.md). |
## Modificare il metodo di autenticazione
È possibile modificare il metodo di autenticazione di un'origine dati (ad esempio, da OAuth 2.0 a Basic) aggiornando l'origine dati con una nuova `authType` fonte segreta 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 L'impostazione del controllo dell'accesso a livello di documento è fissa quando si crea un'origine dati, quindi per aggiungere o rimuovere ACL è necessario creare una nuova origine dati.
## Fasi successive
Dopo aver creato l'origine dati, sincronizzala per inserire il contenuto nella tua knowledge base. Per informazioni dettagliate, vedi [Sincronizzare un’origine dati](kb-managed-sync.md). Per filtrare i risultati delle query in base alle autorizzazioni degli utenti, consulta. [Document-level controlli di accesso](kb-managed-ds-confluence-acl.md)