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 des actions d'Atlassian Confluence Cloud Utilisez le connecteur d'action Atlassian Confluence Cloud pour créer, mettre à jour et gérer les pages et les espaces Confluence directement dans Amazon Quick via le langage naturel. Pour configurer cette intégration, vous devez d'abord créer une application OAuth 2.0 (3LO) dans l'Atlassian Developer Console et configurer ses autorisations. Ensuite, vous créez l'intégration dans Amazon Quick et vous la connectez à votre application Atlassian. Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultez[Méthodes d’authentification](quick-action-auth.md). ## Avant de commencer Assurez-vous de disposer des éléments suivants avant de configurer l'intégration. + Cloud Atlassian Confluence. + Accès à l'[Atlassian Developer Console](https://developer.atlassian.com/console/myapps/) pour créer ou gérer une OAuth application. + Pour les conditions d'abonnement, voir[Configuration des intégrations dans la console](integration-console-setup-process.md). ## Configuration de l'Atlassian Developer Console Si vous prévoyez d'utiliser l'authentification utilisateur (3LO), créez une application OAuth 2.0 dans l'Atlassian Developer Console avant de configurer Amazon Quick. Effectuez toutes les étapes suivantes avant de passer à la console Amazon Quick. Si vous prévoyez d'utiliser uniquement l'authentification de service (clé API), vous pouvez ignorer cette section et passer à[Préparer l'authentification](#confluence-action-auth-setup). Pour plus d'informations sur les applications OAuth 2.0 (3LO), consultez la section Applications [OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/) dans la documentation Atlassian destinée aux développeurs. ### Création d'une OAuth application 2.0 (3LO) Amazon Quick utilise une application Atlassian OAuth 2.0 (3LO) pour s'authentifier auprès de votre produit Atlassian Cloud au nom de vos utilisateurs. Créez cette application dans l'Atlassian Developer Console avant de configurer Amazon Quick. 1. Ouvrez l'[Atlassian Developer Console](https://developer.atlassian.com/console/myapps/) et connectez-vous avec votre compte Atlassian. 1. Choisissez **Create**, puis choisissez **OAuth 2.0 integration**. 1. Dans **Nom**, entrez un nom descriptif pour votre intégration, par exemple`your-app-name connector`. 1. Consultez et acceptez les conditions d'utilisation d'Atlassian destinées aux développeurs. 1. Choisissez **Créer**. ### Configurer les autorisations Après avoir créé l'application OAuth 2.0, ajoutez les autorisations d'API dont Amazon Quick a besoin pour interagir avec votre produit Atlassian. 1. Depuis votre application dans l'Atlassian Developer Console, choisissez **Permissions** dans le menu de navigation de gauche. 1. **Recherchez l'API de votre produit Atlassian (par exemple, l'API **Jira ou l'API** **Confluence) et choisissez Ajouter**.** Le bouton devient **Configurer** une fois l'API ajoutée. 1. Choisissez **Configurer**. La page Étendue s'ouvre avec les onglets **Étendue classique et Étendue** **granulaire**. 1. Dans l'onglet **Étendues classiques**, choisissez **Modifier les étendues**. Sélectionnez les portées classiques requises, puis cliquez sur **Enregistrer**. 1. Choisissez l'onglet **Étendues granulaires, puis sélectionnez **Modifier** les étendues**. **Sélectionnez les étendues granulaires requises, puis cliquez sur Enregistrer.** Pour connaître les étendues spécifiques requises pour votre intégration, consultez la section sur les étendues qui suit. ### Champs d'application requis pour Confluence Ajoutez les étendues suivantes à votre application OAuth 2.0 pour l'intégration des actions Confluence Cloud. **Lunette classique** Dans l'onglet **Étendue classique**, choisissez **Modifier les étendues**, puis sélectionnez l'étendue suivante. **Intégration des actions Confluence — portée classique** | Scope | Description | | --- | --- | | search:confluence | Recherchez des résumés de contenu et d'espace dans Confluence. | **Oscopes granulaires** Choisissez l'onglet **Étendues granulaires, puis sélectionnez **Modifier** les étendues**. Sélectionnez les étendues suivantes. **Intégration des actions Confluence — scopes granulaires** | Scope | Description | | --- | --- | | read:page:confluence | Afficher le contenu de la page. | | write:page:confluence | Créez et mettez à jour des pages. | | read:space:confluence | Accédez aux informations relatives à l'espace. | ### Configuration de l’autorisation Définissez l'URL de rappel afin qu'Atlassian puisse rediriger les utilisateurs vers Amazon Quick après avoir autorisé l'application. 1. Depuis votre application dans l'Atlassian Developer Console, sélectionnez **Autorisation** dans le menu de navigation de gauche. 1. À côté de **OAuth 2.0 (3LO)**, choisissez **Ajouter**. 1. Pour **Callback URLs**, entrez`https://region.quicksight.aws.amazon.com/sn/oauthcallback`. *region*Remplacez-le par la AWS région dans laquelle votre instance Amazon Quick est déployée, par exemple`us-east-1`. 1. Sélectionnez **Enregistrer les modifications**. ### Enregistrez vos informations d'identification Avant de quitter l'Atlassian Developer Console, vérifiez que vous disposez des valeurs suivantes. Vous en avez besoin pour la configuration d'Amazon Quick. 1. Depuis votre application dans l'Atlassian Developer Console, choisissez **Paramètres** dans le menu de navigation de gauche. 1. Sous **Détails de l'authentification**, copiez l'**ID client** et les valeurs **secrètes**. **Informations d'identification requises depuis l'Atlassian Developer Console** | Value | Où le trouver | | --- | --- | | ID de client | Page des paramètres, sous Détails de l'authentification | | Secret | Page des paramètres, sous Détails de l'authentification | ## Préparer l'authentification Les connecteurs d'action Confluence Cloud prennent en charge deux méthodes d'authentification. Rassemblez les informations d'identification requises avant de configurer Amazon Quick. **Authentification utilisateur (3LO)** Si vous avez terminé la configuration de l'Atlassian Developer Console dans la section précédente, les valeurs suivantes devraient être prêtes. Entrez-les lorsque vous configurez l'intégration dans Amazon Quick. + **URL de base : URL** de votre instance Confluence pour les appels d'API. Il ne s'agit pas de l'URL à laquelle les utilisateurs se connectent. Cela ressemble à ce qui suit :`https://api.atlassian.com/ex/confluence/yourInstanceId`. Pour trouver l'ID de votre instance, accédez à`https://your-domain.atlassian.net/_edge/tenant_info`. + **ID client** : depuis la page Paramètres de votre application Atlassian OAuth . + **Secret du client** : depuis la page des paramètres de votre application Atlassian OAuth . + **URL du jeton** — `https://auth.atlassian.com/oauth/token` + **URL d'autorisation** — `https://auth.atlassian.com/authorize` + **URL de redirection** — `https://region.quicksight.aws.amazon.com/sn/oauthcallback` **Authentification du service (clé API)** Rassemblez les informations suivantes auprès de votre administrateur Confluence Cloud : + **Clé d'API** : jeton d'API Confluence. + **URL de base : URL** de votre instance Confluence pour les appels d'API. + **E-mail : adresse e-mail** du compte utilisateur associé. ## Configurer l'intégration dans Amazon Quick Après avoir préparé vos informations d'authentification, créez l'intégration dans Amazon Quick. 1. Dans la console Amazon Quick, choisissez **Integrations.** 1. Choisissez l'onglet **Actions**. 1. Sous **Configurer une nouvelle intégration d'applications pour Actions**, recherchez **Atlassian Confluence Cloud** et cliquez sur le bouton Ajouter (plus « \$1 »). 1. **Sur la page **Type d'intégration**, sélectionnez **Effectuer des actions dans Atlassian Confluence Cloud**, puis choisissez Next.** 1. Dans le formulaire **Créer une intégration**, renseignez les champs suivants : + **Nom : nom** descriptif de votre intégration Confluence. + **Description** (facultatif) — Remarques sur la façon dont cette connexion sera utilisée. + **Type de connexion** — Choisissez **Réseau public**. 1. Dans **Paramètres d'authentification**, choisissez votre méthode d'authentification et renseignez les champs obligatoires : 1. Pour **l'authentification de l'utilisateur**, configurez les champs suivants : + **URL de base : URL** de votre instance Confluence pour les appels d'API, au format`https://api.atlassian.com/ex/confluence/yourInstanceId`. Pour trouver l'ID de votre instance, accédez à`https://your-domain.atlassian.net/_edge/tenant_info`. + **ID client : ID** client depuis la page Paramètres de votre application Atlassian OAuth . + **Secret client** : secret depuis la page des paramètres de votre application Atlassian OAuth . + **URL du jeton** — `https://auth.atlassian.com/oauth/token` + **URL d'autorisation** — `https://auth.atlassian.com/authorize` + **URL de redirection** : ce champ est prérempli avec votre URL de rappel Amazon Quick. 1. Pour **l'authentification du service**, configurez les champs suivants : + **Clé d'API** : jeton d'API Confluence. + **URL de base : URL** de votre instance Confluence pour les appels d'API. + **E-mail : adresse e-mail** du compte utilisateur associé. 1. Choisissez **Créer et continuer**. 1. (Facultatif) Sur la page **Partager l'intégration**, choisissez les utilisateurs avec lesquels partager l'intégration. ## Actions disponibles Après avoir configuré l'intégration, les actions suivantes sont disponibles. **Actions disponibles dans Confluence Cloud** | Action | Description | | --- | --- | | Créer une page | Créez une nouvelle page. | | Obtenir des pages | Afficher toutes les pages. | | Recherche | Recherchez du contenu à l'aide de CQL. | | Mettre à jour la page | Mettez à jour le contenu de la page. | ## Gestion et résolution des problèmes Pour modifier, partager ou supprimer votre intégration, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations). ### Problèmes d’authentification + **Configuration d'application incorrecte** : vérifiez que l' OAuth application dans l'Atlassian Developer Console inclut les champs d'application requis et que l'URI de redirection correspond à votre configuration Amazon Quick. + **Jeton d'API expiré** : si vous utilisez l'authentification de service, vérifiez que le jeton d'API n'a pas expiré et générez-en un nouveau si nécessaire. + **URL de base incorrecte** : l'URL de base pour les appels d'API n'est pas la même que l'URL de connexion à Confluence Cloud. Vérifiez que vous utilisez le format d'URL de l'API :`https://api.atlassian.com/ex/confluence/yourInstanceId`. Pour trouver l'ID de votre instance, accédez à`https://your-domain.atlassian.net/_edge/tenant_info`. ### Messages d'erreur courants + **`Access denied. You do not have permission to perform this action`**— L'utilisateur authentifié ne dispose pas des autorisations requises dans Confluence Cloud. Contactez votre administrateur Confluence Cloud pour vérifier et accorder les autorisations appropriées. + **`OAuth 2.0 authorization failed`**— Vérifiez que l'ID client, le secret du client et OAuth les étendues sont correctement configurés dans l'Atlassian Developer Console et Amazon Quick.