View a markdown version of this page

Intégration des actions d'Atlassian Confluence Cloud - Amazon Quick
Avant de commencerConfiguration de l'Atlassian Developer ConsolePréparer l'authentificationConfigurer l'intégration dans Amazon QuickActions disponiblesGestion et résolution des problèmes

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, consultezMéthodes d’authentification.

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.

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.

Pour plus d'informations sur les applications OAuth 2.0 (3LO), consultez la section Applications OAuth 2.0 (3LO) 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 et connectez-vous avec votre compte Atlassian.

  2. Choisissez Create, puis choisissez OAuth 2.0 integration.

  3. Dans Nom, entrez un nom descriptif pour votre intégration, par exempleyour-app-name connector.

  4. Consultez et acceptez les conditions d'utilisation d'Atlassian destinées aux développeurs.

  5. 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.

  2. 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.

  3. Choisissez Configurer. La page Étendue s'ouvre avec les onglets Étendue classique et Étendue granulaire.

  4. Dans l'onglet Étendues classiques, choisissez Modifier les étendues. Sélectionnez les portées classiques requises, puis cliquez sur Enregistrer.

  5. 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.

  2. À côté de OAuth 2.0 (3LO), choisissez Ajouter.

  3. Pour Callback URLs, entrezhttps://region.quicksight.aws.amazon.com/sn/oauthcallback. regionRemplacez-le par la AWS région dans laquelle votre instance Amazon Quick est déployée, par exempleus-east-1.

  4. 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.

  2. 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.

  2. Choisissez l'onglet Actions.

  3. Sous Configurer une nouvelle intégration d'applications pour Actions, recherchez Atlassian Confluence Cloud et cliquez sur le bouton Ajouter (plus « + »).

  4. Sur la page Type d'intégration, sélectionnez Effectuer des actions dans Atlassian Confluence Cloud, puis choisissez Next.

  5. 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.

  6. 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 formathttps://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.

    2. 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é.

  7. Choisissez Créer et continuer.

  8. (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, consultezGestion des intégrations existantes.

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.