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à.
# Confluenza
Confluence è uno strumento collaborativo di gestione del lavoro progettato per condividere, archiviare e lavorare sulla pianificazione di progetti, lo sviluppo di software e la gestione dei prodotti. Amazon Kendra supporta sia Confluence Center che Confluence Cloud Server/Data . Puoi utilizzarle Amazon Kendra per indicizzare le seguenti entità Confluence:
+ **Spazi**: aree designate di primo livello per l'organizzazione dei contenuti correlati. Ogni spazio funge da contenitore, in grado di contenere più pagine, blog e allegati.
+ **Pagine**: singoli documenti all'interno di uno spazio in cui gli utenti creano e gestiscono i contenuti. Le pagine possono contenere testo, immagini, tabelle ed elementi multimediali e possono avere pagine secondarie annidate. Ogni pagina è considerata un singolo documento.
+ **Blog**: contenuti simili alle pagine, in genere utilizzati per aggiornamenti o annunci. Ogni post dei blog è considerato un singolo documento.
+ **Commenti**: consente agli utenti di fornire feedback o partecipare a discussioni su contenuti specifici all'interno di pagine o post del blog.
+ **Allegati**: file caricati su pagine o post di blog in Confluence, come immagini, documenti o altri tipi di file.
Per impostazione predefinita, Amazon Kendra non indicizza gli archivi e gli spazi personali di Confluence. Puoi scegliere di indicizzarli quando crei l'origine dati. Se non vuoi Amazon Kendra indicizzare uno spazio, contrassegnalo come privato in Confluence.
Puoi connetterti Amazon Kendra alla tua fonte di dati Confluence utilizzando la [Amazon Kendra console](https://console.aws.amazon.com/kendra/), l'API o l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)
Amazon Kendra dispone di due versioni del connettore Confluence. Sono supportate le seguenti funzionalità.
****Connettore Confluence V2.0 /API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)****
+ Mappature dei campi
+ Controllo degli accessi degli utenti
+ Modelli di inclusione/esclusione
+ Sincronizzazione completa e incrementale dei contenuti
+ Cloud privato virtuale (VPC)
****Confluence connector [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)V1.0/API** (non più supportato)**
+ Mappature dei campi
+ Controllo degli accessi degli utenti
+ Filtri di inclusione/esclusione
+ (Solo Confluence Server) Cloud privato virtuale (VPC)
**Nota**
Confluence Connector V1.0/API è terminato nel 2023. ConfluenceConfiguration Ti consigliamo di migrare o utilizzare Confluence connector V2.0/API. TemplateConfiguration
Per la risoluzione dei problemi relativi al connettore di origine dati Amazon Kendra Confluence, consulta. [Risoluzione dei problemi relativi alle origini dati](troubleshooting-data-sources.md)
**Topics**
+ [
## ACLs in Confluence Connector
](#data-source-confluence-acls)
+ [
# Connettore Confluence V2.0
](data-source-v2-confluence.md)
+ [
# Connettore Confluence V1.0
](data-source-v1-confluence.md)
## ACLs in Confluence Connector
I connettori supportano la scansione degli elenchi di controllo degli accessi (ACLs) e l'identificazione delle informazioni, ove applicabile, in base alla fonte dei dati. Se indicizzi i documenti senza ACLs, tutti i documenti vengono considerati pubblici. L'indicizzazione dei documenti ACLs garantisce la sicurezza dei dati.
Il connettore Amazon Kendra Confluence scansiona gli spazi per raccogliere pagine e post di blog insieme ai relativi. ACLs Se non viene applicata alcuna restrizione a una pagina o a un blog, il connettore eredita le autorizzazioni dal suo spazio. Se a una pagina vengono applicate restrizioni specifiche a utenti o gruppi, solo tali utenti saranno in grado di accedere a quella pagina. Se la pagina è nidificata, la pagina nidificata eredita le autorizzazioni della pagina principale se non vengono applicate restrizioni. Un modello di autorizzazioni simile si applica ai blog; tuttavia, Confluence non supporta i blog nidificati.
Inoltre, Amazon Kendra Confluence Connector esegue la scansione delle informazioni principali dell'utente (alias utente locale, configurazioni di identità di gruppo locale e di gruppo federato) e delle relative autorizzazioni per ogni spazio configurato.
**Nota**
Il connettore Confluence Cloud non supporta la scansione di macro, lavagne o database.
Il connettore Amazon Kendra Confluence aggiorna le modifiche ACL ogni volta che esegue la scansione del contenuto della fonte di dati. Per garantire che gli utenti corretti abbiano accesso al contenuto corretto, risincronizza regolarmente la fonte di dati per acquisire eventuali aggiornamenti ACL.
# Connettore Confluence V2.0
Confluence è uno strumento collaborativo di gestione del lavoro progettato per condividere, archiviare e lavorare sulla pianificazione di progetti, lo sviluppo di software e la gestione dei prodotti. Puoi utilizzarlo Amazon Kendra per indicizzare gli spazi, le pagine (incluse le pagine annidate), i blog e i commenti e gli allegati di Confluence a pagine e blog indicizzati.
Per la risoluzione dei problemi relativi al connettore di origine dati Confluence, consulta. Amazon Kendra [Risoluzione dei problemi relativi alle origini dati](troubleshooting-data-sources.md)
**Topics**
+ [
## Funzionalità supportate
](#supported-features-v2-confluence)
+ [
## Prerequisiti
](#prerequisites-v2-confluence)
+ [
## Istruzioni di connessione
](#data-source-procedure-v2-confluence)
## Funzionalità supportate
Amazon Kendra Il connettore di origine dati Confluence supporta le seguenti funzionalità:
+ Mappature dei campi
+ Controllo dell'accesso degli utenti
+ Modelli di inclusione/esclusione
+ Sincronizzazione completa e incrementale dei contenuti
+ Cloud privato virtuale (VPC)
## Prerequisiti
Prima di poterla utilizzare Amazon Kendra per indicizzare la tua fonte di dati Confluence, apporta queste modifiche a Confluence e agli account. AWS
**In Confluence, assicurati di avere:**
+ Hai copiato l'URL dell'istanza Confluence. Ad esempio:*https://example.confluence.com*, o o*https://www.example.confluence.com/*. *https:// atlassian.net/* È necessario l'URL dell'istanza Confluence a cui connetterti. Amazon Kendra
Se utilizzi Confluence Cloud, l'URL dell'host deve terminare con. *atlassian.net/*
**Nota**
I seguenti formati di URL **non** sono supportati:
*https://example.confluence.com/xyz*
*https://www.example.confluence.com//wiki/spacekey/xxx*
*https://atlassian.net/xyz*
**Nota**
(On-premise/server) Amazon Kendra verifica se le informazioni sull'endpoint incluse sono le stesse informazioni sull'endpoint specificate nei dettagli di configurazione dell'origine dati. Gestione dei segreti AWS In questo modo si evita il [problema del confuso vicario](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html), ossia un problema di sicurezza in cui un utente non è autorizzato a eseguire un'azione ma lo utilizza Amazon Kendra come proxy per accedere al segreto configurato ed eseguire l'azione. Se successivamente modifichi le informazioni sull'endpoint, devi creare un nuovo segreto per sincronizzare queste informazioni.
+ Credenziali di autenticazione di base configurate contenenti un nome utente (ID e-mail utilizzato per accedere a Confluence) e una password (token API Confluence come password). Vedi [Gestire i token API per](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) il tuo account Atlassian.
**Nota**
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. **Non è** consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e nelle versioni 1.0 e 2.0 dei connettori (ove applicabile).
+ **Facoltativo:** credenziali OAuth 2.0 configurate contenenti una chiave dell'app Confluence, un segreto dell'app Confluence, un token di accesso Confluence e un token di aggiornamento Confluence per consentire la connessione all'istanza Confluence. Amazon Kendra Se il token di accesso scade, puoi utilizzare il token di aggiornamento per rigenerare il token di accesso e la coppia di token di aggiornamento. In alternativa, puoi ripetere la procedura di autorizzazione. Per ulteriori informazioni sui token di accesso, consulta [Gestire i token di OAuth accesso](https://support.atlassian.com/confluence-cloud/docs/manage-oauth-access-tokens/).
+ (Solo per Confluence Server/Data Center) **Opzionale:** hai configurato un token di accesso personale (PAT) in Confluence. [Vedi Utilizzo dei token di accesso personali.](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)
**Nel tuo Account AWS, assicurati di avere:**
+ Ha [creato un Amazon Kendra indice](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) e, se si utilizza l'API, ha annotato l'ID dell'indice.
+ [Hai creato un IAM ruolo](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.
**Nota**
Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID Gestione dei segreti AWS segreto corretto.
+ Ha archiviato le credenziali di autenticazione Confluence in un Gestione dei segreti AWS segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.
**Nota**
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. **Non è** consigliabile riutilizzare le credenziali e i segreti tra le fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).
Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un Secrets Manager segreto quando connetti l'origine dati Confluence a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.
## Istruzioni di connessione
Per connetterti Amazon Kendra alla tua fonte dati Confluence, devi fornire i dettagli necessari della fonte dati Confluence in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato Confluence for see. Amazon Kendra [Prerequisiti](#prerequisites-v2-confluence)
------
#### [ Console ]
**Per connettersi a Confluence Amazon Kendra **
1. [Accedi a Console di gestione AWS e apri la Amazon Kendra console.](https://console.aws.amazon.com/kendra/)
1. Dal riquadro di navigazione a sinistra, scegli **Indici**, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.
**Nota**
**Puoi scegliere di configurare o modificare le impostazioni del **controllo dell'accesso degli utenti** in Impostazioni dell'indice.**
1. Nella pagina **Guida introduttiva**, scegli **Aggiungi origine dati**.
1. Nella pagina **Aggiungi origine dati**, scegli **Confluence connector**, quindi scegli **Aggiungi** connettore. Se utilizzi la versione 2 (se applicabile), scegli il **connettore Confluence** con il tag «V2.0".
1. Nella pagina **Specificare i dettagli dell'origine dati**, inserisci le seguenti informazioni:
1. In **Nome e descrizione**, per **Nome dell'origine dati**, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
1. (Facoltativo) **Descrizione**: immetti una descrizione facoltativa per l'origine dati.
1. In **Lingua predefinita**: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.
1. In **Tag**, per **Aggiungi nuovo tag, includi tag** opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS
1. Scegli **Next (Successivo)**.
1. Nella pagina **Definisci accesso e sicurezza**, inserisci le seguenti informazioni:
1. In **Source**, scegli **Confluence Cloud o ** Server/Data Confluence**** Center.
1. URL **Confluence: inserisci l'URL dell'host di Confluence**. Ad esempio, *https://example.confluence.com*.
1. (Solo per Confluence Server/Data Center) **Posizione del certificato SSL: *opzionale*: inserisci il Amazon S3 percorso del file del certificato** SSL per Confluence Server.
1. (Solo per Confluence Server/Data Center) **Proxy Web: *opzionale*:** immettere il nome host del proxy Web (senza il `https://` protocollo `http://` o) e il numero di porta (porta utilizzata dal protocollo di trasporto URL dell'host). Il numero di porta deve essere un valore numerico compreso tra 0 e 65535.
1. **Autorizzazione**: attiva o disattiva le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta [Filtraggio del contesto utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Autenticazione****: scegli **l'autenticazione di base, l'autenticazione** **Oauth 2.0 o (solo per Confluence Server/Data Center) l'**autenticazione con token di accesso personale.**
1. **AWS Secrets Manager segreto**: scegli un segreto esistente o creane uno nuovo per archiviare le credenziali di autenticazione Secrets Manager Confluence. Se scegli di creare un nuovo segreto, si apre una finestra segreta. AWS Secrets Manager Nella finestra, immetti le seguenti informazioni:
1. **Nome segreto**: un nome per il segreto. Il prefisso 'AmazonKendra-Confluence-' viene aggiunto automaticamente al tuo nome segreto.
1. Se utilizzi **l'autenticazione di base**, inserisci il nome segreto, il nome utente e la password (token API Confluence come password) che hai configurato in Confluence.
Se utilizzi l'**autenticazione OAuth2 2.0**, inserisci il nome segreto, la chiave dell'app, il segreto dell'app, il token di accesso e il token di aggiornamento che hai configurato in Confluence.
(Solo Confluence Server/Data Center) Se utilizzi l'**autenticazione con token di accesso personale: inserisci il nome segreto e il token** Confluence che hai configurato in Confluence.
1. Salva e aggiungi il tuo segreto.
1. **Virtual Private Cloud (VPC)**: puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere **sottoreti e gruppi** di sicurezza **VPC**.
1. **Identity crawler**: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. [Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra contestuale dell'utente dei risultati di ricerca.](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.
1. **IAM ruolo**: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.
**Nota**
IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli **Crea un nuovo ruolo per evitare errori**.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configura le impostazioni di sincronizzazione**, inserisci le seguenti informazioni:
1. Nell'**ambito di sincronizzazione**, per **Sincronizza contenuti**: scegli di sincronizzare tra i seguenti tipi di contenuto: pagine, commenti alle pagine, allegati di pagina, blog, commenti del blog, allegati di blog, spazi personali e spazi archiviati.
**Nota**
**I commenti e gli allegati delle pagine possono essere selezionati solo se scegli di sincronizzare Pages.** **I commenti e gli allegati del blog possono essere selezionati solo se scegli di sincronizzare i blog.**
**Importante**
Se non specifichi un pattern regex con chiave spaziale in **Configurazione aggiuntiva**, per impostazione predefinita, tutte le pagine e i blog verranno sottoposti a scansione.
1. In **Configurazione aggiuntiva**, per Dimensione **massima del file: specifica il limite di dimensione** del file da sottoporre a scansione. MBs Amazon Kendra Amazon Kendra eseguirà la scansione solo dei file entro il limite di dimensione definito. La dimensione predefinita dei file è 50 MB. La dimensione massima del file deve essere superiore a 0 MB e inferiore o uguale a 50 MB.
Per i **modelli regex di Spaces**: specifica se includere o escludere spazi specifici nell'indice utilizzando:
+ Tasto spaziatore (ad esempio,) *my-space-123*
**Nota**
Se non specifichi un pattern regex con chiave spaziale, tutte le pagine e i blog verranno sottoposti a scansione per impostazione predefinita.
+ URL (ad esempio,) *.\$1/MySite/MyDocuments/*
+ Tipo di file (ad esempio,*.\$1\$1.pdf, .\$1\$1.txt*)
Per i **modelli di espressione regolare dei titoli delle entità**: specifica i modelli di espressioni regolari per includere o escludere determinati blog, pagine, commenti e allegati in base ai titoli.
**Nota**
Se desideri includere o escludere la scansione di una pagina o sottopagina specifica, puoi utilizzare i modelli di espressione regolare del titolo della pagina.
1. **Modalità di sincronizzazione**: scegli come aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione.
+ Sincronizzazione completa: indicizza di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.
+ Sincronizzazione nuova, modificata ed eliminata: indicizza solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
1. Nella **pianificazione di esecuzione della sincronizzazione**, per **Frequenza**: scegli la frequenza con cui sincronizzare il contenuto della fonte di dati e aggiornare l'indice.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Imposta mappature dei campi**, inserisci le seguenti informazioni:
1. Seleziona uno dei campi di origine dati predefiniti Amazon Kendra generati che desideri mappare al tuo indice. Per aggiungere campi di origine dati personalizzati, crea un nome di campo indice a cui mappare e il tipo di dati del campo.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Rivedi e crea**, verifica che le informazioni che hai inserito siano corrette, quindi seleziona **Aggiungi origine dati**. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina **Origini dati** dopo che l'origine dati sarà stata aggiunta correttamente.
------
#### [ API ]
**Per connettersi Amazon Kendra a Confluence**
È necessario specificare un codice JSON [dello schema dell'origine dati](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema) utilizzando l'API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) È necessario fornire le seguenti informazioni:
+ **Origine dati**: specifica il tipo di origine dati come `CONFLUENCEV2` quando usi lo schema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Specificate anche l'origine dati come `TEMPLATE` quando chiamate l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL host**: specifica l'istanza dell'URL host di Confluence. Ad esempio, *https://example.confluence.com*.
+ **Modalità di sincronizzazione**: specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:
+ `FORCED_FULL_CRAWL`per indicizzare nuovamente tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.
+ `FULL_CRAWL`per indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.
+ **Tipo di autenticazione**: specifica il tipo di autenticazione, se `Basic``OAuth2`, (solo Confluence Server). `Personal-token`
+ (Facoltativo, solo per Confluence Server) **Posizione del certificato SSL: specifica l'e che hai utilizzato per archiviare il certificato SSL**. `S3bucketName` `s3certificateName`
+ **Secret Amazon Resource Name (ARN): fornisci** l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione configurate in Confluence. Se utilizzi l'autenticazione di base, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
```
{
"username": "email ID or user name",
"password": "Confluence API token"
}
```
Se utilizzi l'autenticazione OAuth 2.0, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
```
{
"confluenceAppKey": "app key",
"confluenceAppSecret": "app secret",
"confluenceAccessToken": "access token",
"confluenceRefreshToken": "refresh token"
}
```
(Solo per Confluence Server) Se utilizzi l'autenticazione di base, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
```
{
"hostUrl": "Confluence Server host URL",
"username": "Confluence Server user name",
"password": "Confluence Server password"
}
```
(Solo per Confluence Server) Se utilizzi l'autenticazione con token di accesso personale, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:
```
{
"hostUrl": "Confluence Server host URL",
"patToken": "personal access token"
}
```
+ **IAM ruolo**: specifica `RoleArn` quando chiami `CreateDataSource` per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e chiamare il pubblico APIs richiesto per il connettore Confluence e. Amazon Kendra Per ulteriori informazioni, consulta i [IAM ruoli per](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) le fonti di dati Confluence.
Puoi anche aggiungere le seguenti funzionalità opzionali:
+ **Virtual Private Cloud (VPC)**: `VpcConfiguration` specifica quando si chiama. `CreateDataSource` Per ulteriori informazioni, consulta [Configurazione Amazon Kendra per l'utilizzo di un Amazon VPC](vpc-configuration.md).
+ **Dimensione del file: specifica la dimensione** massima del file da sottoporre a scansione.
+ **Tipi di documento/contenuto**: specificate se eseguire la scansione di pagine, commenti di pagina, allegati di pagina, blog, commenti, allegati del blog, spazi e spazi archiviati.
+ **Filtri di inclusione ed esclusione**: specifica se includere o escludere determinati spazi, pagine, blog e relativi commenti e allegati.
**Nota**
La maggior parte delle origini dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.
+ **Proxy Web**: specifica le informazioni sul proxy Web se desideri connetterti all'istanza URL di Confluence tramite un proxy Web. Puoi utilizzare questa opzione per Confluence Server.
+ **Elenco di controllo degli accessi (ACL)**: specifica se eseguire la scansione delle informazioni ACL dei documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta [Filtraggio del contesto utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
+ **Identity crawler**: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. [Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra contestuale dell'utente dei risultati di ricerca.](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.
+ **Mappature dei campi**: scegli di mappare i campi delle sorgenti dati di Confluence ai campi indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione [Mappatura dei campi di origine dei dati](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Nota**
Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per eseguire la ricerca nei documenti. Amazon Kendra È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice`_document_body`. Tutti gli altri campi sono facoltativi.
Per un elenco di altre importanti chiavi JSON da configurare, consulta lo schema del modello di [Confluence.](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-confluence-schema)
------
### Note
+ Il Personal Access Token (PAT) non è disponibile per Confluence Cloud.
# Connettore Confluence V1.0
Confluence è uno strumento collaborativo di gestione del lavoro progettato per condividere, archiviare e lavorare sulla pianificazione di progetti, lo sviluppo di software e la gestione dei prodotti. Puoi utilizzarlo Amazon Kendra per indicizzare gli spazi, le pagine (incluse le pagine annidate), i blog e i commenti e gli allegati di Confluence a pagine e blog indicizzati.
**Nota**
Il connettore Confluence V1.0/API è terminato nel 2023. ConfluenceConfiguration Ti consigliamo di migrare o utilizzare Confluence connector V2.0/API. TemplateConfiguration
Per la risoluzione dei problemi relativi al connettore di origine dati Amazon Kendra Confluence, consulta. [Risoluzione dei problemi relativi alle origini dati](troubleshooting-data-sources.md)
**Topics**
+ [
## Funzionalità supportate
](#supported-features-v1-confluence)
+ [
## Prerequisiti
](#prerequisites-v1-confluence)
+ [
## Istruzioni di connessione
](#data-source-procedure-v1-confluence)
+ [
## Ulteriori informazioni
](#confluence-v1-learn-more)
## Funzionalità supportate
Amazon Kendra Il connettore di origine dati Confluence supporta le seguenti funzionalità:
+ Mappature dei campi
+ Controllo dell'accesso degli utenti
+ Filtri di inclusione/esclusione
+ (Solo per Confluence Server) Cloud privato virtuale (VPC)
## Prerequisiti
Prima di poterla utilizzare Amazon Kendra per indicizzare la fonte di dati Confluence, apporta queste modifiche a Confluence e agli account. AWS
**In Confluence, assicurati di avere:**
+ Amazon Kendra Autorizzazioni concesse per visualizzare tutti i contenuti all'interno dell'istanza Confluence tramite:
+ Creazione di Amazon Kendra un membro del gruppo. `confluence-administrators`
+ Concessione delle autorizzazioni di amministratore del sito per tutti gli spazi, i blog e le pagine esistenti.
+ Hai copiato l'URL dell'istanza di Confluence.
+ **Per gli utenti SSO (Single Sign-On):** **attiva la **pagina di accesso Show on** per il nome utente e la password quando configuri i metodi di autenticazione Confluence in Confluence Data Center.**
+ **Per Confluence Server**
+ Hai preso nota delle tue credenziali di autenticazione di base contenenti il nome utente e la password dell'account amministrativo di Confluence a cui connetterti. Amazon Kendra
**Nota**
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. **Non è** consigliabile riutilizzare le credenziali e i segreti tra le fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).
+ **Facoltativo:** hai generato un token di accesso personale nel tuo account Confluence a cui connetterti. Amazon Kendra Per ulteriori informazioni, consulta la [documentazione di Confluence sulla generazione](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) di token di accesso personali.
+ **Per Confluence Cloud**
+ Hai annotato le tue credenziali di autenticazione di base contenenti il nome utente e la password dell'account amministrativo di Confluence a cui connetterti. Amazon Kendra
+ È stato verificato che ogni documento sia unico in Confluence e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni fonte di dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. IDs I documenti sono globali rispetto a un indice e devono essere univoci per indice.
**Nel tuo Account AWS, assicurati di avere:**
+ Ha [creato un Amazon Kendra indice](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) e, se si utilizza l'API, ha annotato l'ID dell'indice.
+ [Hai creato un IAM ruolo](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.
**Nota**
Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID Gestione dei segreti AWS segreto corretto.
+ Ha archiviato le credenziali di autenticazione Confluence in un Gestione dei segreti AWS segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.
**Nota**
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. **Non è** consigliabile riutilizzare le credenziali e i segreti tra le fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).
Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un Secrets Manager segreto quando connetti l'origine dati Confluence a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.
## Istruzioni di connessione
Per connetterti Amazon Kendra alla tua fonte di dati Confluence, devi fornire i dettagli delle tue credenziali Confluence in modo da poter Amazon Kendra accedere ai tuoi dati. Se non hai ancora configurato Confluence for see. Amazon Kendra [Prerequisiti](#prerequisites-v1-confluence)
------
#### [ Console ]
**Per connettersi a Confluence Amazon Kendra **
1. [Accedi alla console di AWS gestione e apri la Amazon Kendra console.](https://console.aws.amazon.com/kendra/)
1. Dal riquadro di navigazione a sinistra, scegli **Indici**, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.
**Nota**
**Puoi scegliere di configurare o modificare le impostazioni del **controllo dell'accesso degli utenti** in Impostazioni dell'indice.**
1. Nella pagina **Guida introduttiva**, scegli **Aggiungi origine dati**.
1. Nella pagina **Aggiungi origine dati**, scegli **Confluence connector V1.0**, quindi scegli **Aggiungi** origine dati.
1. Nella pagina **Specificare i dettagli dell'origine dati**, inserisci le seguenti informazioni:
1. In **Nome e descrizione**, per **Nome dell'origine dati**, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
1. (Facoltativo) **Descrizione**: immetti una descrizione facoltativa per l'origine dati.
1. In **Lingua predefinita**: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.
1. In **Tag**, per **Aggiungi nuovo tag, includi tag** opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS
1. Scegli **Next (Successivo)**.
1. Nella pagina **Definisci accesso e sicurezza**, inserisci le seguenti informazioni:
1. Scegli tra **Confluence Cloud** e **Confluence** Server.
1. Se scegli **Confluence Cloud**, inserisci le seguenti informazioni:
1. **Confluence URL: il tuo URL di Confluence**.
1. **Gestione dei segreti AWS segreto**: scegli un segreto esistente o creane uno nuovo per archiviare le credenziali di autenticazione Secrets Manager Confluence. Se scegli di creare un nuovo segreto, si apre una finestra segreta. Gestione dei segreti AWS
1. Inserisci le seguenti informazioni nella **finestra Crea un AWS Secrets Manager segreto**:
1. **Nome segreto**: un nome per il segreto. Il prefisso 'AmazonKendra-Confluence-' viene aggiunto automaticamente al tuo nome segreto.
1. Per **nome utente e password: inserisci il nome utente** **e la password** di Confluence.
1. **Scegli Salva autenticazione.**
1. Se scegli **Confluence Server**, inserisci le seguenti informazioni:
1. **URL Confluence**: nome utente e password di Confluence.
1. (Facoltativo) Per il **proxy Web**, inserisci le seguenti informazioni:
1. **Nome host: nome** host per il tuo account Confluence.
1. **Numero di porta**: porta utilizzata dal protocollo di trasporto degli URL dell'host.
1. Per **l'autenticazione**, scegli l'**autenticazione di base** o il token di accesso **personale** (solo Confluence Server).
1. **Gestione dei segreti AWS segreto**: scegli un segreto esistente o crea un nuovo Secrets Manager segreto per archiviare le credenziali di autenticazione Confluence. Se scegli di creare un nuovo segreto, si apre una finestra segreta. Gestione dei segreti AWS
1. Inserisci le seguenti informazioni nella **finestra Crea un AWS Secrets Manager segreto**:
1. **Nome segreto**: un nome per il segreto. Il prefisso 'AmazonKendra-Confluence-' viene aggiunto automaticamente al tuo nome segreto.
1. Per **nome utente** e **password**: inserisci i valori delle credenziali di autenticazione che hai configurato in Confluence. Se utilizzi l'autenticazione di base, usa il nome utente (ID e-mail) e la password (token API) di Confluence. Se utilizzi un token di accesso personale, inserisci i dettagli del **token di accesso personale** che hai configurato nell'account Confluence.
1. Salva e aggiungi il tuo segreto.
1. **IAM ruolo**: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.
**Nota**
IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli **Crea un nuovo ruolo per evitare errori**.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configura le impostazioni di sincronizzazione**, inserisci le seguenti informazioni:
1. Per **Includi spazi personali** e **Includi spazi archiviati**, scegli i tipi di spazio opzionali da includere in questa fonte di dati.
1. Per una **configurazione aggiuntiva**: specifica i modelli di espressioni regolari per includere o escludere determinati contenuti. È possibile aggiungere fino a 100 modelli.
1. Puoi anche scegliere di eseguire la **scansione degli allegati all'interno** degli spazi scelti.
1. In **Sincronizza la pianificazione dell'esecuzione**, per **Frequenza**: scegli la frequenza con cui eseguire la sincronizzazione con la tua fonte di dati. Amazon Kendra
1. Scegli **Next (Successivo)**.
1. Nella pagina **Imposta mappature dei campi**, inserisci le seguenti informazioni:
1. Per **Space**, **Page**, **Blog**: seleziona tra i campi delle origini dati predefiniti Amazon Kendra generati o le **mappature di campo aggiuntive suggerite** per aggiungere campi indice.
1. **Aggiungi campo**: consente di aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Rivedi e crea**, verifica che le informazioni inserite siano corrette, quindi seleziona **Aggiungi origine dati**. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina **Origini dati** dopo che l'origine dati sarà stata aggiunta correttamente.
------
#### [ API ]
**Per connettersi Amazon Kendra a Confluence**
È necessario specificare quanto segue utilizzando [ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)l'API:
+ Versione **Confluence: specifica la versione** dell'istanza di Confluence che stai utilizzando come o. `CLOUD` `SERVER`
+ **Secret Amazon Resource Name (ARN)**: fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le tue credenziali di autenticazione Confluence.
Se utilizzi Confluence Server, puoi utilizzare il nome utente e la password di Confluence o il tuo token di accesso personale come credenziali di autenticazione.
Se utilizzi il nome utente e la password di Confluence come credenziali di autenticazione, memorizzi le seguenti credenziali come struttura JSON nel tuo segreto: Secrets Manager
```
{
"username": "user name",
"password": "password"
}
```
Se utilizzi un token di accesso personale per connettere Confluence Server Amazon Kendra, memorizzi le seguenti credenziali come struttura JSON nel tuo segreto: Secrets Manager
```
{
"patToken": "personal access token"
}
```
Se utilizzi Confluence Cloud, utilizzi il tuo nome utente Confluence e un token API, configurato in Confluence, come password. Memorizzi le seguenti credenziali come struttura JSON nel tuo segreto: Secrets Manager
```
{
"username": "user name",
"password": "API token"
}
```
+ **IAM role**: specifica `RoleArn` quando chiami `CreateDataSource` per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e per chiamare il pubblico richiesto APIs per il connettore Confluence e. Amazon Kendra Per ulteriori informazioni, consulta i [IAM ruoli per](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) le fonti di dati Confluence.
Puoi anche aggiungere le seguenti funzionalità opzionali:
+ **Proxy Web**: indica se connettersi all'istanza URL di Confluence tramite un proxy Web. Puoi utilizzare questa opzione per Confluence Server.
+ (Solo per Confluence Server) **Virtual Private Cloud (**VPC)`VpcConfiguration`: specifica come parte della configurazione dell'origine dati. Vedi [Configurazione Amazon Kendra per l'uso di un VPC.](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html)
+ **Filtri di inclusione ed esclusione**: specificate i modelli di espressioni regolari per includere o escludere determinati spazi, post del blog, pagine, spazi e allegati. Se scegli di indicizzare gli allegati, vengono indicizzati solo gli allegati alle pagine e ai blog indicizzati.
**Nota**
La maggior parte delle origini dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.
+ **Mappature dei campi**: scegli di mappare i campi delle sorgenti dati di Confluence ai campi indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione [Mappatura dei campi di origine dei dati](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Nota**
Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per eseguire la ricerca nei documenti. Amazon Kendra È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice`_document_body`. Tutti gli altri campi sono facoltativi.
+ **Filtraggio del contesto utente e controllo degli accessi**:Amazon Kendra esegue la scansione dell'elenco di controllo degli accessi (ACL) dei documenti, se disponi di un ACL per i documenti. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta [Filtraggio del contesto utente](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## Ulteriori informazioni
Per saperne di più sull'integrazione Amazon Kendra con la tua fonte di dati Confluence, consulta:
+ [Configurazione del connettore Confluence Server Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)