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 Hub 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

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

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 de l’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. Connexion à Atlassian Début en tant qu’administrateur.
2. Accédez à la photo de profil de votre compte et sélectionnez Paramètres du compte.

   

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 jeton d’API est généré.
8. Sélectionnez Copier et enregistrez la valeur du jeton d’API pour une utilisation ultérieure.

   

Que faire ensuite

Utilisez votre jeton d’API pour configurer la connexion dans le cloud d’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 : admin

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 connexions multiples, 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, 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.

   

5. Cliquez sur Créer une connexion.

Option 2 : 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

1. Connexion à Atlassian Developer Console en tant qu’administrateur.
2. Sous Mes applications, cliquez sur Créer et sélectionnez Intégration OAuth 2.0.

   

3. 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.
4. Cliquez sur Autorisation.
   1. Cliquez sur 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. Cliquez sur Enregistrer les changements.
5. Cliquez sur Paramètres.

   Sous Détails d’authentification, 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 :configuration Jira
      • Gérer :JIRA-PROJECT
      • Gérer :jira-webhook
      • Lire :Jira-travail
      • Lire :Jira-user
      • Écrire :Jira-travail
   2. Dans Champs d’application granulaires, assurez-vous de sélectionner ces champs d’application.
      • Supprimer :sprint :Jira-software
      • Lire :Détails du problème :Jira
      • Lire :jql :jira
      • Lecture :Sprint :Jira-software
      • write :sprint :jira-software
      • Lecture :board-scope :jira-software
      • Lire :Projet :Jira
   Vous pouvez configurer d’autres champs d’application selon vos besoins.

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

1. Connexion à 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 : admin

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 d’actualisation d’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 des entités OAuth , créez ces enregistrements de périmètre d’entité.

   Nom	Périmètre OAuth
   Supprimer :sprint :Jira-software	Supprimer :sprint :Jira-software
   Gérer :configuration Jira	Gérer :configuration Jira
   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-travail	Lire :Jira-travail
   Lire :jql :jira	Lire :jql :jira
   Lecture :Sprint :Jira-software	Lecture :Sprint :Jira-software
   Écrire :Jira-travail	Écrire :Jira-travail
   write :sprint :jira-software	write :sprint :jira-software
   Lecture :board-scope :jira-software	Lecture :board-scope :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 champs d’application d’entité que ceux fournis précédemment dans l’onglet Champs d’application des entités 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 : admin

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 Jira Cloud OAuth.
   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 qui a été livré avec le spoke.
3. Dans l’onglet Connexions , cliquez sur Nouveau.
   Le système affiche un formulaire de connexion HTTP(s) vide.
4. Saisissez ces valeurs et cliquez sur Soumettre.

   Champ	Valeur requise
   Nom	Entrez un nom pour identifier de façon unique l’enregistrement de connexion. Par exemple, saisissez Connexion Jira Cloud OAuth.
   Information d'identification	Sélectionnez l’enregistrement d’informations d’identification créé pour Jira. Par exemple, sélectionnez les informations d’identification Jira Cloud OAuth.
   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 l’ID dans le cloud, reportez-vous à la section Obtenir la valeur de l’ID dans le cloud.

5. Dans la liste connexe Attributs, fournissez ces valeurs.
   1. Entrez la valeur 2 pour api_version.
   2. Entrez le cloud de valeurs pour server_type.
   
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 le 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 indiquant que le jeton d’actualisation est disponible.