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.
# Intégration à la base de connaissances Atlassian Confluence Cloud
Utilisez l'intégration de la base de connaissances Atlassian Confluence Cloud pour indexer le contenu Confluence afin que les agents Amazon Quick puissent effectuer des recherches et répondre à des questions à ce sujet. Amazon Quick prend en charge les contrôles d'accès facultatifs au niveau des documents (ACL) pour les bases de connaissances Confluence. Lorsque cette option est activée, les utilisateurs ne voient que les réponses des documents auxquels ils sont autorisés à accéder dans Confluence. Pour de plus amples informations, veuillez consulter [Document-level contrôles d'accès](confluence-kb-acl.md).
## Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
+ Une instance Atlassian Confluence Cloud.
+ Pour les exigences relatives à l'abonnement Quick, voir[Configuration des intégrations dans la console](integration-console-setup-process.md).
Si vous prévoyez d'activer les contrôles d'accès au niveau des documents, vous devez fournir des informations d'identification d'administrateur Atlassian lors de la configuration. Ces informations d'identification permettent à Amazon Quick d'accéder à toutes les informations des utilisateurs et des groupes, quels que soient les paramètres de visibilité des e-mails individuels. Sans informations d'identification d'administrateur, l'option ACL n'est pas disponible lors de la création de la base de connaissances. Pour fournir des informations d'identification d'administrateur, vous avez besoin des informations suivantes auprès de l'administrateur de votre organisation Atlassian :
+ **Clé d'API d'administration Atlassian** : chaîne alphanumérique générée sur le portail d'administration Atlassian.
+ **ID d'organisation (UUID)** : identifiant unique de votre organisation Atlassian. Vous pouvez le trouver dans l'URL de votre navigateur lorsque vous êtes connecté au portail d'administration :`admin.atlassian.com/o/{{orgId}}`.
+ **ID de répertoire (UUID)** : identifiant unique de votre annuaire d'utilisateurs. Récupérez cette valeur à l'aide de l'API Atlassian Admin Workspace.
Pour connaître les étapes détaillées permettant d'obtenir ces informations d'identification, consultez[Obtenir les informations d'identification d'administrateur Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials).
## Configuration de l'intégration de la base de connaissances
L'assistant de configuration comporte trois étapes : authentification, création de la base de connaissances et paramètres supplémentaires.
### Authentifiez votre compte
1. Dans la console Amazon Quick, sélectionnez **Knowledge**.
1. Sous **Knowledge**, choisissez **Atlassian Confluence Cloud et cliquez sur** le bouton Ajouter (plus « \+ »).
1. Dans la boîte de dialogue **Créer la base de connaissances Confluence**, sous **Méthode d'authentification**, choisissez un compte connecté existant dans le menu déroulant **Nom**, ou choisissez **Ajouter un compte** pour créer une nouvelle connexion.
1. Si vous ajoutez un nouveau compte, complétez les champs suivants :
+ **Nom : nom** descriptif de votre connexion.
+ **Description** (facultatif) — Remarques concernant la connexion.
+ URL de **confluence : URL** de votre site Atlassian (par exemple,). `https://{{your-site}}.atlassian.net`
1. (Facultatif) Sous **Gestion des ACL**, sélectionnez **Utiliser les informations d'identification d'administrateur Atlassian pour fournir les informations d'identification d'administrateur** Atlassian. Lorsque cette option est sélectionnée, entrez les informations suivantes :
+ **Clé d'API : clé** d'API d'administration Atlassian.
+ **OrganizationID (UUID) — L'identifiant** de votre organisation Atlassian.
+ **ID de répertoire (UUID) : votre identifiant** d'annuaire d'utilisateurs Atlassian.
**Important**
**Les informations d'identification d'administrateur Atlassian sont requises pour activer les contrôles d'accès (ACL) au niveau du document dans Paramètres supplémentaires.** Sans informations d'identification d'administrateur, l'option ACL est désactivée. Les informations d'identification d'administrateur ne peuvent pas être ajoutées une fois la base de connaissances créée. Pour connaître les étapes à suivre pour obtenir ces informations d'identification, consultez[Obtenir les informations d'identification d'administrateur Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials).
1. Choisissez **Suivant**.
1. Complétez la fenêtre contextuelle d'authentification Confluence Cloud qui s'affiche. Vérifiez les autorisations demandées et choisissez **Accepter** pour autoriser Amazon Quick à accéder à votre contenu Confluence.
### Création de la base de connaissances
1. Sous **Créer une base de connaissances**, entrez **le nom** de votre base de connaissances.
1. (Facultatif) Entrez une **description** avec des notes sur la manière dont la base de connaissances sera utilisée.
1. Sous **URL Confluence**, collez les URL des espaces, blogs ou pages Confluence que vous souhaitez inclure. Choisissez **Ajouter** après chaque URL.
**Note**
Les URL qui suivent la structure `https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}/overview` sont traitées comme des URL de page et non comme des URL d'espace. Pour indexer un espace entier, utilisez l'URL de l'espace sans `/overview` (par exemple,`https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`).
1. Choisissez **Suivant : paramètres supplémentaires** pour configurer les contrôles d'accès et les options d'indexation, ou choisissez **Créer pour créer** la base de connaissances avec les paramètres par défaut.
### Configurer des paramètres supplémentaires
1. Pour activer les contrôles d'accès au niveau des documents, sélectionnez **Contrôler l'accès aux documents avec des ACL**. Cette option n'est disponible que si vous avez fourni des informations d'identification d'administrateur Atlassian dans Méthode d'**authentification**. Lorsque cette option est activée, Amazon Quick synchronise les listes de contrôle d'accès de Confluence et vérifie les autorisations de chaque utilisateur au moment de la requête. Pour plus d'informations sur le fonctionnement des contrôles d'accès, consultez[Document-level contrôles d'accès](confluence-kb-acl.md).
Si vous n'activez pas les ACL, l'accès est contrôlé au niveau de la base de connaissances. Toute personne ayant accès à la base de connaissances peut obtenir des informations à partir de l'ensemble de son contenu. Lorsque les ACL sont activées, l'accès est contrôlé au niveau du document. Les utilisateurs qui ont accès à la base de connaissances ne voient que les réponses des documents auxquels ils sont autorisés à accéder dans Confluence.
**Important**
La gestion des ACL ne peut pas être modifiée une fois la base de connaissances créée. Si vous devez modifier ce paramètre, vous devez créer une nouvelle base de connaissances.
**Note**
Si vous n'avez pas fourni d'informations d'identification d'administrateur Atlassian dans la **méthode d'authentification**, cette option est désactivée. Pour activer les ACL, choisissez **Retour** ou annulez l'assistant et recommencez avec un compte connecté incluant des informations d'identification d'administrateur.
1. Sous **Multi-media Contenu, taille de fichier et modèles de fichiers**, configurez les options d'indexation suivantes selon vos besoins :
+ **Contenu visuel dans les documents** — Indexez le contenu visuel tel que les images et les graphiques intégrés aux documents.
+ **Fichiers audio — Indexez** les pièces jointes des fichiers audio.
+ **Fichiers vidéo — Indexez** les pièces jointes aux fichiers vidéo.
+ Taille **maximale d'un seul fichier : taille** de fichier maximale pour les pièces jointes individuelles (par défaut : 50 Mo).
1. Choisissez **Créer**.
## Types de contenu pris en charge
+ Pages et articles de blog de Confluence
+ Pièces jointes à des pages et à des articles de blog
Lorsque vous ajoutez l'URL d'un espace Confluence, Amazon Quick explore toutes les pages et tous les articles de blog contenus dans cet espace. Pour connaître les types de pièces jointes pris en charge et les limites de taille, consultez[Limites de taille et de contenu des fichiers](knowledge-base-integrations.md#file-size-and-content-limits).
## Gérer les bases de connaissances
### Modifier les bases de connaissances existantes
1. Dans la console Amazon Quick, sélectionnez **Knowledge bases**.
1. Sélectionnez votre base de connaissances Confluence Cloud dans la liste.
1. Cliquez sur l'icône à trois points sous **Actions**, puis sélectionnez **Modifier la base de connaissances**.
1. Mettez à jour vos paramètres de configuration selon vos besoins et choisissez **Enregistrer**.
## Dépannage
Pour modifier, partager ou supprimer votre intégration, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).
Pour la résolution des problèmes généraux liés à la base de connaissances, notamment les problèmes de synchronisation et les documents manquants, consultez[Bases de connaissances sur le dépannage](troubleshooting-knowledge-bases.md).
### Autorisation de l'application OAuth bloquée
**Symptômes :**
+ Message d'erreur : « L'administrateur de votre site doit autoriser cette application pour le site {{instance-name}} .atlassian.net avant que l'application puisse accéder à votre compte. »
+ Choisir **Accepter** dans la boîte de dialogue de consentement n'a aucun effet.
**Cause** :
L'administrateur de votre site Atlassian a bloqué les applications OAuth installées par l'utilisateur. Lorsque ce paramètre est activé, seul un administrateur de site ou d'organisation peut autoriser de nouvelles applications tierces.
**Étapes de résolution :**
Utilisez l'une des options suivantes pour résoudre ce problème.
+ **Option 1 (recommandée) : l'administrateur autorise directement l'application**
1. Un administrateur de site Atlassian accède à Amazon Quick et lance une nouvelle configuration de base de connaissances avec Confluence Cloud.
1. Comme l'administrateur dispose d'autorisations au niveau du site, un écran de consentement clair apparaît sans erreur.
1. L'administrateur choisit **Accepter** pour installer l'application.
Une fois que l'administrateur a autorisé l'application, tous les autres utilisateurs du site peuvent se connecter sans problème.
+ **Option 2 : autoriser temporairement les applications installées par l'utilisateur** : un administrateur accède à **Apps`admin.atlassian.com`, Atlassian Apps****, puis choisit le lien vers les applications** tierces et Marketplace. Sous **Paramètres**, recherchez **Applications installées par l'utilisateur** et activez l'option Autoriser les applications utilisateur. Une fois que l'utilisateur a autorisé Amazon Quick, rétablissez le paramètre pour bloquer les applications utilisateur.
**Important**
L'autorisation d'administrateur s'applique par site Atlassian, et non par organisation. Si votre entreprise possède plusieurs sites (par exemple, `team-a.atlassian.net` et`team-b.atlassian.net`), chaque site nécessite une autorisation distincte.
**Note**
Lorsque les applications installées par l'utilisateur sont débloquées (option 2), tout utilisateur du site peut autoriser n'importe quelle application OAuth. Re-enable le bloquer rapidement une fois que l'utilisateur s'est connecté.
### La fenêtre contextuelle d'authentification échoue
**Symptômes :**
+ La fenêtre contextuelle d'authentification ne s'affiche pas ou se ferme immédiatement.
+ Une fenêtre contextuelle apparaît mais ne parvient pas à terminer le flux OAuth.
**Étapes de résolution :**
1. Vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick.
1. Vérifiez que votre instance Confluence Cloud est accessible depuis votre réseau.
1. Essayez d'utiliser un autre navigateur ou de vider le cache de votre navigateur.
### Contenu manquant dans la base de connaissances
**Symptômes :**
+ La synchronisation de la base de connaissances est terminée mais le contenu attendu n'est pas indexé.
+ Les résultats de recherche n'incluent pas le contenu provenant d'espaces ou de pages spécifiques.
+ Un seul document est indexé pour un espace entier.
**Étapes de résolution :**
1. Vérifiez que l'utilisateur de Confluence Cloud qui s'est authentifié a accès aux espaces et aux pages que vous avez sélectionnés lors de la configuration.
1. Vérifiez que les types de contenu sélectionnés sont pris en charge (pages, articles de blog et pièces jointes).
1. Passez en revue la sélection de contenu dans la configuration de votre base de connaissances pour vous assurer que les espaces et les pages appropriés sont inclus.
1. Vérifiez la présence du suffixe dans vos URL Confluence. `/overview` Les URL qui se `/wiki/spaces/{{space-key}}/overview` terminent par sont traitées comme une URL de page unique, et non comme un espace complet. Si vous aviez l'intention d'indexer la totalité de l'espace, utilisez l'URL de l'espace sans `/overview` (par exemple,`https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`).
### ACL-related problèmes
**Aucun résultat de la base de ACL-enabled connaissances**
+ Vérifiez que l'utilisateur final s'est connecté à Confluence lorsqu'il y est invité lors de sa première requête. La connexion est requise pour la vérification des autorisations en temps réel.
+ Vérifiez que l'utilisateur final a accès au contenu Confluence pertinent dans son instance Confluence.
**Documents ignorés lors de la synchronisation**
+ Si les rapports de synchronisation indiquent des éléments dont le statut est IGNORÉ, vérifiez que l'utilisateur authentifié a accès aux espaces et aux pages Confluence inclus dans la base de connaissances.
+ Pour plus d'informations sur la vérification de l'accès aux documents, consultez[Vérifier l'accès aux documents (vérification ACL)](sync-reports-observability.md#sync-reports-acl-verification).