Intégration dans Jira Software Cloud

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 9 minutes de lecture

    • L’intégration de votre Gestion des actifs logiciels application à Atlassian Jira Software Cloud vous permet de suivre vos abonnements logiciels et de 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.
    Important :
    Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application Jira Software Cloud Périmètres d’authentification
    Télécharger les abonnements Autorisation d’accès Jira
    • Lecture :application-role :Jira
    • Lire :Groupe :Jira
    • Lire :Utilisateur :Jira
    • Lire :avatar :Jira
    Pull user activity (Transférer l’activité utilisateur)
    • Administrer l’autorisation Jira globale
    • Parcourir les projets Autorisation pour le projet contenant le problème.

      Si la sécurité au niveau du problème est configurée, autorisation de sécurité au niveau du problème d’afficher le problème.
    • Lire :Utilisateur :Jira
    • Lire :Détails du problème :Jira
    • Lire :Audit-Log :Jira
    • Lire :avatar :Jira
    • Lecture :field-configuration :Jira
    • Lire :Problème-Meta :Jira
    Récupérer l'abonnement Administration du site, c’est-à-dire membre du groupe site-admin
    • Lire :Groupe :Jira
    • Écriture :Groupe :Jira

    Utilisation d’une authentification de base

    Intégrez l’application Gestion des actifs logiciels et Jira utilisez une clé API pour authentifier les demandes ServiceNow .

    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 jeton d’API Jira de compte

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

    Avant de commencer

    Jira Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. Accédez aux jetons d’API Atlassian.
    2. Sélectionnez Créer un jeton d’API.
    3. Saisissez un nom pour votre jeton d’API, puis sélectionnez 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 à partir duquel authentifier les demandes à partir de ServiceNow.

    Avant de commencer

    Rôle requis : admin

    Procédure

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

    Utilisation de l’authentification OAuth

    Intégrez l’application Gestion des actifs logiciels à votre compte à l’aide Jira d’OAuth pour authentifier les demandes ServiceNow .

    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

    Jira Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

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

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

    4. Sélectionnez Autorisation.
      1. Sélectionnez Ajouter sous Action.
      2. 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.
      3. Sélectionnez Enregistrer les modifications.
    5. Sélectionnez Paramètres.
    6. Sous Détails d’authentification, copiez les valeurs ID client et Secret client.
    7. Sélectionner Autorisations > Jira API > Configurer.
    8. Sélectionnez l’onglet Champs d’application granulaires .
    9. Sélectionnez Modifier les champs d’application pour ajouter les champs d’application suivants :
      • Lecture :application-role :Jira
      • Lire :Groupe :Jira
      • Lire :Utilisateur :Jira
      • Lire :avatar :Jira
      • Lire :Audit-Log :Jira
      • Lire :Détails du problème :Jira
      • Lecture :field-configuration :Jira
      • Lire :Problème-Meta :Jira
      • Écriture :Groupe :Jira
      Vous pouvez configurer d’autres champs d’application en fonction de vos besoins.

    Obtenir la valeur de l’ID dans le cloud de l’instance Jira

    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

    Jira Rôle requis : admin

    Procédure

    1. Connectez-vous à l’administration Atlassian.
    2. Sélectionnez le bouton Sélectionner en regard de l’organisation requise.
    3. Sélectionnez l’onglet Produits .
    4. Sur la page Produits, sélectionnez Gérer le produit sur la ligne du Jira produit.

      L’URL est au format suivant dans une nouvelle fenêtre : https://admin.atlassian.com/o/<orgID>/products/jira-software/<Cloud-Id>.

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

    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, demandez le module d’extension JiraGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès 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é Jira de l’utilisateur, définissez la valeur de propriété com.glide.transform.json.max-partial-length système sur 32768.

    Atlassian Rôle requis : administrateur de site

    ServiceNow Rôle requis : admin ou sam_integrator

    Important :
    Vous devez cocher la case Spoke Jira pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option de création du profil d’intégration Jira dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le 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 3. Formulaire Profil d’intégration
      Champ Valeur
      Nom d'affichage Nom de votre choix. Par exemple, Jira l’intégration.
      Statut État du profil d'intégration.
      • Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon.
      • Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
      Type de profil Jira Abonnement. Ce champ est automatiquement renseigné.
    3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
      Remarque :
      Pour plus d’informations, consultez Table des autorisations utilisateur minimales .
      1. Dans la section Flux secondaire d’abonnement de téléchargement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement Jira.
        Remarque :
        La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
      2. Dans la section Calculer le flux secondaire de l’activité, vérifiez que le champ Flux secondaire est défini sur Jira Mettre à jour l’activité de l’utilisateur.
        Remarque :
        La case Télécharger l’activité est cochée par défaut. Si vous l’effacez, la tâche SAM - Refresh <displayname> Activity planifiée d’activité n’est pas créée.
        Dans le champ Analyser l’activité utilisateur , vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité utilisateur. 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 logiciel. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.
      3. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement de récupération Jira.
        Remarque :
        La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
    4. Sélectionnez Enregistrer.
      Une ébauche de profil d’intégration est créée.

      Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_jira_spoke. Jira.

    5. Spécifiez les groupes qui ont accès aux Jira produits.
      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. Sélectionnez le bouton Sélectionner en regard de l’organisation requise.
      4. Sélectionnez l’onglet Produits .
      5. Sur la page Produits, sélectionnez Gérer le produit sur la ligne du Jira produit.
      6. Affichez la liste des groupes ayant accès aux Jira logiciels.
        Prenez note de ces informations pour une utilisation ultérieure.
      7. Retournez à votre ServiceNow instance et accédez à Jira > Groupes Jira.
      8. Dans le Jira formulaire Groupes, sélectionnez le lien connexe Ajouter des groupes .
        La boîte de dialogue Ajouter Jira des groupes s’ouvre.
      9. Dans la liste Disponible, sélectionnez les groupes qui ont accès aux Jira produits.
        Conseil :
        La liste Disponible inclut tous les groupes associés à votre Atlassian compte. Sélectionnez uniquement les groupes qui ont accès aux Jira produits.
      10. Sélectionnez le bouton flèche vers la droite pour déplacer les groupes de la liste Disponible vers la liste Sélectionné.
      11. Sélectionnez OK.
    6. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

      La validation de la connexion vérifie les API Télécharger les abonnements et Calculer l’activité, mais pas les API Récupérer les abonnements.

    7. Une fois la connexion vérifiée, sélectionnez Publier.
    8. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.
      Remarque :
      Si vous décochez la case Télécharger l’activité après la publication du profil d’intégration, vous devez revalider les connexions, puis republier le profil d’intégration, car les événements suivants se produisent :
      • Le champ État du formulaire de profil d’intégration devient Brouillon.
      • Le bouton Valider la connexion s’affiche sur le formulaire.
      • La tâche actuelle SAM - Refresh <displayname> Activity est supprimée.

    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 logiciels qui sont actualisés quotidiennement.

    Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créer un alias enfant pour configurer plusieurs profils d’intégration.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

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