Connecteur Smartsheet pour Jira : configuration de l’administration (Cloud et auto-hébergé)

Utilisez le connecteur Smartsheet pour Jira afin de synchroniser les informations entre Smartsheet et une ou plusieurs instances Jira. Cet article fournit des instructions pour configurer le connecteur Smartsheet pour Jira avec les versions Cloud et Serveur auto-hébergé de Jira.

Pré-requis

Le connecteur Smartsheet pour Jira est disponible en tant qu’offre Premium.  Pour obtenir des informations sur les tarifs et sur l’achat, veuillez contacter notre équipe commerciale.

Pour configurer le connecteur Smartsheet pour Jira, vous devez être un administrateur dans l’application Jira. L’un des rôles suivants doit également vous être attribué :

• Dans Smartsheet : Administrateur système ou Administrateur du connecteur (ce rôle au niveau du compte est propre au connecteur Smartsheet pour Jira, consultez Types d’autorisations de Smartsheet pour Jira pour plus d’informations).
• Dans Jira : Administrateur système

Vous version de Jira doit répondre aux exigences suivantes : 

• Jira Cloud, ou une version de Jira jusqu’à la version 9 qui n’a pas atteint le statut de fin de vie. Consultez la Politique de fin de vie du support Atlassian pour vérifier le statut de votre version. 

Si vous souhaitez configurer le connecteur avec un serveur Jira auto-hébergé et un pare-feu, consultez en premier lieu l’article sur les Exigences de pare-feu du connecteur Jira.

Configurer une connexion entre Jira et Smartsheet

1. Identifiez-vous dans Connecteur Smartsheet pour Jira à l’adresse https://connectors.smartsheet.com/c/Jira. Si vous êtes invité à autoriser l’accès à votre compte Smartsheet, cliquez sur Autoriser.
2. Sélectionnez le menu en haut à gauche, puis sélectionnez Administrateur de compte.
3. Sélectionnez Enregistrer un nouveau serveur Jira.
4. Saisissez l’URL de l’hôte Jira que vous souhaitez utiliser.
5. Acceptez ou modifiez le nom par défaut, sélectionnez votre version de Jira et cliquez sur Continuer.
6. Pour les versions 9 et ultérieures de Jira auto-hébergées : la clé du consommateur, le nom du consommateur et la clé publique sont nécessaires pour créer le lien de l’application dans Jira.

Vous pouvez enregistrer plusieurs instances Jira simultanément avec le connecteur. Répétez les instructions ci-dessus pour chaque instance Jira supplémentaire que vous souhaitez enregistrer.

Le connecteur Smartsheet pour Jira fournit des clés publique et consommateur à utiliser dans Jira pour établir une connexion sécurisée entre les deux services. Copiez ces clés : vous en aurez besoin plus tard.

Utilisez un compte de messagerie générique à la fois dans Smartsheet et dans Jira (exemple : smartsheet-jira@yourdomain.com) pour configurer la connexion à Jira. Vous ne pouvez pas modifier les propriétaires de la connexion. L’utilisation d’un compte générique sera une aide afin d’éviter de devoir recréer les connexions ou les flux de travail si le gestionnaire de la connexion à Jira quitte votre organisation.

Créer un lien d’application

Pour activer la connexion entre Jira et Smartsheet, vous devez établir et configurer un Lien d’application (désigné sous le nom « AppLink » dans la documentation Jira) entre les deux systèmes.

1. Connectez-vous à Jira avec les autorisations Administrateur Jira.
2. Allez dans les Paramètres Jira.
3. Sélectionnez Produits puis, sous Intégrations, cliquez sur Liens d’application. Pour les versions auto-hébergées précédentes de Jira, cliquez sur    > Applications, puis sélectionnez Liens d’application.
   
   Pour les versions 9 et ultérieures auto-hébergées de Jira, cliquez sur Créer un lien, puis sélectionnez l’option Produit d’Atlassian.
   
   Cette fonction permet de créer des liens vers d’autres produits Atlassian et des applications externes qui utilisent OAuth 1.0, comme le connecteur Smartsheet.
   
   
    
4. Saisissez l’URL de l’application vers laquelle vous souhaitez créer un lien (https://app.smartsheet.com), puis cliquez sur Continuer ou Créer un nouveau lien selon votre version de Jira.
   Si l’un des messages suivants apparaît, cliquez sur Continuer et laissez la nouvelle URL telle quelle. 
   • Aucune réponse n’a été reçue de l’URL que vous avez saisie : il se peut qu’elle soit invalide. Veuillez corriger l’URL ci-dessous, si nécessaire, puis sélectionnez Continuer.
     -OU-
   • L’URL de l’application fournie a été redirigée une fois. Veuillez vérifier le champ de l’URL redirigée pour vous assurer qu’il s’agit d’une URL fiable. 
5. Dans le champ Nom de l’application, saisissez Smartsheet. Pour Type d’application, acceptez la valeur par défaut d’Application générique, puis cliquez sur Continuer.
   

   
   Étapes supplémentaires pour les versions 9 et ultérieures auto-hébergées de Jira :
   
   Cochez la case Créer un lien entrant, puis sélectionnez Continuer.
   
   Copiez la clé consommateur, le nom du consommateur et la clé publique depuis l’écran de configuration du connecteur Smartsheet. 

6. Sélectionnez Continuer.

Pour les versions de Jira auto-hébergées jusqu’à la version 8, voir ci-dessous. Pour les versions 9 et ultérieures auto-hébergées de Jira, passez à l’étape Compléter la connexion avec la version 9 ou ultérieure de Jira.
 

Configurer le Lien d’application pour Jira Cloud ou auto-hébergé jusqu’à la version 8

Utilisez les clés que vous avez créées lors de la configuration de la connexion entre Jira et Smartsheet. 

1. Dans Jira, à partir de la page Configurer les liens d’application (choisissez > Paramètres > Applications puis sélectionnez Liens d’application dans le menu).
2. Localisez l’emplacement du Lien d’application Smartsheet que vous avez créé dans la section précédente. Sélectionnez l’icône Modifier . Dans les versions auto-hébergées précédentes de Jira, cliquez sur  Paramètres   > Applications, puis sélectionnez Liens d’application.
3. Dans la boîte de dialogue Configurer , sélectionnez Authentification entrante. Collez les clés publique et consommateur dans les cases appropriées. Faites défiler l’écran pour localiser le champ Clé publique.
4. Si l’URL du jeton de demande, l’URL du jeton d’accès ou l’URL d’autorisation sont requises dans votre environnement Jira, utilisez l’URL suivante pour remplir ces champs :https://api.smartsheet.com/2.0/token
5. Si une Clé consommateur et un Secret partagé sont requis, utilisez la Clé consommateur et la Clé publique de la fenêtre Configuration du connecteur Jira.
6. En bas de la boite de dialogue, sélectionnez Enregistrer > Fermer. 

Documentation Jira supplémentaire relative aux Liens d’application

Pour plus d’informations sur les Liens d’application dans Jira, consultez

• Utiliser les AppLinks pour se connecter à d’autres applications
• Documentation des Liens d’application

Terminer la connexion avec la version 9 ou ultérieure de Jira

1. Retournez à la configuration du connecteur Smartsheet, puis sélectionnez Continuer.
2. Sur l’écran suivant, sélectionnez Continuer pour achever la connexion du côté de Smartsheet.
3. La dernière étape consiste à autoriser Smartsheet à accéder à votre application Jira ; pour ce faire, sélectionnez Autoriser sur l’écran suivant.

La connexion entre Smartsheet et Jira est à présent configurée.