Pour les administrateurs : configurer Cartes Lucid pour Jira

Configurez votre instance Jira Cloud pour la synchronisation en direct

Vous aurez besoin des autorisations d'administrateur de Jira et de 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 effectuer les étapes suivantes dans Lucid : 

1. Sur la page d'accueil de Lucid, cliquez sur Admin en bas à gauche du menu de navigation.
2. Cliquez sur Intégration des applications dans le menu de gauche. 
3. Dans la liste déroulante, sélectionnez Lucidspark.
4. Localisez la tuile Lucid Cards for Jira Cloud et cliquez sur Paramètres.
5. Sélectionnez Ajouter une nouvelle instance.
   

Vous accéderez à la page Paramètres de Jira Cloud, sur laquelle vous devrez suivre les étapes suivantes :

1. Dans la liste déroulante "Autoriser pour", sélectionnez votre instance Jira pour Lucidspark.
2. Cliquez sur Accepter.
   
3. Cliquez sur Connecter pour vous authentifier avec les informations d'identification de votre instance Jira.
4. Sélectionnez Soumettre.

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 recommandons d'utiliser OAuth 2.0 pour les nouvelles intégrations. Si votre compte était précédemment connecté à l'aide de liens d'application (OAuth 1.0), vous n'avez pas besoin de changer, votre connexion existante continuera à fonctionner. Si vous avez besoin d'aide pour OAuth 1.0, veuillez vous référer à cet article de la communauté.

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

Assurez-vous que votre instance Jira est accessible par les serveurs de Lucid.

Assurez-vous que vous disposez d'un DNS public et autorisez les requêtes entrantes provenant des IP statiques répertoriées ci-dessous.

Si vous êtes dans l'environnement FedRAMP, assurez-vous que vous autorisez les requêtes entrantes et sortantes des IP statiques listées ci-dessous.

Connectez Lucidspark à Jira Data Center en utilisant OAuth 2.0

Vous aurez besoin des permissions d'administration de Jira et de Lucidspark, en plus d'une licence Lucidspark, pour effectuer les étapes suivantes.

Étape 1 : Créer une application OAuth 2.0 dans le centre de données Jira

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

1. Dans Jira, accédez à Jira Settings.
2. Allez à Applications.
3. Sélectionnez Liens d'application.
4. Sélectionnez Créer un lien.
5. Choisissez l'application externe avec la direction "Incoming".
6. Sélectionnez Continuer.
7. Définissez le nom de l'application.
   • Le nom que vous choisissez doit représenter la fonctionnalité Lucid Cards for Jira, par exemple "Lucidspark".
   • Définissez l'URL de redirection à "https://lucid.app/jiradatacenter/oauth2/callback".
8. Définissez les autorisations d'application pour inclure ADMIN.
9. Enregistrez et copiez l'identifiant et le secret du client générés.

Étape 2 : Configurer la connexion dans Lucid

1. Dans Lucid, sélectionnez Admin dans le menu situé dans le coin inférieur gauche de la page d'accueil.
2. Dans le menu de gauche, sélectionnez App integration.
3. Dans le menu déroulant, cliquez sur Lucidspark.
4. Localisez la tuile "Lucid Cards for 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 de l'application.
8. Saisissez l'ID client et le secret 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 fournir l'URL de ce proxy inverse. Ce proxy inverse doit autoriser le trafic entrant en provenance de nos adresses IP listé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 approbation, vous serez redirigé vers Lucid. L'intégration est maintenant configurée pour la synchronisation en direct.

Une fois la configuration administrative terminée, les utilisateurs finaux peuvent s'authentifier avec leurs propres identifiants Jira pour importer et créer des problèmes Jira dans Lucidspark. Chaque utilisateur sera redirigé vers l'écran de consentement du centre de données Jira 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 du centre de données Jira est protégée par un fournisseur SSO, cela peut poser des problèmes car le SSO est conçu pour authentifier les utilisateurs dans un navigateur et ne peut souvent pas être complété par un service backend effectuant des appels API.

La résolution de ce problème dépend de votre SSO spécifique et de votre configuration réseau. Vous devrez configurer votre infrastructure SSO ou réseau de manière à ce que le trafic serveur à serveur de Lucid ne soit pas intercepté par le SSO. Les approches courantes comprennent l'exclusion basée sur le chemin au niveau de la couche SSO ou le routage du trafic de Lucid autour de la couche SSO. 

Utiliser OAuth 1.0 avec SSO

Pour les liens d'application OAuth 1.0, consultez la solution de contournement d'Atlassian dans cet article de la communauté.

Configurer votre instance Atlassian Government Cloud pour la synchronisation en direct

Vous aurez besoin des autorisations d'administrateur de Jira et de Lucidspark pour effectuer les étapes suivantes. Nous exigeons que l'administrateur qui met en place 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 en vue d'une synchronisation en direct avec Lucid, un administrateur de compte peut effectuer les étapes suivantes dans Lucid : 

1. Sur la page d'accueil de Lucid, cliquez sur Admin en bas à gauche du menu de navigation.
2. Cliquez sur Intégration des applications 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. Lisez les 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 ce n'est pas nécessaire ?
A partir de janvier 2023, Lucidspark utilise des webhooks pour synchroniser les données de Jira. Cette mise à jour permet aux conseils d'administration de recevoir des mises à jour de Jira en temps réel. Lucidspark ne créera et ne gérera les webhooks qu'après une authentification unique à travers les étapes de configuration de l'intégration dans cet article. Si l'intégration est installée individuellement par un utilisateur avant que ces étapes ne soient terminées, l'intégration fonctionnera, mais les cartes synchroniseront les mises à jour de Jira environ toutes les 2 minutes au lieu de le faire en temps réel.

Que dois-je faire si j'obtiens un message d'erreur lorsque j'essaie de configurer l'intégration Lucid Cards dans Jira Data Center ?
Lors de la configuration de l'intégration Jira Data Center, si vous rencontrez une erreur d'application, reportez-vous à ce billet de la communauté Tips for resolving common errors when configuring Lucid Cards for Jira Data Center (Conseils pour résoudre les erreurs courantes lors de la configuration de Lucid Cards pour Jira Data Center).

Comment fonctionne cette intégration et quelles sont les autorisations dont j'ai besoin ?
Pour une explication approfondie du fonctionnement de cette intégration et de vos autorisations selon que vous disposez d'identifiants Jira utilisateur ou administrateur, veuillez vous référer à notre FAQ technique Lucid Cards for Jira. Cette ressource comprend un examen approfondi de l'utilisation des identifiants d'administrateur, des webhooks et de leurs avantages, ainsi que de la protection des données Jira.

Pourquoi suis-je redirigé vers lucid.app lorsque j'essaie de configurer l'intégration de Lucid Cards for 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 Lucid Cards for Jira.

Ressources

Pour obtenir de l'aide afin d'utiliser cette intégration avec succès, consultez les ressources supplémentaires ci-dessous. Ces ressources sont disponibles en anglais uniquement.

Publication de la communauté

Dépannage Jira : Impossible de modifier un champ dans Lucid - message d'erreur "Edit not supported" (modification non prise en charge)
Dépannage Jira : Différentes langues sont ajoutées en tant que colonnes dans un tableau dynamique

Donnez votre avis sur cet article