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
Dopo aver impostato l'autenticazione e archiviato le credenziali in modo AWS Secrets Manager segreto, crea l'origine dati Confluence 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 dell'autenticazione. Vedere [User-managed configurazione (3LO)](kb-managed-confluence-3lo-setup.md) (il più semplice)[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). Per la configurazione gestita dagli utenti (3LO), accedi tramite la console e Amazon Bedrock crea il segreto per te (con un ARN generato dal sistema); fornisci l'URL dell'host di Confluence ma non un segreto. Per gli altri metodi, sono necessari l'ARN segreto e l'URL host di Confluence.
## Crea l'origine dati
------
#### [ Console ]
**Per connettere Confluence alla tua knowledge base gestita**
1. In Fonte ** dati**, fornisci un nome per la tua fonte di dati.
1. Seleziona ** Confluence ** dal menu a discesa dell'origine dati.
1. In ** Fonte**, inserisci il tuo URL di Confluence (ad esempio,). `https://example.atlassian.net`
1. In ** Autenticazione**, seleziona ** User-managed Configurazione (3LO)**, Autenticazione ** di base o Autenticazione ** ** OAuth 2.0. ** Per la configurazione gestita dall'utente (3LO), inserisci facoltativamente un prefisso di nome ** segreto**, quindi scegli ** Accedi per accedere a ** Confluence Cloud. Non fornisci un segreto. Amazon Bedrock crea un segreto con un ARN generato dal sistema per archiviare il token. Per informazioni dettagliate, vedi [User-managed configurazione (3LO)](kb-managed-confluence-3lo-setup.md).
1. Seleziona o crea un AWS Secrets Manager segreto per archiviare le tue credenziali.
1. (Facoltativo, solo autenticazione di base) Per abilitare il controllo dell'accesso a livello di documento, seleziona ** Controlla l'accesso ai documenti con 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 scansionare (pagine, blog, allegati di pagina, allegati al blog, spazi archiviati, pagine archiviate, 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 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 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 OAuth 2.0, passa `authType` a. `OAUTH2` Per la configurazione gestita dall'utente (3LO), imposta su. `authType` `MANAGED_OAUTH2` Non puoi creare un segreto 3LO tramite l'API: accedi prima tramite la console per creare il segreto, quindi imposta l'ARN `secretArn` di quel segreto (vedi). [User-managed configurazione (3LO)](kb-managed-confluence-3lo-setup.md) Per abilitare il controllo degli accessi a livello di documento, imposta su. `aclEnabled` `true` Per una descrizione di ciascun campo, vedere 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 da `CREATING` a `AVAILABLE` quando l'operazione viene 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 sovrapposti `connectorParameters` (ad esempio `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, è necessario impostarla 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 implementazione di Confluence. Imposta su SAAS. Confluence Server e Data Center non sono supportati. |
| authType | Sì | Il tipo di autenticazione. Impostato su MANAGED\_OAUTH2 (configurazione gestita dall'utente, 3LO), 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 della tua istanza 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. È stato sottoposto a scansione solo quando lo è anche. crawlPage true |
| crawlBlogAttachment | No | Se eseguire la scansione degli allegati dei post del blog. Scansionato solo quando lo è anche. crawlBlog true |
| crawlArchivedSpace | No | 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 inserito dal connettore. Fornire come stringa numerica (ad esempio,). "500" L’impostazione predefinita è "500". |
**ACL abilitato (opzionale)**
| Campo | Richiesto | Description |
| --- | --- | --- |
| aclEnabled | No | Se il controllo degli accessi a livello di documento è abilitato. Impostato su true per abilitare o per disabilitarefalse. Se si omette questo campo, l'impostazione predefinita dipende daauthType: il valore BASIC predefinito ètrue; OAUTH2 il valore predefinito è. false L'ACL attivato 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 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 L'impostazione di controllo dell'accesso a livello di documento è fissa quando si crea un'origine dati, quindi per aggiungere o rimuovere gli ACL è necessario creare una nuova origine dati.
## Fasi successive
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). Per filtrare i risultati delle query in base alle autorizzazioni utente, consulta. [Document-level controlli di accesso](kb-managed-ds-confluence-acl.md)