Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connecteur Confluence V1.0
Confluence est un outil de gestion du travail collaboratif conçu pour partager, stocker et travailler sur la planification de projets, le développement de logiciels et la gestion de produits. Vous pouvez l'utiliser Amazon Kendra pour indexer vos espaces Confluence, vos pages (y compris les pages imbriquées), vos blogs, ainsi que vos commentaires et pièces jointes vers des pages et des blogs indexés.
**Note**
Le connecteur Confluence ConfluenceConfiguration V1.0/API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Confluence V2.0/API. TemplateConfiguration
Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Confluence, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-confluence)
+ [Conditions préalables](#prerequisites-v1-confluence)
+ [Instructions de connexion](#data-source-procedure-v1-confluence)
+ [En savoir plus](#confluence-v1-learn-more)
## Fonctionnalités prises en charge
Amazon Kendra Le connecteur de source de données Confluence prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ (Pour Confluence Server uniquement) Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de données Confluence, apportez ces modifications à votre Confluence et AWS à vos comptes.
**Dans Confluence, assurez-vous que vous disposez des éléments suivants :**
+ Amazon Kendra Autorisations accordées pour afficher tout le contenu de votre instance Confluence en :
+ Amazon Kendra Devenir membre d'un `confluence-administrators` groupe.
+ Accorder des autorisations d'administrateur de site pour tous les espaces, blogs et pages existants.
+ Vous avez copié l'URL de votre instance Confluence.
+ **Pour les utilisateurs du SSO (Single Sign-On) :** activation de la **page Afficher lors de la connexion** pour le nom d'utilisateur et le mot de passe lorsque vous configurez les **méthodes d'authentification** Confluence dans Confluence Data Center.
+ **Pour Confluence Server**
+ Vous avez noté vos informations d'authentification de base contenant le nom d'utilisateur et le mot de passe de votre compte administratif Confluence auxquels vous pouvez vous connecter Amazon Kendra.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
+ **Facultatif :** vous avez généré un jeton d'accès personnel dans votre compte Confluence auquel vous connecter Amazon Kendra. Pour plus d'informations, consultez la [documentation de Confluence sur la génération de jetons d'accès personnels](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html).
+ **Pour Confluence Cloud**
+ Vous avez noté vos informations d'authentification de base contenant le nom d'utilisateur et le mot de passe de votre compte administratif Confluence auxquels vous pouvez vous connecter Amazon Kendra.
+ Il est vérifié que chaque document est unique dans Confluence et dans les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
**Dans votre Compte AWS, assurez-vous d'avoir :**
+ [Création d'un Amazon Kendra index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) et, si vous utilisez l'API, notez l'ID de l'index.
+ Vous avez [créé un IAM rôle](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
**Note**
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
+ Stockez vos informations d'authentification Confluence dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de données Confluence à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de données Confluence, vous devez fournir les détails de vos informations d'identification Confluence afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Confluence pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-confluence).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à Confluence**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendra ouvrez-la](https://console.aws.amazon.com/kendra/).
1. Dans le volet de navigation de gauche, choisissez **Index**, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
**Note**
Vous pouvez choisir de configurer ou de modifier vos paramètres de **contrôle d'accès utilisateur** dans les paramètres de **l'index**.
1. Sur la page de **démarrage**, choisissez **Ajouter une source de données**.
1. Sur la page **Ajouter une source de données**, choisissez **Confluence connector V1.0**, puis sélectionnez **Ajouter une source de données**.
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. Dans **Nom et description**, pour Nom de la **source de données** : entrez le nom de votre source de données. Vous pouvez inclure des tirets, mais pas des espaces.
1. (Facultatif) **Description** : entrez une description facultative pour votre source de données.
1. Dans la **langue par défaut** : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
1. Dans **Balises**, pour **Ajouter une nouvelle balise** : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. Choisissez entre **Confluence Cloud** et **Confluence Server**.
1. Si vous choisissez **Confluence Cloud**, saisissez les informations suivantes :
1. URL **de confluence : votre URL** de confluence.
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos identifiants d'authentification Confluence. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Confluence-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le** **mot de passe** : entrez votre nom d'utilisateur et votre mot de passe Confluence.
1. Choisissez **Enregistrer l'authentification**.
1. Si vous choisissez **Confluence Server**, entrez les informations suivantes :
1. **URL Confluence** : votre nom d'utilisateur et votre mot de passe Confluence.
1. (Facultatif) Pour **le proxy Web**, entrez les informations suivantes :
1. **Nom d'hôte : nom** d'hôte de votre compte Confluence.
1. **Numéro de port** —Port utilisé par le protocole de transport d'URL de l'hôte.
1. Pour **l'authentification**, choisissez l'**authentification de base** ou le **jeton d'accès personnel** (Confluence Server uniquement).
1. **AWS Secrets Manager secret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos identifiants d'authentification Confluence. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -Confluence-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur et le** **mot de passe** : entrez les valeurs d'identification d'authentification que vous avez configurées dans Confluence. Si vous utilisez l'authentification de base, utilisez votre nom d'utilisateur Confluence (identifiant e-mail) et votre mot de passe (jeton API). Si vous utilisez un jeton d'accès personnel, saisissez les détails du **jeton d'accès personnel** que vous avez configuré dans le compte Confluence.
1. Enregistrez et ajoutez votre secret.
1. **IAM rôle** —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
**Note**
IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez **Créer un nouveau rôle** pour éviter les erreurs.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. Pour **Inclure les espaces personnels** et **Inclure les espaces archivés**, choisissez les types d'espaces facultatifs à inclure dans cette source de données.
1. Pour une **configuration supplémentaire** : spécifiez des modèles d'expressions régulières pour inclure ou exclure certains contenus. Vous pouvez ajouter jusqu’à 100 modèles.
1. Vous pouvez également choisir d'**explorer les pièces jointes dans les espaces choisis**.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : choisissez la fréquence de synchronisation avec votre source de données. Amazon Kendra
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. Pour **Space**, **Page**, **Blog** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés ou parmi les **mappages de champs suggérés supplémentaires** pour ajouter des champs d'index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
1. Choisissez **Suivant**.
1. Sur la page **Réviser et créer**, vérifiez que les informations saisies sont correctes, puis sélectionnez **Ajouter une source de données**. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page **Sources de données** une fois que la source de données aura été ajoutée avec succès.
------
#### [ API ]
**Pour vous connecter Amazon Kendra à Confluence**
Vous devez spécifier les éléments suivants à l'aide de l'[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html)API :
+ **Version Confluence** —Spécifiez la version de l'instance Confluence que vous utilisez en tant que ou. `CLOUD` `SERVER`
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant vos informations d'authentification Confluence.
Si vous utilisez Confluence Server, vous pouvez utiliser soit votre nom d'utilisateur et votre mot de passe Confluence, soit votre jeton d'accès personnel comme identifiants d'authentification.
Si vous utilisez votre nom d'utilisateur et votre mot de passe Confluence comme informations d'authentification, vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"username": "{{user name}}",
"password": "{{password}}"
}
```
Si vous utilisez un jeton d'accès personnel pour vous connecter à Confluence Server Amazon Kendra, vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"patToken": "{{personal access token}}"
}
```
Si vous utilisez Confluence Cloud, vous utilisez votre nom d'utilisateur Confluence et un jeton d'API, configuré dans Confluence, comme mot de passe. Vous stockez les informations d'identification suivantes sous forme de structure JSON dans votre Secrets Manager secret :
```
{
"username": "{{user name}}",
"password": "{{API token}}"
}
```
+ **IAM role** —Spécifiez à quel `RoleArn` moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le connecteur Confluence et. Amazon Kendra Pour plus d'informations, consultez la section [IAM Rôles des sources de données Confluence](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Proxy Web** : s'il faut se connecter à votre instance d'URL Confluence via un proxy Web. Vous pouvez utiliser cette option pour Confluence Server.
+ (Pour Confluence Server uniquement) **Virtual Private Cloud (VPC) —Spécifiez dans le** `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+ **Filtres d'inclusion et d'exclusion** : spécifiez des modèles d'expressions régulières pour inclure ou exclure certains espaces, articles de blog, pages, espaces et pièces jointes. Si vous choisissez d'indexer les pièces jointes, seules les pièces jointes aux pages et aux blogs indexés sont indexées.
**Note**
La plupart des sources de données utilisent des modèles d’expressions régulières, qui sont des modèles d’inclusion ou d’exclusion appelés filtres. Si vous spécifiez un filtre d’inclusion, seul le contenu correspondant au filtre d’inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données Confluence à vos Amazon Kendra champs d'index. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Note**
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index`_document_body`. Tous les autres champs sont facultatifs.
+ **Filtrage du contexte utilisateur et contrôle d'accès**Amazon Kendra : analyse la liste de contrôle d'accès (ACL) de vos documents, si vous disposez d'une ACL pour vos documents. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section [Filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Confluence, consultez :
+ [Configuration de votre Amazon Kendra connecteur Confluence Server](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)