Intégration à Jira Cloud - Amazon Quick
Actions possiblesAvant de commencerCréation d'un jeton d'API JiraConfiguration de l'intégration à JiraConfiguration de l'authentificationActions disponiblesPartagez des intégrationsGérez les intégrations Jira

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 à Jira Cloud

Connectez Amazon Quick à votre instance Jira Cloud pour gérer les problèmes, les projets et les autres objets Jira. Vous pouvez créer, mettre à jour et interroger du contenu Jira sans quitter votre environnement Amazon Quick. Cette intégration nécessite le niveau Amazon Quick Pro ou supérieur.

Actions possibles

Grâce à l'intégration de Jira Cloud, vous pouvez effectuer des actions au sein de vos instances Jira via l'API REST de Jira.

Connecteur Action

Créez, mettez à jour et interrogez des problèmes, des projets et d'autres objets Jira via l'API REST de Jira.

Note

Cette intégration prend uniquement en charge l'exécution d'actions. Vous ne pouvez pas l'utiliser pour créer des bases de connaissances ou accéder aux données Jira à des fins de recherche.

Avant de commencer

Pour configurer l'intégration à Jira, vous avez besoin des éléments suivants :

  • Instance Jira Cloud avec les autorisations appropriées.

  • Informations d'identification du compte utilisateur Jira ou du jeton d'API.

  • Amazon Quick Author ou version ultérieure.

  • Accès administratif pour configurer les OAuth applications (pour l'authentification des utilisateurs).

Création d'un jeton d'API Jira

Pour utiliser l'authentification par clé d'API, créez un jeton d'API dans votre compte Atlassian.

  1. Accédez aux paramètres de votre compte Atlassian et sélectionnez Sécurité.

  2. Créez un nouveau jeton d'API pour l'intégration d'Amazon Quick.

  3. Copiez le jeton généré à utiliser dans votre configuration d'intégration Amazon Quick.

  4. Notez l'URL de votre instance Jira Cloud et l'adresse e-mail de votre utilisateur. L'URL de votre instance Jira Cloud est une valeur spéciale pour les appels d'API que vous pouvez trouver en accédant à. https://your-domain.atlassian.net/_edge/tenant_info

Important

Jira Cloud peut renvoyer des réponses de réussite HTTP 200 même lorsque les jetons d'API sont révoqués ou mal configurés. Pour plus d'informations, voir JRACLOUD-82932. Si votre intégration semble réussir mais que les actions échouent de manière inattendue, vérifiez que votre jeton d'API est valide et qu'il n'a pas été révoqué.

Configuration de l'intégration à Jira

Suivez ces étapes pour connecter Amazon Quick à votre instance Jira Cloud.

  1. Dans la console Amazon Quick, choisissez Integrations.

  2. Cliquez sur Ajouter (plus le bouton « + »).

  3. Complétez les détails de l'intégration :

    • Nom : entrez un nom descriptif pour votre intégration Jira.

    • Description (facultatif) - Décrivez l'objectif de cette intégration.

  4. Choisissez le type de connexion (authentification de l'utilisateur ou du service).

  5. Complétez les paramètres de connexion en fonction de la méthode d'authentification :

    • Pour l'authentification de l'utilisateur (OAuth) :

      • URL de base : URL de votre instance Jira Cloud. Cela doit être fourni dans le format suivant :https://api.atlassian.com/ex/jira/instanceid. Vous instanceid pouvez être trouvé en accédant à. https://your-domain.atlassian.net/_edge/tenant_info

      • ID client : l'identifiant client de votre OAuth application Atlassian.

      • Secret du client : le secret du client de votre OAuth application Atlassian.

      • URL du jeton : point de terminaison du OAuth jeton Atlassian.

      • URL d'authentification : point de terminaison d'autorisation Atlassian OAuth .

      • URL de redirection - URI de OAuth redirection.

    • Pour l'authentification du service (clé API) :

      • URL de base : URL de votre instance Jira Cloud.

      • Clé d'API : votre jeton d'API Jira.

      • E-mail : adresse e-mail associée à votre compte utilisateur Jira.

  6. Sélectionnez Créer et continuer.

  7. Sélectionnez les utilisateurs avec lesquels partager l'intégration.

  8. Cliquez sur Suivant.

Configuration de l'authentification

L'intégration de Jira Cloud prend en charge deux méthodes d'authentification. Choisissez la méthode qui convient le mieux à votre organisation.

Authentification utilisateur (OAuth)

OAuth À utiliser lorsque vous souhaitez que des actions soient effectuées sous des identités d'utilisateur individuelles. Configurez les champs suivants :

  • URL de base : URL de votre instance Jira Cloud.

  • ID client : l'identifiant client de votre OAuth application Atlassian.

  • Secret du client : le secret du client de votre OAuth application Atlassian.

  • URL du jeton : point de terminaison du OAuth jeton Atlassian.

  • URL d'authentification : point de terminaison d'autorisation Atlassian OAuth .

  • URL de redirection - URI de OAuth redirection.

OAuth Étendue requise :

  • read:jira-user- Lisez les informations de l'utilisateur.

  • read:jira-work- Lisez les problèmes, les projets et les éléments de travail.

  • write:jira-work- Créez et modifiez des problèmes et des éléments de travail.

  • manage:jira-project- Gérez les paramètres du projet.

  • manage:jira-configuration- Gérez la configuration de Jira.

  • manage:jira-webhook- Gérez les webhooks.

  • read:sprint:jira-software- Lisez les informations relatives au sprint.

  • write:sprint:jira-software- Créez et modifiez des sprints.

  • delete:sprint:jira-software- Supprimez les sprints.

  • write:board-scope:jira-software- Gérez les configurations des cartes.

Authentification du service (clé API)

Utilisez l'authentification par clé d'API pour service-to-service les connexions. Configurez les champs suivants :

  • URL de base : URL de votre instance Jira Cloud.

  • Clé d'API : votre jeton d'API Jira.

  • E-mail : adresse e-mail associée à votre compte utilisateur Jira.

Note

En raison d'un comportement connu de Jira Cloud, l'intégration peut sembler se connecter correctement même avec des jetons d'API révoqués ou non valides. Si les actions échouent de façon inattendue après la configuration, vérifiez que votre jeton d'API est toujours valide dans les paramètres de votre compte Atlassian.

Actions disponibles

Après avoir créé votre intégration Jira, vous pouvez utiliser les actions suivantes pour interagir avec Jira Cloud :

  • Créez, lisez, mettez à jour et supprimez des problèmes Jira.

  • Gérez les transitions entre problèmes et les flux de travail.

  • Problèmes de requête à l'aide de JQL (Jira Query Language).

  • Gérez les projets, les composants et les versions.

  • Ajoutez des commentaires et des pièces jointes aux numéros.

  • Gérez les affectations des utilisateurs et les observateurs.

  • Accédez aux métadonnées du projet et du numéro.

Note

Les actions que vous pouvez utiliser dépendent des autorisations configurées dans votre instance Jira Cloud et de votre méthode d'authentification.

Partagez des intégrations

Vous pouvez partager votre connecteur d'action Jira avec d'autres utilisateurs de votre organisation.

  1. Après avoir créé l'intégration, choisissez Partager l'intégration.

  2. Sélectionnez les utilisateurs ou les groupes avec lesquels vous souhaitez partager l'intégration.

  3. Définissez les autorisations appropriées pour l'accès partagé.

  4. Confirmez vos paramètres de partage.

Gérez les intégrations Jira

Vous pouvez effectuer les tâches de gestion suivantes pour vos intégrations Jira :

  • Modifier les paramètres d'intégration : mettez à jour les paramètres d'authentification ou la configuration de l'instance Jira.

  • Partagez l'accès à l'intégration : mettez l'intégration à la disposition des autres utilisateurs de votre organisation.

  • Surveillez les statistiques d'utilisation : consultez les statistiques d'activité d'intégration et d'utilisation des API.

  • Passez en revue les actions disponibles : consultez la liste complète des actions Jira disponibles.

  • Supprimer l'intégration : supprimez l'intégration et révoquez l'authentification associée.