Intégration à Jira Software Cloud

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 11 minutes de lecture

    • Vous pouvez intégrer votre ServiceNow instance à Atlassian Jira Software Cloud pour suivre vos abonnements logiciels et récupérer les licences inutilisées.

    Remarque :
    Actuellement, cette intégration ne prend en charge qu’une seule intégration de site par profil.

    Utilisation de l’authentification de base

    Intégrez l’instance ServiceNow et Jira utilisez une clé API pour authentifier les ServiceNow demandes.

    Vous pouvez intégrer une ServiceNow instance à plusieurs Jira instances. Pour cette intégration, créez un enregistrement d’alias de connexion et d’informations d’identification et un enregistrement de connexion pour chaque Jira instance.

    Créer un compte Jeton d’API Jira

    Créez un jeton d’API pour Jira authentifier les demandes.

    Avant de commencer

    Jira Rôle requis : admin

    Procédure

    1. Accédez aux jetons d’API Atlassian.
    2. Cliquez sur Créer un jeton d’API.
    3. Saisissez un nom pour votre jeton d’API, puis cliquez sur Créer.
    4. Copiez le jeton d’API et enregistrez-le.
      Vous utiliserez le jeton plus tard.

    Configurer l’enregistrement de connexion et d’informations d’identification

    Configurez l’enregistrement d’alias de connexion et d’informations d’identification par défaut pour authentifier les demandes à partir de ServiceNow.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvrez l’enregistrement d’alias Jira fourni avec le spoke.
    3. Cliquez sur le lien connexe Créer une nouvelle connexion et de nouvelles informations d’identification .
    4. Renseignez les champs du formulaire.
      Tableau 1. Créer une connexion et des informations d'identification
      Champ Description
      URL de connexion URL de votre Jira instance au format https://<nom-domaine-fournisseur>.atlassian.net  ;.
      Nom d'utilisateur Entrez l’adresse e-mail de l’utilisateur.
      Clé API Saisissez le jeton d’API que vous avez généré pour Jira.
    5. Cliquez sur Créer.

    Utilisation de l’authentification OAuth

    Intégrez l’instance ServiceNow à votre Jira compte à l’aide d’OAuth pour authentifier ServiceNow les demandes.

    Créer une intégration OAuth 2.0 dans le Jira compte

    Créez une intégration OAuth 2.0 dans la Atlassian console développeur pour authentifier les demandes.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Connectez-vous à Atlassian Developer Console.
    2. Sous Mes applications, cliquez sur Créer et sélectionnez Intégration OAuth 2.0.
    3. Sur le formulaire, fournissez un nom pour l’intégration et cliquez sur Créer.

      L’intégration est créée et la valeur de l’ID d’application s’affiche.

    4. Cliquez sur Autorisation.
      1. Cliquez sur Ajouter sous Action.
      2. Dans URL de rappel, fournissez l’URL de votre instance ServiceNow au format suivant : https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do.
        Par exemple, https://example.service-now.com/oauth_redirect.do.
      3. Cliquez sur Enregistrer les changements.
    5. Cliquez sur Paramètres.
    6. Sous Détails d’authentification, copiez les valeurs ID client et Secret client.
    7. Cliquez sur Autorisations.
      1. Dans Champs d’application granulaires, sélectionnez les champs d’application suivants.
        • lire :rôle-application :jira
        • Lire :Groupe :Jira
        • Lire :Utilisateur :Jira
        • lire :avatar :jira
        • lire :journal d’audit :jira
        • lire :détails-problème :jira
        • lecture :configuration-champ :jira
        • lire :problème-meta :jira
        • write :group :jira
        Vous pouvez configurer d’autres périmètres en fonction de vos besoins.

    Obtenir la valeur de Cloud ID

    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

    1. Connectez-vous à l’administration Atlassian.
    2. Cliquez sur Sélectionner en regard de l’organisation requise.
    3. À partir du Jira produit logiciel, cliquez sur Gérer l’accès au produit.

      L’URL est au format suivant dans une nouvelle fenêtre : https://admin.atlassian.com/s/<Cloud-ID>/apps.

    4. Copiez la valeur de l’ID dans le cloud pour une utilisation ultérieure.

    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

    1. Accédez à la Tous > OAuth système > Registre d'application.
    2. Cliquez sur Nouveau.
      Le système affiche le message What kind of OAuth application ?.
    3. Sélectionnez Se connecter à un fournisseur OAuth tiers.
    4. Renseignez ces valeurs sur le formulaire.
      Tableau 2. Registres d'application
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement du registre d’application.
      ID client ID client généré lors de la création de l’intégration OAuth 2.0 dans Developer Atlassian Console.
      Secret client Secret client généré lors de la création de l’intégration OAuth 2.0 dans Developer Atlassian Console.
      Type d'accord par défaut Type d'accord utilisé pour établir le jeton. Sélectionnez Code d’autorisation.
      URL d'autorisation Point de terminaison du code d'autorisation OAuth. Saisissez https://auth.atlassian.com/authorize.
      URL de jeton Point de terminaison de jeton du serveur OAuth. Saisissez https://auth.atlassian.com/oauth/token.
      URL de redirection Point de terminaison de rappel OAuth. Le système génère l’URL lors de l’enregistrement du registre d’application.
      Actualiser l'URL du jeton URL permettant d’actualiser un jeton. Saisissez https://auth.atlassian.com/oauth/token.
      Remarque :
      Ce champ est masqué dans la mise en page du formulaire. Configurez la mise en page du formulaire pour afficher ce champ.
    5. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
      Un enregistrement de profil d’entité OAuth par défaut est créé dans l’onglet Profils des entités OAuth .
    6. Dans les périmètres des entités OAuth, créez les enregistrements de périmètre d’entité suivants.
      Nom Périmètre OAuth
      lire :rôle-application :jira lire :rôle-application :jira
      Lire :Groupe :Jira Lire :Groupe :Jira
      Lire :Utilisateur :Jira Lire :Utilisateur :Jira
      lire :avatar :jira lire :avatar :jira
      lire :journal d’audit :jira lire :journal d’audit :jira
      lire :détails-problème :jira lire :détails-problème :jira
      lecture :configuration-champ :jira lecture :configuration-champ :jira
      lire :problème-meta :jira lire :problème-meta :jira
      write :group :jira write :group :jira
      offline_access offline_access

    Résultats

    Un enregistrement de registre d’application est créé dans votre ServiceNow instance.

    Créer un enregistrement d’informations d’identification pour Jira

    Créez un enregistrement d’informations d’identification pour le Jira compte. L’alias Jira de connexion et d’informations d’identification du spoke utilise ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Connexions et informations d'identification > Identifiants.
    2. Cliquez sur Nouveau.
      Le système affiche un message sous la forme Quel type d’informations d’identification voulez-vous créer ?.
    3. Sélectionnez Informations d'identification OAuth 2.0.
    4. Renseignez ces valeurs sur le formulaire.
      Tableau 3. Informations d'identification OAuth 2.0
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement d’informations d’identification du Jira spoke. Par exemple, les informations d’identification Jira OAuth.
      Profil de l'entité OAuth Enregistrement de profil d’entité OAuth par défaut créé lors de la configuration de l’enregistrement du registre d’application.
    5. Cliquez sur Envoyer.

    Créer un enregistrement de connexion pour Jira

    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

    1. Accédez à la Tous > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvrez l’enregistrement d’alias Jira fourni avec le spoke.
    3. Dans l’onglet Connexions , sélectionnez Nouveau.
      Le système affiche un formulaire de connexion HTTP(s) vide.
    4. Renseignez ces champs du formulaire.
      Tableau 4. Connexion HTTP(S)
      Champ Description
      Nom Saisissez un nom unique pour identifier l’enregistrement de connexion. Par exemple, entrez Jira Connexion OAuth.
      Informations d'identification Sélectionnez l’enregistrement d’informations d’identification créé pour Jira. Par exemple, sélectionnez Jira Informations d’identification OAuth.
      Alias de connexion Recherchez et sélectionnez sn_jira_spoke. Alias Jira .
      URL de connexion Entrez l’URL de votre Jira instance au format https://api.atlassian.com/ex/jira/<Cloud-ID >.

      Pour en savoir plus sur l’obtention de la valeur de Cloud ID, reportez-vous à la section Obtenir la valeur de Cloud ID.
    5. Dans la liste connexe Attributs, fournissez les valeurs suivantes.
      1. Saisissez la valeur 2 pour api_version.
      2. Saisissez la valeur cloud pour server_type.
    6. Sélectionnez Envoyer.
    7. Accédez à la Tous > Connexions et informations d'identification > Identifiants.
    8. Ouvrez l’enregistrement d’informations d’identification que vous avez créé pour le Jira spoke.
      Par exemple, Jira les informations d’identification OAuth.
    9. Sélectionnez le lien connexe Obtenir un jeton OAuth.
      Dans une nouvelle fenêtre, le système demande l’accès à votre Atlassian compte.
    10. Sélectionnez Accepter.
      L’accès est accordé au compte et un message de confirmation s’affiche Atlassian dans votre ServiceNow instance indiquant que le jeton d’actualisation est disponible.

    Créer un profil d’intégration Jira Software Cloud

    Créez un profil d’intégration pour suivre les abonnements logiciels et optimiser la gestion des licences pour Atlassian Jira Software Cloud.

    Avant de commencer

    Pour créer un profil d’intégration Jira , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (com.sn_sam_saas_int) à partir de ServiceNow Store.

    Pour permettre au profil d’intégration de récupérer et de mettre à jour l’activité de l’utilisateur via le flux secondaire Mettre à jour l’activité de l’utilisateurJira, définissez la valeur de la com.glide.transform.json.max-partial-length propriété système sur 32768.

    Atlassian Rôle requis : administrateur du site

    ServiceNow Rôle requis :

    • À partir de la version 5.0.1 de - Gestion des licences SaaS et de Gestion des actifs logiciels la Jira version 3.0.4 du spoke, le rôle suivant ServiceNow est requis : sam_integrator et sn_jira_spoke.jira_admin ou admin.

    • Avant la version 5.0.1 de Gestion des actifs logiciels - Gestion des licences SaaS et la Jira version 3.0.4 du spoke, le rôle suivant ServiceNow est requis : sam_integrator ou admin

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option permettant de créer le profil d’intégration dans l’interface Jira utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Profil d’intégration Jira.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Jira dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 5. Formulaire Profil d’intégration
      Champ Valeur
      Nom d'affichage Nom de votre choix. Par exemple, Jira intégration.
      Connexion et information d'identification sn_jira_spoke. Jira. Ce champ est automatiquement renseigné.
      Statut État du profil d'intégration. Les options disponibles sont Brouillon et Publié. Ce champ est automatiquement renseigné.
      Type de profil Jira Abonnement. Ce champ est automatiquement renseigné.
    3. Dans la section de formulaire Calculer le flux secondaire d’activité , choisissez une valeur pour le champ Analyser l’activité de l’utilisateur à partir de .
      Vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité de l’utilisateur dans le champ Analyser l’activité de l’utilisateur à partir de. Par défaut, vous pouvez analyser l’activité des utilisateurs jusqu’à 60 jours avant la date actuelle et afficher les événements effectués par des utilisateurs individuels à partir du moment où vous créez ce profil.
      Remarque :
      Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à analyser l’activité de l’utilisateur, quelle que soit la date de création du profil.
      Vous pouvez modifier cette valeur dans le champ Seuil de la dernière activité de vos règles de réclamation de logiciels. Pour plus d'informations, consultez Réviser une règle de réclamation logicielle.
      Remarque :
      Une fois le profil d’intégration enregistré, le champ Analyser l’activité de l’utilisateur à partir de passe en lecture seule.
    4. Cliquez sur Enregistrer.
      Une ébauche de profil d’intégration est créée. Le profil d’intégration utilise les flux secondaires Télécharger les abonnements, Jira Mettre à jour l’activité Jira de l’utilisateur et Jira Récupérer l’abonnement pour obtenir les données utilisateur à partir de l’application logicielleJira.
    5. Spécifiez les groupes qui ont accès aux Jira produits.
      Important :
      Cette étape s’applique uniquement à partir de la version 5.0.1 de Gestion des actifs logiciels - Gestion des licences SaaS Intégrations et de la Jira version 3.0.4 du spoke.
      En spécifiant ces groupes sur votre ServiceNow instance, vous pouvez récupérer des données et gérer les licences uniquement pour les utilisateurs au sein de ces groupes.
      1. Dans un nouvel onglet, ouvrez le portail d’administration Atlassian.
      2. Connectez-vous à votre compte administrateur de site.
      3. Accédez à la PARAMÈTRES DU SITE > Accès au produit.
      4. Dans la Jira section, affichez la liste des groupes ayant accès au Jira logiciel.
        Prenez note de ces informations pour une utilisation ultérieure.
      5. Retournez à votre ServiceNow instance et accédez à Jira > Groupes Jira.
      6. Sur le Jira formulaire Groupes, cliquez sur le lien connexe Ajouter des groupes .
        La boîte de dialogue Ajouter Jira des groupes s’ouvre.
      7. Dans la liste Disponible, sélectionnez les groupes ayant accès aux Jira produits.
        Conseil :
        La liste Disponible comprend tous les groupes associés à votre Atlassian compte. Sélectionnez uniquement les groupes qui ont accès aux Jira produits.
      8. Cliquez sur la flèche vers la droite pour déplacer les groupes de la liste Disponible vers la liste Sélectionné.
      9. Cliquez sur OK.
    6. Revenez à votre profil d’intégration en accédant à Licence SaaS > Administration > Profils d'intégration directe , puis en sélectionnant le profil dans la liste Profils d’intégration.
    7. Cliquez sur Publier.
      La boîte de dialogue Publier la confirmation s’ouvre.
    8. Dans la boîte de dialogue, cliquez sur OK.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements utilisateur, qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser une règle de réclamation logicielle.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre le logiciel utilisé par rapport au logiciel possédé.
    Le rapprochement s’exécute également sur vos abonnements sous la forme d’une tâche planifiée ou à la demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position de conformité de licence et pour corriger toute non-conformité.