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à.
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. È possibile utilizzare… Amazon Kendra per indicizzare gli spazi, le pagine (incluse le pagine annidate), i blog, i commenti e gli allegati di Confluence in pagine e blog indicizzati.
La fine del supporto per Confluence connector V1.0/ ConfluenceConfiguration API è prevista per il 2023. Ti consigliamo di eseguire la migrazione o l'utilizzo del connettore Confluence V2.0/. TemplateConfiguration API
Per la risoluzione dei problemi relativi al Amazon Kendra Connettore di origine dati Confluence, vedi. Risoluzione dei problemi relativi alle origini dati
Funzionalità supportate
Amazon Kendra Il connettore di origine dati Confluence supporta le seguenti funzionalità:
-
Mappature dei campi
-
Controllo degli accessi degli utenti
-
Filtri di inclusione/esclusione
-
(Solo per Confluence Server) Cloud privato virtuale () VPC
Prerequisiti
Prima di poter usare Amazon Kendra per indicizzare la tua fonte di dati Confluence, apporta queste modifiche in Confluence e AWS conti.
In Confluence, assicurati di avere:
-
Concesso Amazon Kendra autorizzazioni per visualizzare tutti i contenuti all'interno dell'istanza Confluence tramite:
-
Creazione Amazon Kendra un membro del confluence-administrators gruppo.
-
Concessione delle autorizzazioni di amministratore del sito per tutti gli spazi, i blog e le pagine esistenti.
-
Hai copiato la tua istanza di Confluence. URL
-
Per gli utenti SSO (Single Sign-On): attiva la pagina Mostra al login per il nome utente e la password quando configuri i metodi di autenticazione Confluence in Confluence Data Center.
-
Per Confluence Server
-
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.
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (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 di token di accesso personali.
-
Per Confluence Cloud
-
Selezionato, ogni documento è 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. IDsI documenti sono globali rispetto a un indice e devono essere univoci per indice.
Nel tuo Account AWS, assicurati di avere:
-
Hai creato un Amazon Kendra indice e, se si utilizza ilAPI, ha annotato l'ID dell'indice.
-
Ha creato un IAM ruolo per la fonte di dati e, se si utilizza ilAPI, ha annotato il ARN IAM ruolo.
Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere a quello corretto AWS Secrets Manager ID segreto.
-
Hai archiviato le credenziali di autenticazione Confluence in un AWS Secrets Manager segreto e, se si utilizza ilAPI, ha annotato il ARN segreto.
Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).
Se non ne hai uno esistente IAM ruolo o segreto, puoi usare la console per crearne uno nuovo IAM ruolo e Secrets Manager segreto quando colleghi la tua fonte di dati Confluence a Amazon Kendra. Se si utilizza ilAPI, è necessario fornire il ARN IAM ruolo e Secrets Manager segreto e un ID di indice.
Istruzioni di connessione
Connettersi Amazon Kendra alla tua fonte di dati Confluence, devi fornire i dettagli delle tue credenziali Confluence in modo che Amazon Kendra può accedere ai tuoi dati. Se non hai ancora configurato Confluence per Amazon Kendra vedere. Prerequisiti
- Console
-
Connettersi Amazon Kendra a Confluence
-
Accedi a AWS Console di gestione e apri il Amazon Kendra console.
-
Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.
Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.
-
Nella pagina Guida introduttiva, scegli Aggiungi origine dati.
-
Nella pagina Aggiungi origine dati, scegli Confluence connector V1.0, quindi scegli Aggiungi origine dati.
-
Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:
-
In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.
-
(Facoltativo) Descrizione: immetti una descrizione facoltativa per la tua fonte di dati.
-
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.
-
In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le tue risorse o tenere traccia delle tue AWS costi.
-
Scegli Next (Successivo).
-
Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:
-
Scegli tra Confluence Cloud e Confluence Server.
-
Se scegli Confluence Cloud, inserisci le seguenti informazioni:
-
Confluence: la tua Confluence URL. URL
-
AWS Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo Secrets Manager segreto per memorizzare le credenziali di autenticazione Confluence. Se scegli di creare un nuovo segreto, un AWS Secrets Manager si apre una finestra segreta.
-
Inserisci le seguenti informazioni nel campo Crea un AWS
Secrets Manager finestra segreta:
-
Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra-Confluence-' viene aggiunto automaticamente al tuo nome segreto.
-
Per nome utente e password: inserisci il nome utente e la password di Confluence.
-
Scegli Salva autenticazione.
-
Se scegli Confluence Server, inserisci le seguenti informazioni:
-
Confluence URL: nome utente e password di Confluence.
-
(Facoltativo) Per il proxy Web, inserisci le seguenti informazioni:
-
Nome host: nome host per il tuo account Confluence.
-
Numero di porta: porta utilizzata dal protocollo di trasporto dell'host. URL
-
Per l'autenticazione, scegli l'autenticazione di base o il token di accesso personale (solo Confluence Server).
-
AWS Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo Secrets Manager segreto per memorizzare le credenziali di autenticazione Confluence. Se scegli di creare un nuovo segreto, un AWS Secrets Manager si apre una finestra segreta.
-
Inserisci le seguenti informazioni nel campo Crea un AWS
Secrets Manager finestra segreta:
-
Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra-Confluence-' viene aggiunto automaticamente al tuo nome segreto.
-
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) di Confluence. API Se utilizzi un token di accesso personale, inserisci i dettagli del token di accesso personale che hai configurato nell'account Confluence.
-
Salva e aggiungi il tuo segreto.
-
IAM ruolo: scegli un ruolo esistente IAM ruolo o creane uno nuovo IAM ruolo per accedere alle credenziali del repository e indicizzare il contenuto.
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 oppure FAQ scegli Crea un nuovo ruolo per evitare errori.
-
Scegli Next (Successivo).
-
Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:
-
Per Includi spazi personali e Includi spazi archiviati, scegli i tipi di spazio opzionali da includere in questa fonte di dati.
-
Per una configurazione aggiuntiva: specifica i modelli di espressioni regolari per includere o escludere determinati contenuti. È possibile aggiungere fino a 100 pattern.
-
Puoi anche scegliere di eseguire la scansione degli allegati all'interno degli spazi scelti.
-
Pianificazione di esecuzione in Sync, per Frequenza: scegli la frequenza Amazon Kendra si sincronizzerà con la tua fonte di dati.
-
Scegli Next (Successivo).
-
Nella pagina Imposta mappature dei campi, inserisci le seguenti informazioni:
-
Per Space, Page, Blog: seleziona tra Amazon Kendra campi di origine dati predefiniti generati o mappature di campo aggiuntive suggerite per aggiungere campi indice.
-
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.
-
Scegli Next (Successivo).
-
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 connetterti Amazon Kendra a Confluence
È necessario specificare quanto segue utilizzando: ConfluenceConfigurationAPI
-
Versione Confluence: specifica la versione dell'istanza di Confluence che stai utilizzando come o. CLOUD SERVER
-
Nome risorsa Amazon segreto (ARN): fornisci il nome della risorsa Amazon (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 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 nel JSON Secrets Manager segreto:
{
"username": "user name",
"password": "password"
}
Se utilizzi un token di accesso personale per connettere Confluence Server a Amazon Kendra, memorizzi le seguenti credenziali come struttura nel tuo JSON Secrets Manager segreto:
{
"patToken": "personal access token"
}
Se usi Confluence Cloud, usi il tuo nome utente Confluence e un API token, configurato in Confluence, come password. Memorizzi le seguenti credenziali come struttura nel tuo JSON Secrets Manager segreto:
{
"username": "user name",
"password": "API token"
}
-
IAM role: specifica RoleArn quando si chiama CreateDataSource per fornire un IAM ruolo con 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 .IAM ruoli per le fonti di dati Confluence.
Puoi anche aggiungere le seguenti funzionalità opzionali:
-
Proxy Web: indica se connettersi all'URListanza Confluence tramite un proxy Web. Puoi utilizzare questa opzione per Confluence Server.
-
(Solo per Confluence Server) Virtual Private Cloud (VPC): specifica VpcConfiguration come parte della configurazione dell'origine dati. Vedi Configurazione Amazon Kendra usare un VPC.
-
Filtri di inclusione ed esclusione: specificate i modelli di espressioni regolari per includere o escludere determinati spazi, post di blog, pagine, spazi e allegati. Se scegli di indicizzare gli allegati, vengono indicizzati solo gli allegati alle pagine e ai blog indicizzati.
La maggior parte delle fonti di 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 tuoi Amazon Kendra campi indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.
Il campo relativo al corpo del documento o l'equivalente del corpo del documento è obbligatorio per Amazon Kendra per cercare i tuoi documenti. È 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) per i tuoi documenti, se ne hai uno ACL per i tuoi documenti. Le ACL informazioni 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.
Ulteriori informazioni
Per ulteriori informazioni sull'integrazione Amazon Kendra con la tua fonte di dati Confluence, vedi:
