Configurer le spoke pour Jira le Jira cloud

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Intégrez votre ServiceNow instance à l’instanceJira Cloud pour authentifier les demandes provenant de ServiceNow.

    Avant de commencer

    • Demander un Hub d'intégration abonnement
    • Activer le spoke Jira
    • Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    Vous pouvez configurer le spoke de votre Jira instance dans le cloud à l’aide de l’authentification Jira de base ou de l’authentification OAuth selon vos besoins.

    Option 1 : Utilisation de l’authentification de base

    Intégrez l’instance et Jira l’instance dans le cloud à l’aide d’une clé API pour authentifier ServiceNow les ServiceNow demandes.

    Avant de commencer

    Rôle requis : admin.

    Pourquoi et quand exécuter cette tâche

    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.

    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 d’administrateur

    Pourquoi et quand exécuter cette tâche

    Suivez ces étapes à partir de votre Atlassian compte. Consultez la documentation du portail Atlassian Developer pour obtenir des instructions sur la génération de votre jeton d’API.
    Remarque :
    Cette procédure ne s’applique que si vous utilisez l’abonnement Jira Cloud .

    Procédure

    1. Connectez-vous à Atlassian Début en tant qu’administrateur.
    2. Accédez à la photo de profil de votre compte et sélectionnez Paramètres du compte.
      Page d’accueil Atlassian avec le menu déroulant de la photo de profil sélectionnée. Option Paramètres du compte mise en avant.
    3. Accédez à Sécurité.
    4. Dans la section Jeton d’API, sélectionnez Créer et gérer des jetons d’API.
    5. Sélectionnez un jeton d’API.
    6. Sur le formulaire, fournissez un nom d’intégration pour le champ Étiquette .
    7. Sélectionnez Créer.
      Le modal Créer un jeton d’API avec le bouton Créer mis en évidence.
      Le jeton d’API est généré.
    8. Sélectionnez Copier et enregistrez la valeur du jeton d’API pour une utilisation ultérieure.
      Modal de confirmation de votre nouveau jeton API avec le bouton Copier mis en surbrillance.

    Que faire ensuite

    Utilisez votre jeton d’API pour configurer la connexion au cloud pour un spoke Jira ou Jira Service Management.

    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 : administrateur

    Procédure

    1. Accédez à la Automatisation des processus > Concepteur de flux.
    2. Cliquez sur l’onglet Connexions .
    3. Localisez l’alias de connexion Jira et cliquez sur Afficher les détails.
      • Pour configurer l’enregistrement d’alias de connexion et d’informations d’identification par défaut fourni avec le spoke Jira, cliquez sur Afficher les détails.
      • Pour gérer plusieurs enregistrements de connexion de spoke Jira, vous devez créer un nouvel enregistrement d’alias enfant en cliquant sur Ajouter une connexion. Pour plus d’informations sur l’utilisation de plusieurs connexions, reportez-vous à la section Prise en charge de plusieurs connexions.
      Si vous configurez le spoke pour la première fois, cliquez sur Configurer. Sinon, cliquez sur Modifier.
    4. Renseignez les champs du formulaire Connexion .
      Champ Description
      Nom de la connexion Nom permettant d’identifier la connexion de façon unique. Par exemple, connexion de base cloud spoke Jira.
      URL de connexion URL de votre instance Jira au format suivant : https://<nom-domaine-fournisseur>.atlassian.net.
      Type de serveur Sélectionnez le cloud.
      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 votre instance Jira Cloud.

      Configuration de la connexion pour Jira Cloud.

    5. Cliquez sur Créer une connexion.

    Option 2 : utilisation de l’authentification OAuth

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

    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 Atlassian la console développeur pour authentifier les demandes.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Connectez-vous à Atlassian Console développeur en tant qu’administrateur.
    2. Sous My apps (Mes applications), cliquez sur Create (Créer ) et sélectionnez OAuth 2.0 integration (Intégration OAuth 2.0).
      Créez une intégration OAuth 2.0.
    3. Sur le formulaire, indiquez le nom de l’intégration et cliquez sur Créer.
      Fournissez un nom d’intégration.
      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.
        Autorisation d’accès aux API.
      2. Dans URL de rappel, fournissez 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
        Ajouter une URL de rappel.
      3. Cliquez sur Enregistrer les changements.
    5. Cliquez sur Paramètres.

      Sous Détails de l’authentification, copiez les valeurs ID client et Secret client.

      Copiez les valeurs ID client et Secret client.
    6. Cliquez sur Autorisations.
      1. Dans les champs d’application classiques, assurez-vous de sélectionner ces champs d’application.
        • gérer :jira-configuration
        • Gérer :jira-project
        • Gérer :Jira-Webhook
        • Lire :jira-work
        • lire :jira-user
        • écrire :jira-work
      2. Dans Champs d’application granulaires, assurez-vous de sélectionner ces champs d’application.
        • delete :sprint :jira-software
        • Lire :Détails-du-problème :Jira
        • Lire :JQL :Jira
        • read :sprint :jira-software
        • write :sprint :jira-software
        • lecture :périmètre du tableau :jira-software
        • Lire :Projet :Jira
      Vous pouvez configurer d’autres champs d’application selon vos besoins.

    Obtenir la valeur de Cloud ID

    Obtenir la valeur de l’ID Cloud de l’instance 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 : administrateur

    Procédure

    1. Connectez-vous à Atlassian Administration en tant qu’administrateur.
    2. Cliquez sur Sélectionner en regard de l’organisation requise.
    3. Depuis le produit Jira Software , cliquez sur Gérer l’accès au produit.
      Une nouvelle fenêtre s’ouvre et l’URL est au format suivant : 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 : administrateur

    Procédure

    1. Accédez à la Tout > OAuth système > Registre d'application.
    2. Cliquez sur Nouveau.
      Le système affiche le message Quel type d’application OAuth ?
    3. Sélectionnez Se connecter à un fournisseur OAuth tiers.
    4. Renseignez ces valeurs sur le formulaire.
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement du registre d’application. Par exemple, le registre d’applications OAuth dans le cloud Jira.
      ID client ID client généré lors de la création de l’intégration OAuth 2.0 dans Atlassian la console développeur.
      Secret client Secret client généré lors de la création de l’intégration OAuth 2.0 dans Atlassian la console développeur.
      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. Entrez : https://auth.atlassian.com/authorize.
      URL de jeton Point de terminaison de jeton du serveur OAuth. Entrez : 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. Entrez : 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. Dans l’onglet Périmètres de l’entité OAuth , créez ces enregistrements de périmètres de l’entité.
      Nom Périmètre OAuth
      delete :sprint :jira-software delete :sprint :jira-software
      gérer :jira-configuration gérer :jira-configuration
      Gérer :jira-project Gérer :jira-project
      Gérer :Jira-Webhook Gérer :Jira-Webhook
      offline_access offline_access
      Lire :Détails-du-problème :Jira Lire :Détails-du-problème :Jira
      lire :jira-user lire :jira-user
      Lire :jira-work Lire :jira-work
      Lire :JQL :Jira Lire :JQL :Jira
      read :sprint :jira-software read :sprint :jira-software
      écrire :jira-work écrire :jira-work
      write :sprint :jira-software write :sprint :jira-software
      lecture :périmètre du tableau :jira-software lecture :périmètre du tableau :jira-software
      Lire :Projet :Jira Lire :Projet :Jira
    6. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    7. Cliquez sur l’onglet Profils des entités OAuth et ouvrez l’enregistrement par défaut.
      Par exemple, Profil OAuth Jira.
    8. Dans les périmètres des profils d’entité OAuth, assurez-vous que les mêmes périmètres d’entité sont fournis.
      Sinon, insérez de nouvelles lignes et sélectionnez les mêmes périmètres d’entité que ceux que vous avez fournis précédemment dans l’onglet Périmètres de l’entité OAuth .
    9. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.

    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 : administrateur

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.
      Le système affiche le message 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.
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement d’informations d’identification pour le Jira spoke. Par exemple, les informations d’identification OAuth du cloud Jira.
      Profil de l'entité OAuth Enregistrement de profil d’entité OAuth par défaut créé lorsque l’enregistrement du registre d’application est configuré.
    5. Cliquez sur Envoyer.

    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

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvrez l’enregistrement d’alias pour Jira fourni avec le spoke.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
      Le système affiche un formulaire de connexion HTTP(s) vide.
    4. Entrez ces valeurs et cliquez sur Soumettre.
      Champ Valeur requise
      Nom Saisissez un nom pour identifier de façon unique l’enregistrement de connexion. Par exemple, saisissez Connexion OAuth au cloud Jira.
      Informations d'identification Sélectionnez l’enregistrement d’informations d’identification créé pour Jira. Par exemple, sélectionnez Informations d’identification OAuth dans le cloud Jira.
      URL de connexion Saisissez 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 Cloud ID, reportez-vous à la section Obtenir la valeur de Cloud ID.
    5. Dans la liste connexe Attributs, fournissez ces valeurs.
      1. Entrez la valeur 2 pour api_version.
      2. Saisissez le cloud de valeurs pour server_type.
      Valeurs d’attributs.
    6. Cliquez sur Envoyer.
    7. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    8. Ouvrez l’enregistrement d’informations d’identification que vous avez créé pour le Jira spoke.
      Par exemple, les informations d’identification Jira OAuth.
    9. Cliquez sur le lien connexe Obtenir un jeton OAuth.
      Dans une nouvelle fenêtre, le système demande l’accès à votre Atlassian compte.
    10. Cliquez sur Accepter.
      L’accès est accordé au Atlassian compte et un message de confirmation s’affiche dans votre ServiceNow instance pour indiquer que le jeton d’actualisation est disponible.