Intégrer Jira à Vélocité de changement DevOps — Espace de travail

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 8 minutes de lecture

    • Connectez-vous à votre serveur ou Jira à votre Jira instance de cloud à partir de l’espace de travail de changement DevOps pour découvrir les plans disponibles et enregistrer des webhooks pour suivre les projets, les stories, les fonctionnalités et les épopées.

    Avant de commencer

    Effectuez les tâches spécifiées dans la Premiers pas avec Vélocité de changement DevOps rubrique.

    Rôle requis : sn_devops.admin ou sn_devops.tool_owner

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail de changement DevOps et utilisez l’une des options suivantes pour ouvrir le Playbook à intégrer Jira.
      OptionÉtapes
      Page d'accueil
      1. Sélectionnez Connecter un outil.
      2. Dans la fenêtre modale Se connecter à un outil, sélectionnez Jira parmi la catégorie Plan.
      Module Applications
      1. Sélectionnez Applications (icône Applications)dans la navigation primaire.
      2. Sélectionnez une application existante ou créez-en une. Pour créer une application, reportez-vous à la section Créer une application : espace de travail.
      3. Dans le volet Actions recommandées, sélectionnez la carte Connecter un outil .
      4. Dans la fenêtre modale Se connecter à un outil, sélectionnez Jira parmi la catégorie Plan.
      Module Outils
      1. Sélectionnez Outils (icône Outils)dans la navigation primaire.
      2. Dans la liste des options, sélectionnez Planification.
      3. Sélectionnez Connecter un outil.
      4. Dans le modal Se connecter à un outil, sélectionnez Jira.
      Important :
      Si vous souhaitez détecter et suivre des objets d’outil tels que des plans lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application.
    2. Connectez-vous à votre serveur ou Jira à votre Jira instance de cloud.
      Jira Server
      1. Dans la liste Plateformes , sélectionnez Jira Server.
      2. Dans le champ Nom de l’outil, saisissez un nom pour l’outil.

        Ce nom est utilisé pour identifier votre Jira instance dans la liste des outils connectés à Vélocité de changement DevOps.

      Connectez-vous au serveur Jira.
      Jira Cloud
      1. Dans la liste Plateformes , sélectionnez Jira Cloud.
      2. Dans le champ Nom de l’outil, saisissez un nom pour l’outil.

        Ce nom est utilisé pour identifier votre Jira instance dans la liste des outils connectés à Vélocité de changement DevOps.

      Connectez-vous au cloud Jira.
    3. Sélectionnez Suivant.

      La page Playbook DevOps s’ouvre pour vous aider à terminer les tâches d’intégration.

    4. Terminez la connexion à votre Jira outil à l’aide du playbook.
      1. Entrez les détails de la connexion.
        Jira Server
        1. Entrez l’URL de votre Jira instance de serveur.
        2. Dans la liste Type d’informations d’identification , sélectionnez le type d’authentification que vous souhaitez utiliser pour vous connecter à votre Jira serveur.

          • Authentification de base

            1. Entrez votre nom d’utilisateur de serveur Jira .
              Remarque :
              L’utilisateur Jira que vous utilisez ici doit disposer Jira des autorisations Administrateurs.
            2. Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance.

            Saisissez les détails d’authentification de base du serveur Jira.

          • Clé API

            Entrez le jeton d’API pour accéder à l’instance.

            Saisissez le jeton d’API du serveur Jira.

        3. Si votre Jira instance est jointe à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.

          Pour plus d’informations sur le serveur MID, voir Sélection du serveur MID
        Jira Cloud
        1. Saisissez l’URL de votre Jira instance dans le cloud.
          Remarque :
          Si vous sélectionnez le type d’informations d’identification OAuth 2.0 avec 3LO à l’étape suivante, vous devez saisir l’URL de votre instance Jira au format suivant : 
          https://api.atlassian.com/ex/jira/<Cloud-ID>
          Pour en savoir plus sur l’obtention de la valeur de l’ID dans le cloud, reportez-vous à la section Obtain the value of Cloud ID.
        2. Sélectionnez le type d’informations d’identification Authentification de base ou OAuth 2.0 avec 3LO.

          Authentification de base

          1. Saisissez votre Jira nom d’utilisateur dans le cloud.
            Remarque :
            L’utilisateur Jira que vous utilisez ici doit disposer Jira des autorisations Administrateurs.
          2. Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance. Saisir les détails de l’instance Jira Cloud pour l’authentification de base

          OAuth 2.0 avec 3LO

          Conditions préalables :
          Sélectionnez un enregistrement d’informations d’identification OAuth 2.0 existant dans le champ Informations d’identification , ou sélectionnez Créer un enregistrement d’informations d’identification OAuth 2.0 pour créer un nouvel enregistrement. Pour obtenir des instructions sur la création d’un nouvel enregistrement d’informations d’identification, consultez Créer un enregistrement d’informations d’identification pour Jira Cloud.
          Remarque :
          • L’option de création d’un nouvel OAuth 2.0 ne sera disponible que si vous disposez du rôle administrateur de connexion et OAuth.
          • Seuls les enregistrements qui ne sont pas utilisés et configurés pour Jira Cloud peuvent être sélectionnés comme enregistrement d’informations d’identification existants.
          Saisir les détails de l’instance Jira Cloud pour l’authentification OAuth 2.0
        3. Si votre Jira instance est jointe à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.

          Pour plus d’informations sur le serveur MID, voir Sélection du serveur MID
      2. Sélectionnez Connexion.

        Si la connexion réussit, l’outil est créé dans et Vélocité de changement DevOps connecté à votre Jira instance.

      3. Les vérifications d’autorisation portent sur les informations d’identification que vous avez entrées.
        Les autorisations requises et les autorisations disponibles sont affichées. Si vous souhaitez entrer les informations d’identification avec de meilleures autorisations, sélectionnez Ressaisir les informations d’identification. Pour plus d’informations sur toutes les autorisations requises, consultez la section Autorisations Jira dans Autorisations requises pour les DevOps outils.

        Vous pouvez choisir de continuer la connexion de l’outil même si vous ne disposez pas de toutes les autorisations requises.

        Vérifications des autorisations pour la connexion à Jira.

      4. Sélectionnez Suivant.
    5. Spécifiez l’accès pour l’outil.
      1. Si vous souhaitez contrôler l’accès à l’outil, ajoutez les groupes qui doivent avoir accès à l’outil dans le champ Géré par .
        Les tâches que ces utilisateurs dans les groupes peuvent effectuer dépendent du rôle qui leur est affecté.
        • DevOps Rôle du propriétaire de l’outil : peut afficher et modifier l’outil.
        • DevOps Rôle du propriétaire de l’application : peut afficher l’outil et peut associer, détecter, importer des données historiques et modifier les étapes de pipeline (le cas échéant) des objets de l’outil (tels que les plans, les référentiels et les pipelines).
        • DevOps Rôle d’administrateur : peut modifier tous les outils.
        • Autres DevOps rôles : Peut afficher l’outil.
        Remarque :
        Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs ayant le rôle Propriétaire de l’outil DevOps pourront modifier l’outil.
      2. Si vous choisissez de contrôler l’accès à l’outil, l’option Tous les propriétaires d’applications peuvent afficher et associer des objets d’outil aux applications devient disponible pour la sélection.

        Cette option permet à tous les utilisateurs ayant le rôle de propriétaire d’application DevOps d’accéder à l’outil. S’ils sont sélectionnés, ils pourront afficher, associer, découvrir, importer des données historiques et modifier les étapes du pipeline (le cas échéant) des objets de l’outil.

      3. Sélectionnez Affecter.

        Spécifiez l’accès des outils.

    6. Pour envoyer des données en temps réel entre DevOps votre Jira instance, sélectionnez Configurer.
      Cette action effectue les opérations suivantes :
      • Enregistre un webhook entre vos Jira instances et ServiceNow permet le transfert de données en temps réel entre les deux.
      • Si vous avez connecté votre outil JIRA à l’aide de l’authentification basée sur OAuth 2.0, les webhooks sont créés pour l’application d’intégration OAuth 2.0 dans Jira lorsque vous configurez automatiquement, tandis que si vous vous êtes connecté à l’aide de l’authentification de base, les webhooks sont créés pour tous vos projets dans Jira. Si vous choisissez de configurer manuellement les webhooks d’un outil Jira créé à l’aide de l’authentification basée sur OAuth 2.0, un webhook en double peut être créé.

      Tous les projets détectés Jira sont répertoriés en tant que plans.

      Si vous ne choisissez pas de configurer maintenant, vous pouvez activer l’interrogation nocturne ultérieurement pour extraire les données de tous les plans suivis en définissant la Enable Polling propriété système sur Oui.

      Configurez l’instance Jira.

      Pour effectuer une configuration manuelle, sélectionnez Configurer manuellement. Consultez Configurer manuellement les webhooks Jira pour plus d'informations.

      Important :
      • Si vous vous connectez à partir de la page d’accueil ou du module Outils, la connexion est terminée et vous êtes redirigé vers la page Résumé.
      • Si vous vous connectez à partir du module Applications, les plans disponibles dans votre instance Jira sont détectés. Vous pouvez suivre et importer des données historiques à partir de ces données.
    7. Sélectionnez les plans à suivre.

      1. Sélectionnez les plans pour lesquels vous souhaitez suivre les mises à jour et associez-les à l’application.

        Une fois l’intégration de l’outil terminée, les éléments de travail uniquement pour ces plans sélectionnés sont automatiquement importés.

      2. Sélectionnez Suivant.

        Sélectionnez les plans de Jira à suivre.

      3. Si vous souhaitez importer des données de plan, sélectionnez la plage de dates, puis sélectionnez Soumettre.

        Vous pouvez importer jusqu’à 90 jours de données.

        Importez les données du plan.

    8. Sur la page Résumé , sélectionnez Afficher l’enregistrement de l’outil pour examiner les détails de l’instance connectée et les plans détectés à partir de celle-ci.

      Résumé de la connexion.

    Résultats

    Vous avez intégré votre Jira outil avec succès à Vélocité de changement DevOps.

    Que faire ensuite

    À partir de la page d’enregistrement de l’outil, vous pouvez :

    • Voir les détails et l’état de l’outil.
    • Détecter des plans et configurer des webhooks.
      Remarque :
      • Par défaut, les projets sont détectés dans un ensemble de 50 pour Jira le cloud. 50 est la limite maximale de pagination prise en charge par Jira. Si vous souhaitez réduire cette valeur, vous devez modifier la constante respective dans le script DevOpsCommonConstants.
      • Les données de projet et de version découvertes ne sont pas mises à jour ou suivies en temps réel.
    • Affectez des groupes pour contrôler l’accès à l’outil à l’aide du champ Géré par .
    • Vérifiez les autorisations des informations d’identification et mettez à jour les informations d’identification pour l’outil. Pour en savoir plus, consultez Vérifier les autorisations et mettre à jour les informations d’identification pour les outils : espace de travail.
    • Dans l’onglet Plans , sélectionnez un plan pour afficher ses détails, tels que les éléments de travail importés, les fonctionnalités et autres.
    • Pour importer des données historiques à partir des plans, associez les plans à une application et importez les données. Pour plus d'informations, consultez Associer des objets d’outil à des applications : espace de travail.
    Remarque :
    Il est recommandé de ne pas mettre à jour la clé de projet pour les projets dans Jira. Si la clé de projet est mise à jour, les noms d’objets mis à jour ne seront pas reflétés dans Vélocité de changement DevOps. Ce n’est que lorsque l’objet est mis à jour dans , que le nouveau nom est reflété dans JiraVélocité de changement DevOps.