--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://www.servicenow.com/docs/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Configurer le spoke pour Jira le Jira cloud # Configurer le spoke pour Jira le Jira cloud {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#setup-jira-spk-opt2__ul_ent_2sr_gwb} ## 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 {#ariaid-title2} 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 {#ariaid-title3} 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](https://developer.atlassian.com/docs/) 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](https://start.atlassian.com/) 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. {#generate-jiratokenv302__steps_j3p_ndz_4fb} #### 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 {#ariaid-title4} 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 processusConcepteur 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](https://www.servicenow.com/docs/Vx43MDguVHjTCRe5pStskQ "Prenez en charge plusieurs connexions à un seul et même fournisseur d'intégration. Sélectionnez des connexions pour les flux, les flux secondaires et les actions directement à partir d'un flux."). {#jira-basic-conf-temp__ul_p54_wrr_qwb}Si vous configurez le spoke pour la première fois, cliquez sur Configurer. Sinon, cliquez sur Modifier. 4. Renseignez les champs du formulaire Connexion . {#jira-basic-conf-temp__table_tfv_3d5_h5b__entry__2} | 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. | [ ] {#jira-basic-conf-temp__table_tfv_3d5_h5b} 5. Cliquez sur Créer une connexion. ## Option 2 : utilisation de l'authentification OAuth {#ariaid-title5} 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 {#ariaid-title6} 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](https://developer.atlassian.com/console/myapps/) 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). 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, 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. {#create-oauth-int-jira__substeps_djy_4ls_gwb} 5. Cliquez sur Paramètres. Sous Détails de l'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 :jira-configuration * Gérer :jira-project * Gérer :Jira-Webhook * Lire :jira-work * lire :jira-user * écrire :jira-work {#create-oauth-int-jira__ul_vr2_fms_gwb} 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 {#create-oauth-int-jira__ul_bbm_sms_gwb} {#create-oauth-int-jira__substeps_gxf_yls_gwb} Vous pouvez configurer d'autres champs d'application selon vos besoins. ### Obtenir la valeur de Cloud ID {#ariaid-title7} 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](https://admin.atlassian.com/) 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 {#ariaid-title8} 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 ToutOAuth systèmeRegistre 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. {#create-app-reg-jira__table_pcv_pfs_gwb__entry__2} | 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. | [ ] {#create-app-reg-jira__table_pcv_pfs_gwb} 5. Dans l'onglet Périmètres de l'entité OAuth , créez ces enregistrements de périmètres de l'entité. {#create-app-reg-jira__table_x23_bks_gwb__entry__2} | 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 | [ ] {#create-app-reg-jira__table_x23_bks_gwb} 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 {#ariaid-title9} 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 ToutConnexions et informations d'identificationInformations 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. {#jira-oauth-cred__table_pcs_vps_gwb__entry__2} | 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é. | [ ] {#jira-oauth-cred__table_pcs_vps_gwb} 5. Cliquez sur Envoyer. ### Créer un enregistrement de connexion pour le Jira spoke {#ariaid-title10} 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 ToutConnexions et informations d'identificationAlias 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. {#jira-create-conn-oauth__table_vsw_lkv_4fb__entry__2} | 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](https://www.servicenow.com/docs/vQZP6rIhzn9SqABmx5Egcg#jira-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."). | [ ] {#jira-create-conn-oauth__table_vsw_lkv_4fb} 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. {#jira-create-conn-oauth__substeps_ppy_5bt_gwb} 6. Cliquez sur Envoyer. 7. Accédez à la ToutConnexions et informations d'identificationInformations 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.