Pour les administrateurs : configurer Cartes Lucid pour Jira

Configurez votre instance Jira Cloud pour la synchronisation en direct

Vous devez disposer des autorisations d’administrateur Jira et Lucidspark pour effectuer les étapes suivantes. Nous exigeons que l’administrateur qui configure cette intégration dispose d’une licence Lucidspark. Nous vous recommandons également d’utiliser un compte de service Jira ou un compte administrateur Jira.

Pour configurer l’instance Jira Cloud pour la synchronisation en direct avec Lucid, un administrateur de compte peut suivre ces étapes dans Lucid : 

1. Depuis la page d’accueil de Lucid, cliquez sur Administrateur en bas à gauche du menu de navigation.
2. Cliquez sur Intégration d’applications dans le menu de gauche. 
3. Dans la liste déroulante, sélectionnez Lucidspark.
4. Repérez la tuile Cartes Lucid pour Jira Cloud et cliquez sur Paramètres.
5. Sélectionnez Ajouter une nouvelle instance.
   

La page des paramètres de Jira Cloud s'ouvrira alors, sur laquelle vous devez suivre ces étapes :

1. Dans le menu déroulant « Autoriser pour », sélectionnez votre instance Jira pour Lucidspark.
2. Cliquez sur Accepter.
   
3. Cliquez sur Connecter pour vous authentifier avec les identifiants de votre instance Jira.
4. Sélectionnez Envoyer.

L’intégration est maintenant configurée pour la synchronisation en direct. 

Activer l'instance Jira Data Center

Suivez les étapes ci-dessous pour configurer une instance Jira Data Center. Nous vous recommandons d’utiliser le protocole OAuth 2.0 pour les nouvelles intégrations. Si votre compte a été précédemment connecté à l’aide d’Application Links (OAuth 1.0), vous n’avez pas besoin d’en changer, votre connexion existante continuera de fonctionner. Si vous avez besoin d’aide pour OAuth 1.0, veuillez consulter cette publication de la communauté.

Bien que les menus Jira présentés dans cette section puissent différer selon votre version de Jira Data Center, le processus général de configuration reste le même.

S’assurer que votre instance Jira est accessible par les serveurs de Lucid

Assurez-vous de disposer d’un DNS public et d’autoriser les requêtes entrantes provenant des adresses IP statiques répertoriées ci-dessous.

Si vous utilisez l’environnement FedRAMP, veillez à autoriser les requêtes entrantes et sortantes provenant des adresses IP statiques répertoriées ci-dessous.

Connecter Lucidspark à Jira Data Center à l’aide du protocole OAuth 2.0

Vous aurez besoin des autorisations d’administrateur Jira et Lucidspark, en plus d’une licence Lucidspark, pour effectuer les étapes suivantes.

Étape 1 : créer une application OAuth 2.0 dans Jira Data Center

Dans votre instance Jira Data Center, créez un lien d’application OAuth 2.0 entrant :

1. Dans Jira, accédez à Paramètres Jira.
2. Accédez à Applications.
3. Choisissez Liens d’application.
4. Sélectionnez Créer un lien.
5. Choisissez Application externe avec la direction « Entrante ».
6. Sélectionnez Continuer.
7. Définissez le nom de l’application.
   • Le nom que vous choisissez doit représenter la fonctionnalité des Cartes Lucid pour Jira ; par exemple « Lucidspark ».
   • Définissez l’URL de redirection sur « https://lucid.app/jiradatacenter/oauth2/callback ».
8. Définissez les autorisations de l’application de manière à inclure ADMIN.
9. Enregistrez et copiez l'ID client et le secret client générés.

Étape 2 : configurer la connexion dans Lucid

1. Dans Lucid, sélectionnez Administrateur dans le menu dans le coin inférieur gauche de la page d’accueil.
2. Dans le menu de gauche, sélectionnez Intégration d’applications.
3. Dans le menu déroulant, cliquez sur Lucidspark.
4. Repérez la vignette « Cartes Lucid pour Jira Data Center ».
5. Cliquez sur Paramètres sur la tuile (ou sur Installer si vous n’avez pas encore configuré l’intégration).
6. Sélectionnez Ajouter une nouvelle instance (ou Commencer la configuration si vous n’avez pas encore configuré l’intégration).
7. Vérifiez que l’URL de redirection correspond à ce que vous avez configuré dans Jira sur le lien d’application.
8. Saisissez l’ID client et la clé secrète client de Jira.
9. Saisissez l'URL de votre instance Jira Data Center.
   • Cela peut par exemple ressembler à « https://jira.yourcompany.com ».
   • Si un proxy inverse est configuré pour intercepter le trafic entrant avant qu’il n’atteigne votre instance, vous pouvez indiquer l’URL de ce proxy inverse. Ce proxy inverse doit autoriser le trafic entrant provenant de nos adresses IP répertoriées ici.

Étape 3 : autoriser la connexion

1. Cliquez sur Activer pour lancer le flux d’autorisation OAuth 2.0.

Vous serez redirigé vers votre instance Jira Data Center pour approuver l’accès. Après avoir approuvé, vous serez redirigé vers Lucid. L’intégration est désormais configurée pour la synchronisation en direct.

Une fois la configuration par l'administrateur terminée, les utilisateurs finaux peuvent s'authentifier avec leurs propres identifiants Jira pour importer et créer des tickets Jira dans Lucidspark. Chaque utilisateur sera redirigé vers l'écran de consentement de Jira Data Center lors de sa première connexion.

Pour les comptes utilisant l’authentification SSO avec Jira

Les serveurs de Lucid doivent pouvoir accéder à votre instance Jira Data Center. Si votre instance Jira Data Center est protégée par un fournisseur d’authentification unique, cela peut entraîner des problèmes, car l’authentification unique est conçue pour authentifier les utilisateurs dans un navigateur et ne peut souvent pas être effectuée par un service backend effectuant des appels d’API.

La résolution de ce problème dépend de votre configuration SSO et réseau spécifique. Vous devrez configurer votre infrastructure SSO ou réseau afin que le trafic de serveur à serveur de Lucid contourne l’interception SSO. Les approches courantes incluent l’exclusion basée sur des chemins d’accès au niveau de la couche SSO ou le routage complet du trafic de Lucid pour contourner le SSO. 

Utilisation du protocole OAuth 1.0 avec SSO

Pour les liens d’application OAuth 1.0, consultez la solution de contournement d’Atlassian dans cette publication de la communauté.

Configurez votre instance Atlassian Government Cloud pour la synchronisation en direct

Vous devez disposer des autorisations d’administrateur Jira et Lucidspark pour effectuer les étapes suivantes. Nous exigeons que l’administrateur qui configure cette intégration dispose d’une licence Lucidspark. Nous vous recommandons également d’utiliser un compte administrateur Jira.

Pour configurer l'instance Atlassian Government Cloud pour la synchronisation en direct avec Lucid, un administrateur de compte peut suivre les étapes suivantes dans Lucid : 

1. Depuis la page d’accueil de Lucid, cliquez sur Administrateur en bas à gauche du menu de navigation.
2. Cliquez sur Intégration d’application dans le menu de gauche. 
3. Dans la liste déroulante, sélectionnez Lucidspark.
4. Cliquez sur Ajouter une nouvelle instance Atlassian Government Cloud.
5. Prenez connaissance des autorisations et cliquez sur Accepter.

L’intégration est maintenant configurée pour la synchronisation en direct. 

FAQ

Pourquoi activer l’intégration Jira Cloud ou Atlassian Government Cloud en tant qu’administrateur si elle n’est pas obligatoire ?
Depuis janvier 2023, Lucidspark utilise des webhooks pour synchroniser les données provenant de Jira. Cette mise à jour permet aux tableaux de recevoir les mises à jour de Jira en temps réel. Lucidspark ne créera et ne gérera les webhooks qu’après une authentification unique via les étapes de configuration de l’intégration décrites dans cet article. Si l’intégration est installée individuellement par un utilisateur avant la fin de ces étapes, elle fonctionnera, mais les cartes synchroniseront les mises à jour de Jira toutes les 2 minutes environ au lieu de le faire en temps réel.

Que dois-je faire si je reçois un message d’erreur lors de la configuration de l’intégration des Cartes Lucid dans Jira Data Center ?
Lors de la configuration de l’intégration Jira Data Center, si vous rencontrez une erreur d’application, reportez-vous à cette publication de la communauté contenant des Conseils pour résoudre les erreurs courantes lors de la configuration des Cartes Lucid pour Jira Data Center.

Comment fonctionne cette intégration et de quelles autorisations ai-je besoin ?
Pour obtenir une explication détaillée du fonctionnement de cette intégration et de vos autorisations selon que vous disposez d’identifiants Jira utilisateur ou administrateur, veuillez consulter notre ressource FAQ technique sur les Cartes Lucid pour Jira. Cette ressource explique en détail la manière dont les identifiants d’administrateur sont utilisés, les webhooks et leurs avantages, ainsi que la façon dont les données Jira sont protégées.

Pourquoi suis-je redirigé vers lucid.app lorsque j’essaie de configurer l’intégration Cartes Lucid pour Jira avec mon instance Atlassian Government Cloud ?
Pour éviter d’être redirigé vers lucid.app, vous devrez utiliser le SSO pour vous connecter à votre instance Atlassian Government Cloud avant de configurer l’intégration Cartes Lucid pour Jira.

Ressources

Pour obtenir une aide supplémentaire afin d’utiliser cette intégration avec succès, consultez les ressources supplémentaires ci-dessous. Ces ressources ne sont disponibles qu’en anglais.

Publications de la communauté

Dépannage Jira : impossible de modifier un champ dans Lucid — message d’erreur « Modification non prise en charge »
Dépannage Jira : différentes langues ajoutées en tant que colonnes à la table de données dynamique

Donnez votre avis sur cet article