Configurer le spoke pour Jira le Jira cloud

Washington DC : créer des intégrations pour les applications

Release

washingtondc

ft:locale

fr-FR

ft:publication_title

Washington DC : créer des intégrations pour les applications

ft:clusterId

crint

bundleId

crint

workflow

Creator

Configurer le spoke pour Jira le Jira cloud

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

7 minutes de lecture

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

Avant de commencer

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

Pourquoi et quand exécuter cette tâche

Vous pouvez configurer le spoke pour votre Jira instance 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 les ServiceNowServiceNow 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 de l’administrateur

Pourquoi et quand exécuter cette tâche

Effectuez ces étapes à partir de votre Atlassian compte. Consultez la documentation du portail Atlassian Developer pour savoir comment générer votre jeton d’API.

Remarque :

Cette procédure ne s’applique que si vous utilisez l’abonnement Jira Cloud .

Procédure

Connectez-vous à Atlassian Début en tant qu’administrateur.
Accédez à la photo de profil de votre compte et sélectionnez Paramètres du compte.
Accédez à Sécurité.
Dans la section Jeton d’API, sélectionnez Créer et gérer des jetons d’API.
Sélectionnez un jeton d’API.
Sur le formulaire, fournissez un nom d’intégration pour le champ Étiquette .
Sélectionnez Créer.

Le jeton d’API est généré.
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 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 : admin

Procédure

Accédez à la Automatisation des processus > Concepteur de flux.
Cliquez sur l’onglet Connexions .
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 à Prise en charge de plusieurs connexions.
Si vous configurez le spoke pour la première fois, cliquez sur Configurer. Sinon, cliquez sur Modifier.

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://<nom-domaine-fournisseur>.atlassian.net`.
Type de serveur	Sélectionnez 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.

Cliquez sur Créer une connexion.

Option 2 : utilisation de l’authentification OAuth

Intégrez l’instance ServiceNow à votre Jira compte à l’aide d’OAuth pour authentifier ServiceNow les 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 : admin

Procédure

Connectez-vous à Atlassian Console développeur en tant qu’administrateur.
Sous Mes applications, cliquez sur Créer et sélectionnez Intégration OAuth 2.0.
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.
Cliquez sur Autorisation.
1. Cliquez sur Ajouter sous Action.
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
3. Cliquez sur Enregistrer les changements.
Cliquez sur Paramètres.

Sous Détails d’authentification, copiez les valeurs ID client et Secret client.
Cliquez sur Autorisations.
1. Dans 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 :utilisateur jira
  - É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-problème :jira
  - lire :jql :jira
  - lire :sprint :logiciel jira
  - write :sprint :jira-software
Vous pouvez configurer d’autres périmètres en fonction de vos besoins.

Obtenir la valeur de Cloud ID

Obtenir 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

Connectez-vous à Atlassian Administration en tant qu’administrateur.
Cliquez sur Sélectionner en regard de l’organisation requise.
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.
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

Accédez à la Tout > OAuth système > Registre d'application.
Cliquez sur Nouveau.
Le système affiche le message What kind of OAuth application ?.
Sélectionnez Se connecter à un fournisseur OAuth tiers.

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 Jira Cloud`.
ID client	ID client généré lors de la création de l’intégration OAuth 2.0 dans Atlassian Developer Console.
Secret client	Secret client généré lors de la création de l’intégration OAuth 2.0 dans Atlassian Developer 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. 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.

Dans l’onglet Périmètres des entités OAuth , créez ces enregistrements de périmètres d’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-problème :jira`	`lire :détails-problème :jira`
`lire :utilisateur jira`	`lire :utilisateur jira`
`Lire :jira-work`	`Lire :jira-work`
`lire :jql :jira`	`lire :jql :jira`
`lire :sprint :logiciel jira`	`lire :sprint :logiciel jira`
`Écrire :jira-work`	`Écrire :jira-work`
`write :sprint :jira-software`	`write :sprint :jira-software`

Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Cliquez sur l’onglet Profils des entités OAuth et ouvrez l’enregistrement par défaut.
Par exemple, Profil OAuth Jira.
Dans 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 des entités OAuth .
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. 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

Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
Cliquez sur Nouveau.
Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?
Sélectionnez Informations d'identification OAuth 2.0.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom permettant d’identifier l’enregistrement d’informations d’identification du 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éé lors de la configuration de l’enregistrement du registre d’application.

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

Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
Ouvrez l’enregistrement d’alias pour Jira fourni avec le spoke.
Dans l’onglet Connexions , cliquez sur Nouveau.
Le système affiche un formulaire de connexion HTTP(s) vide.

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 Jira Cloud`.
Informations d'identification	Sélectionnez l’enregistrement d’informations d’identification créé pour Jira. Par exemple, sélectionnez Informations d’identification OAuth Jira Cloud.

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.

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.
Cliquez sur Envoyer.
Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
Ouvrez l’enregistrement d’informations d’identification que vous avez créé pour le Jira spoke.
Par exemple, les informations d’identification Jira OAuth.
Cliquez sur le lien connexe Obtenir le jeton OAuth.
Dans une nouvelle fenêtre, le système demande l’accès à votre Atlassian compte.
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.