Configurer le spoke pour Jira le Jira cloud
Intégrez votre ServiceNow instance à l’instanceJira Cloud pour authentifier les demandes à partir de ServiceNow.
Avant de commencer
- Demandez un Centre d'intégration abonnement.
- Activez le spoke Jira.
- Rôle requis : admin.
Pourquoi et quand exécuter cette tâche
Vous pouvez configurer le spoke pour votre Jira instance dans le cloud à l’aide de l’authentification de base ou de l’authentification Jira OAuth selon vos besoins.
Option 1 : Utilisation de l’authentification de base (jeton d’API )
Intégrez l’instance et l’instance ServiceNow de cloud à l’aide d’une clé API pour authentifier les demandesServiceNow.Jira
Avant de commencer
Rôle requis : admin.
Pourquoi et quand exécuter cette tâche
Générer un jeton d’API de compte Atlassian
Générez un jeton d’API Atlassian de compte pour authentifier les demandes de spokes associés à un Atlassian compte.
Avant de commencer
Assurez-vous d’avoir un Atlassian compte.
Rôle requis : Atlassian informations d’identification de l’administrateur
Pourquoi et quand exécuter cette tâche
Remarque :
Cette procédure ne s’applique que si vous utilisez l’abonnement Jira Cloud .
Procédure
-
Accédez à la photo de profil de votre compte et sélectionnez Paramètres du compte.
-
Sélectionnez Créer.
Le jeton d’API est généré.
-
Sélectionnez Copier et enregistrez la valeur du jeton d’API pour une utilisation ultérieure.
Que faire ensuite
Configurer une connexion pour le spoke Jira
Ajoutez et configurez une connexion Jira pour authentifier les ServiceNow demandes dans le spoke Jira.
Avant de commencer
Rôle requis : admin
Procédure
-
Renseignez les champs du formulaire Connexion .
Champ Description Nom de la connexion Nom permettant d’identifier la connexion de façon unique. Par exemple, Jira spoke cloud basic conn. URL de connexion URL de votre instance Jira au format suivant : https://<provider-domain-name>.atlassian.net. Type de serveur Sélectionnez le cloud. Nom d'utilisateur Saisissez l’adresse e-mail de l’utilisateur. Clé API Saisissez le jeton d’API que vous avez généré pour votre instance Jira Cloud.
Option 2 : Utilisation de l’authentification de base (jeton d’API avec champs d’application)
Intégrez l’instance et l’instance ServiceNow de cloud à l’aide d’une clé API avec des champs d’application pour authentifier les demandesServiceNow.Jira
Avant de commencer
Rôle requis : admin.
Pourquoi et quand exécuter cette tâche
Générer un jeton d’API de compte Atlassian avec des champs d’application
Générez un jeton d’API Atlassian de compte avec les champs d’application requis pour authentifier les demandes de spokes associés à un Atlassian compte.
Avant de commencer
Assurez-vous d’avoir un Atlassian compte.
Rôle requis : Atlassian informations d’identification de l’administrateur
Pourquoi et quand exécuter cette tâche
Remarque :
Cette procédure ne s’applique que si vous utilisez l’abonnement Jira Cloud.
Procédure
-
Accédez à la photo de profil de votre compte et sélectionnez Paramètres du compte.
-
Cliquez sur Créer un jeton d’API avec des champs d’application.
-
Sur le formulaire Jeton d’API de nom, saisissez Nom, sélectionnez une date d’expiration pour le jeton, puis cliquez sur Suivant.
-
Dans le formulaire Sélectionner l’application, sélectionnez Jira , puis cliquez sur Suivant.
-
Dans le formulaire Sélectionner les champs d’application Jira, sélectionnez les champs d’application requis et cliquez sur Suivant.
Pour plus d’informations sur les périmètres nécessaires pour utiliser les actions de spoke requises, reportez-vous à la section Périmètres des jetons d’API requis.
-
Examinez les champs d’application des jetons d’API et cliquez sur Créer un jeton.
Le jeton d’API est généré et affiché. Copiez et enregistrez la valeur du jeton pour une utilisation ultérieure.
Configurer une connexion pour le spoke Jira
Ajoutez et configurez une connexion Jira pour authentifier les ServiceNow demandes dans le spoke Jira.
Avant de commencer
Rôle requis : admin
Procédure
-
Renseignez les champs du formulaire Connexion .
Champ Description Nom de la connexion Nom permettant d’identifier la connexion de façon unique. Par exemple, Jira spoke cloud basic conn. URL de connexion URL de votre instance Jira au format suivant : https://<provider-domain-name>.atlassian.net. Type de serveur Sélectionnez le cloud. Nom d'utilisateur Saisissez l’adresse e-mail de l’utilisateur. Clé API Saisissez le jeton d’API que vous avez généré pour votre instance Jira Cloud.
Périmètres des jetons d’API requis
Les champs d’application de jeton d’API nécessaires pour utiliser l’action de spoke requise sont répertoriés ici.
Ces champs d’application sont nécessaires lorsque vous configurez le spoke Jira pour Jira Cloud à l’aide du jeton d’API avec champ d’application. Pour plus d'informations, consultez Option 2 : Utilisation de l’authentification de base (jeton d’API avec champs d’application).
| Catégorie | Action | Description | Périmètre requis (classique) | Périmètres requis (granuleux) |
|---|---|---|---|---|
| Gestion de l'audit | Rechercher un flux de journaux d'audit | Récupère l’activité de connexion pour les abonnements utilisateur AtlassianJira . Remarque : Cette action est prise en charge sur Server 9 et versions antérieures, ainsi Jira que sur Jira Cloud. |
Gérer :configuration Jira | Lire :Audit-Journal :Jira, Lire :Utilisateur :Jira |
| Rechercher un flux de journaux d'audit (Server versions 10 et ultérieures) | Récupère les enregistrements du journal d’audit de l’instance dans une Jira plage de dates spécifiée. Remarque : Cette action est prise en charge sur Jira Server 9 et les versions ultérieures. |
Cette action est prise en charge uniquement sur le serveur Jira. | ||
| Gestion des groupes | Ajouter un utilisateur au groupe | Ajoute un utilisateur donné à un groupe dans Jira. | Gérer :configuration Jira | Écrire :Groupe :Jira, Lire :Avatar :Jira, Lire :Groupe :Jira, Lire :Utilisateur :Jira |
| Créer un groupe | Crée un groupe dans Jira. | Gérer :configuration Jira | Lire :Groupe :Jira, Lire :Utilisateur :Jira, Écrire :Groupe :Jira, Lire :Avatar :Jira | |
| Rechercher un flux de groupes | Récupère tous les groupes du compte Atlassian, y compris les groupes par défaut. Remarque : Cette action peut être utilisée uniquement avec Jira un abonnement Cloud. |
Lire :Jira-user | Lire :Groupe :Jira | |
| Rechercher des utilisateurs par flux de nom de groupe | Récupère les détails de tous les membres d'un groupe Atlassian. | Gérer :configuration Jira | Lire :Groupe :Jira, Lire :Utilisateur :Jira, Lire :Avatar :Jira | |
| Supprimer un groupe | Supprime le groupe donné de Jira. | Gérer :configuration Jira | Supprimer :Group :Jira | |
| Retirer l'utilisateur du groupe | Supprime l’utilisateur donné d’un groupe dans Jira. | Gérer :configuration Jira | Écriture :Groupe :Jira | |
| Gestion des problèmes | Ajouter un commentaire | Ajoute un commentaire au problème spécifié dans Jira. | Écrire :Jira-travail | Lecture :Commentaire :Jira, Lecture :Commentaire.Propriété :Jira, Lecture :Groupe :Jira, Lecture :Projet :Jira, Lecture :Projet-Rôle :Jira, Lecture :Utilisateur :Jira, Écriture :Commentaire :Jira, Lecture :Avatar :Jira |
| Ajouter un observateur | Ajoute l’utilisateur spécifié en tant qu’observateur pour le problème spécifié. | Écrire :Jira-travail | Écrire :Problème.Observateur :Jira | |
| Affecter le problème | Affecte le problème à Jira l’utilisateur. | Écrire :Jira-travail | Écrire :Problème :Jira | |
| Copier la pièce jointe | Copie la pièce jointe requise associée à l’enregistrement ServiceNow sur le problème requis dans Jira. | Écrire :Jira-travail | Lire :Utilisateur :Jira, Écrire :Attachement :Jira, Lire :Attachement :Jira, Lire :Avatar :Jira | |
| Créer un problème | Crée un problème dans Jira. Selon la façon dont votre organisation l’utilise Jira, un problème peut représenter un bogue logiciel, une tâche de projet, un ticket de support technique, etc. Un problème dans Jira représente une tâche dans le ServiceNow AI Platform. | Écrire :Jira-travail, Lire :Jira-travail | Écrire :Problème :Jira, Écrire :Comment :Jira, Écrire :Commentaire.Propriété :Jira, Écrire :Attachement :Jira, Lire :Problème :Jira | |
| Supprimer la pièce jointe | Supprime la pièce jointe requise dans Jira. | Écrire :Jira-travail | Supprimer :Pièce jointe :Jira | |
| Supprimer le problème | Supprime un problème dans Jira. | Écrire :Jira-travail | Supprimer :Problème :Jira | |
| Supprimer un observateur | Supprime l’utilisateur en tant qu’observateur pour le problème spécifié. | Écrire :Jira-travail | Écrire :Problème.Observateur :Jira | |
| Effectuer la transition | Fait passer un problème d’un Jira état à un autre. | Écrire :Jira-travail | Écrire :Problème :Jira, Écrire :Problème.Propriété :Jira | |
| Rechercher les statuts de types de problème par projet | Récupère les détails des états d’un projet. | Lire :Jira-travail | Lecture :Problème-État :Jira, Lecture :Problème-Type :Jira, Lecture :Statut :Jira | |
| Rechercher un problème | Récupère les détails d'un problème. | Lire :Jira-travail | Lecture :Problème-Meta :Jira, Lecture :Problème-Sécurité-Niveau :Jira, Lecture :Problème.Vote :Jira, Lecture :Problème.Journal des modifications :Jira, Lecture :Avatar :Jira, Lecture :Problème :Jira, Lecture :État :Jira, Lecture :Utilisateur :Jira, Lecture :Configuration-duchamp :Jira | |
| Rechercher les priorités des problèmes | Récupère la liste des priorités de problèmes et les détails relatifs à chaque priorité. | Écrire :Jira-travail, Lire :Jira-travail | Lire :Priorité :Jira | |
| Rechercher le flux de problèmes | Récupère une liste des problèmes correspondant à une chaîne de requête JQL. | Lire :Jira-travail | Lire :Détails-du-problème :Jira, Lire :Journal-audit :Jira, Lire :Avatar :Jira, Lire :Configuration-de-champ :Jira, Lire :Problème-Meta :Jira | |
| Rechercher un flux de problèmes de sprint | Récupère les détails de tous les problèmes pour le sprint donné. | Aucun champ d’application classique disponible. | lire :sprint :jira-software , lire :issue-details :jira, lire :jql :jira | |
| Rechercher des transitions | Récupère des informations sur toutes les transitions pour un ID de problème donné. | Lire :Jira-travail | Lecture :Problème.Transition :Jira, Lecture :État :Jira, Lecture :Configuration-de-champ | |
| Rechercher des observateurs | Récupère la liste des observateurs pour le problème spécifié. | Lire :Jira-travail | Lire :Problème.Observateur :Jira, Lire :Utilisateur :Jira, Lire :Avatar :Jira | |
| Mettre à jour le problème | Met à jour un nombre défini de champs d’un problème dans Jira avec des valeurs transmises comme entrée. | Écrire :Jira-travail, Lire :Jira-travail | Écrire :Problème :Jira | |
| Récupération des métadonnées | Obtenir les champs créables (métadonnées) | Récupère la liste de tous les champs dans un projet requis Jira . | Écrire :Jira-travail, Lire :Jira-travail | Lire :Problème-Meta :Jira, Lire :Avatar :Jira, Lire :Field-Configuration :Jira |
| Obtenir les champs créables (métadonnées) | Récupère la liste de tous les champs modifiables dans un problème requis Jira . | Écrire :Jira-travail, Lire :Jira-travail | Lire :Problème-Méta :Jira, Lire :Configuration-Champ :Jira | |
| Obtenir les types de problème (métadonnées) | Récupère la liste de tous les types de problèmes dans un projet requis Jira . | Écrire :Jira-travail, Lire :Jira-travail | Lire :Problème-Meta :Jira, Lire :Avatar :Jira, Lire :Field-Configuration :Jira | |
| Gestion des projets | Créer un projet | Crée un projet dans Jira. | Gérer :configuration Jira | Écrire :Projet :Jira, Lire :Projet :Jira |
| Rechercher un projet | Récupère les détails du projet spécifié par son ID ou sa clé. | Écrire :Jira-travail, Lire :Jira-travail | Lecture :Type-problème :Jira, Lecture :Projet :Jira, Lecture :Projet.Propriété :Jira, Lecture :Utilisateur :Jira, Lecture :Rôle-application :Jira, Lecture :Avatar :Jira, Lecture :Groupe :Jira, Lecture :Hiérarchie-type-problème :Jira, Lecture :Catégorie-projet :Jira, Lecture :Version-projet :Jira, Lecture :Composant.Projet :Jira | |
| Rechercher des projets | Récupère les détails de tous les projets. Remarque : Cette action ne fonctionne que pour le Jira serveur. |
Cette action est prise en charge uniquement sur le serveur Jira. | ||
| Rechercher un flux de projets | Récupère les détails de tous les projets. Remarque : Cette action ne fonctionne que pour le Jira Cloud. |
Lire :Jira-travail | Lecture :Type-problème :Jira, Lecture :Projet :Jira, Lecture :Projet.Propriété :Jira, Lecture :Utilisateur :Jira, Lecture :Rôle-application :Jira, Lecture :Avatar :Jira, Lecture :Groupe :Jira, Lecture :Hiérarchie-type-problème :Jira, Lecture :Catégorie-projet :Jira, Lecture :Version-projet :Jira, Lecture :Composant.Projet :Jira | |
| Rechercher des utilisateurs pouvant être affectés à des projets | Récupère une liste d’utilisateurs qui peuvent être affectés à des problèmes dans un ou plusieurs projets. | Lire :Jira-user | Lire :Projet :Jira, Lire :Utilisateur :Jira, Lire :Rôle-application :Jira, Lire :Avatar :Jira, Lire :Groupe :Jira | |
| Gestion des sprints | Créer un sprint | Crée un sprint dans Jira. | Aucun champ d’application classique n’est disponible. | read :board-scope :jira-software , read :project :jira Créer un sprint - write :sprint :jira-software |
| Supprimer le sprint | Supprime un sprint dans Jira. | Aucun champ d’application classique n’est disponible. | Supprimer :sprint :Jira-software | |
| Rechercher un sprint | Récupère les détails du sprint requis sous la forme d’un objet complexe. | Aucun champ d’application classique n’est disponible. | Lecture :Sprint :Jira-software | |
| Rechercher des sprints par tableau | Récupère les détails de tous les sprints dans le tableau requis. | Aucun champ d’application classique n’est disponible. | Lecture :Sprint :Jira-software | |
| Mettre à jour le sprint | Met à jour les détails d’un sprint dans Jira. | Aucun champ d’application classique n’est disponible. | write :sprint :jira-software | |
| Gestion des stories | Créer une story | Crée une story dans l’instance Jira Cloud. Ceci est comparable à la story dans le module d’extension ServiceNow Agile Development. | Écrire :Jira-travail | Écrire :Problème :Jira, Écrire :Comment :Jira, Écrire :Commentaire.Propriété :Jira, Écrire :Attachement :Jira, Lire :Problème :Jira |
| Rechercher le flux des stories | Récupère les détails de toutes les stories. | Lire :Jira-travail | Lecture :Détails-problème :Jira, Lecture :Champ.Valeur par défaut :Jira, Lecture :Champ.Option :Jira, Lecture :Champ :Jira, Lecture :Groupe :Jira | |
| Mettre à jour la story | Met à jour un nombre défini de champs d’une story dans Jira le cloud avec les valeurs d’entrée fournies. | Écrire :Jira-travail | Écrire :Problème :Jira | |
| Gestion des utilisateurs | Créer un utilisateur | Crée un utilisateur dans Jira. Remarque : Cette action n’est pas prise en charge lorsque l’authentification OAuth 2.0 est utilisée. |
Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | |
| Rechercher un utilisateur authentifié | Récupère les détails du compte d'utilisateur authentifié. | Lire :Jira-user | Lecture :Rôle-application :Jira, Lecture :Groupe :Jira, Lecture :Utilisateur :Jira, Lecture :Avatar :Jira | |
| Rechercher les appartenances à des groupes pour l'utilisateur | Récupère les détails de tous les groupes d'un utilisateur Atlassian. | Lire :Jira-user | Lire :Groupe :Jira | |
| Rechercher un flux d'utilisateurs | Récupère les détails de tous les abonnements utilisateur Atlassian Jira . Remarque : Cette action peut être utilisée avec un Jira abonnement cloud uniquement. |
Lire :Jira-user | Lire :Utilisateur :Jira, Lire :Rôle-application :Jira, Lire :Avatar :Jira, Lire :Groupe :Jira | |
| Rechercher un flux d'utilisateurs par nom | Récupère une liste d’utilisateurs qui correspondent à la chaîne de recherche. Remarque : Cette action peut être utilisée avec un Jira abonnement au serveur uniquement. |
Cette action est prise en charge uniquement sur le serveur Jira. | ||
| Supprimer un utilisateur | Supprime un utilisateur de Jira. Remarque : Cette action n’est pas prise en charge lorsque l’authentification OAuth 2.0 est utilisée. |
Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | ||
| Actions d'utilitaire | Copier la pièce jointe du problème dans l'enregistrement | Copie la pièce jointe Jira depuis n’importe quel enregistrement de l’instance ServiceNow . Lorsque vous utilisez cette action dans un flux secondaire, assurez-vous que la pastille de données URL de contenu est spécifiée dans le champ URL de la pièce jointe. | Aucun champ d’application applicable, car le point de terminaison Jira n’est pas utilisé dans cette action. | |
| Rechercher des champs | Récupère le nom interne et d’autres détails de l’étiquette de champ requise dans Jira. | Lire :Jira-travail | Lecture :Champ :Jira, Lecture :Avatar :Jira, Lecture :Catégorie-Projet :Jira, Lecture :Projet :Jira, Lecture :Configuration-de-champ | |
| Rechercher un problème à partir d'un commentaire | Récupère les détails du problème en analysant la charge utile du commentaire spécifié. Vous pouvez utiliser cette action dans le flux secondaire de webhook de processus Jira pour le serveur JIRA sur site lorsque seules les informations relatives au commentaire sont spécifiées sans aucun détail sur le Jira problème. Par exemple, lorsque seules les informations de commentaire sont spécifiées, cette action analyse la charge utile et extrait les détails du problème. | Aucun champ d’application applicable, car le point de terminaison Jira n’est pas utilisé dans cette action. | ||
| Rechercher la dernière pièce jointe sur un problème | Récupère la dernière pièce jointe pour le problème spécifié à partir de Jira. Vous pouvez utiliser cette action dans un flux ou un flux secondaire pour validation. Par exemple, un flux secondaire ajoute une pièce jointe supplémentaire uniquement lorsque la dernière pièce jointe d’un problème dans Jira n’est pas la même que la pièce jointe spécifiée. | Lire :Jira-travail | Lecture :Problème-Meta :Jira, Lecture :Problème-Sécurité-Niveau :Jira, Lecture :Problème.Vote :Jira, Lecture :Problème.Journal des modifications :Jira, Lecture :Avatar :Jira, Lecture :Problème :Jira, Lecture :État :Jira, Lecture :Utilisateur :Jira, Lecture :Configuration-duchamp :Jira | |
| Rechercher le dernier commentaire sur un problème | Récupère le dernier commentaire pour le problème spécifié à partir de Jira. Vous pouvez utiliser cette action dans un flux ou un flux secondaire pour validation. Par exemple, un flux secondaire ajoute un commentaire supplémentaire uniquement lorsque le dernier commentaire d’un problème dans Jira n’est pas le même commentaire spécifié. | Lire :Jira-travail | Lecture :Commentaire :Jira, Lecture :Commentaire.Propriété :Jira, Lecture :Groupe :Jira, Lecture :Projet :Jira, Lecture :Projet-Rôle :Jira, Lecture :Utilisateur :Jira, Lecture :Avatar :Jira | |
| Rechercher un serveur | Récupère des informations générales sur l’instance JIRA actuelle. | Tout périmètre | Tout périmètre | |
| Gestion des Webhook | Rechercher des webhooks | Récupère les détails de tous les webhooks enregistrés à partir de l’instance Jira . | Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | |
| S'abonner au webhook | Enregistre un webhook dans l’instance Jira . | Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | ||
| Se désabonner du webhook | Supprime le webhook enregistré dans l’instance Jira . | Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | ||
| Mettre à jour un webhook | Met à jour le webhook avec l’ID donné dans Jira. Remarque : Cette action n’est pas prise en charge lorsque l’authentification OAuth 2.0 est utilisée. |
Le jeton d’API inclus dans le champ d’application n’est pas pris en charge pour cette action. | ||
Option 3 : Utilisation de l’authentification OAuth
Intégrez l’instance à votre compte à l’aide Jira d’OAuth pour authentifier les ServiceNow demandesServiceNow.
Avant de commencer
Rôle requis : admin.
Créer une intégration OAuth 2.0 dans le Jira compte
Créez une intégration OAuth 2.0 dans la Atlassian console du développeur pour authentifier les demandes.
Avant de commencer
Rôle requis : admin
Procédure
-
Sous Mes applications, cliquez sur Créer et sélectionnez Intégration OAuth 2.0.
-
Sur le formulaire, indiquez le nom de l’intégration et cliquez sur Créer.
L’intégration est créée et la valeur de l’ID d’application s’affiche.
-
Cliquez sur Autorisation.
-
Cliquez sur Ajouter sous Action.
-
Dans URL de rappel, indiquez l’URL de votre ServiceNow instance au format suivant : https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do.
Par exemple, https://example.service-now.com/oauth_redirect.do
-
Cliquez sur Ajouter sous Action.
-
Cliquez sur Paramètres.
Sous Détails d’authentification, copiez les valeurs ID client et Secret client.
Obtenir la valeur de l’ID dans le cloud
Obtenez la valeur de l’ID dans le cloud de l’instance dans le Jira cloud. Cette valeur est requise lors de la configuration de l’enregistrement de connexion dans votre ServiceNow instance.
Avant de commencer
Rôle requis : admin
Procédure
Créer un registre d’application dans l’instance ServiceNow
Utilisez les informations générées lors de la création de l’intégration OAuth 2.0 pour créer un enregistrement de registre d’application dans votre ServiceNow instance.
Avant de commencer
Rôle requis : admin
Procédure
Créer un enregistrement d’informations d’identification pour le Jira spoke
Créez un enregistrement d’informations d’identification pour le Jira compte. Les Jira alias de connexion et d’informations d’identification du spoke utilisent ces informations d’identification pour autoriser des actions.
Avant de commencer
Rôle requis : admin
Procédure
Créer un enregistrement de connexion pour le Jira spoke
Créez un enregistrement de connexion pour le Jira compte. L’alias de connexion et d’informations d’identification utilise cette connexion pour effectuer des actions dans Jira.
Avant de commencer
Rôle requis : admin.
Procédure
-
Dans la liste connexe Attributs, fournissez ces valeurs.
- Entrez la valeur 2 pour api_version.
- Entrez le cloud de valeurs pour server_type.