Micro-apps

Intégrer Jira

L’intégration Jira vous permet de suivre les problèmes et d’obtenir des mises à jour automatisées sur les tâches à partir de n’importe quel appareil, site intranet ou n’importe quelle messagerie instantanée.

Utilisez le processus suivant pour activer l’intégration avec Jira. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.

Pour obtenir une liste complète des micro-apps Jira prêtes à l’emploi, consultez la section Utiliser les micro-apps Jira.

Vérifier les conditions préalables

Tous les comptes utilisateur que vous souhaitez utiliser via cette intégration doivent avoir une visibilité au niveau de leur messagerie avec les paramètres de compte définis sur Anyone. Cela désigne les comptes de service, ainsi que les comptes avec lesquels les utilisateurs se connectent à Citrix Workspace via OAuth. Accédez à https://id.atlassian.com/manage-profile/profile-and-visibility et connectez-vous si nécessaire. Dans la section Contact, en regard du compte de messagerie, sélectionnez Anyone dans le menu Who can see this?.

Une fois l’intégration dans Jira configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL
  • Nom d’utilisateur
  • Mot de passe : vous devez entrer le Jeton API comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.
  • Méthode d’authentification (informations d’identification ou OAuth2)

Pour OAuth 2.0, vous avez également besoin des éléments suivants :

  • ID client
  • Clé secrète client

Remarque : Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

Les conditions préalables suivantes doivent être remplies avant de commencer le processus d’intégration :

  • Vous devez disposer d’un compte utilisateur dédié qui dispose d’un accès de navigation aux projets Jira que vous souhaitez gérer.

    Pour plus d’informations sur la gestion des utilisateurs, consultez la section https://www.atlassian.com/software/jira/guides#ManagingUsers-Addingusers.

    Pour plus d’informations sur l’ajout d’un utilisateur à un modèle d’autorisation pour un projet Jira, consultez la section Gérer des autorisations de projet.

  • Configurez Citrix Gateway pour prendre en charge l’authentification unique pour Jira : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Suivez les instructions de l’article Configuration de l’authentification unique pour Jira. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-ON), consultez la section Citrix Gateway Service.

Activer OAuth 2.0 (3LO)

Avant de mettre en œuvre OAuth 2.0 (3LO), vous devez l’activer pour votre application dans la gestion des applications Jira.

  1. Accédez à Gestion des applications.
  2. Créez une nouvelle application en sélectionnant Créer une nouvelle application, donnez-lui un nom, acceptez les conditions d’utilisation et sélectionnez Créer.
  3. Copiez l’ID du client et la Clé secrète client pour une utilisation ultérieure.
  4. Dans la section API et fonctionnalités dans la navigation latérale, cliquez sur +Ajouter.
  5. Dans la section Fonctionnalités de la page API et fonctionnalités, recherchez OAuth 2.0 (3LO), sélectionnez Ajouter, puis Configurer.
  6. Entrez l’URL de rappel. Définissez cette URL sur n’importe quelle URL accessible par l’application. Lorsque vous mettez en œuvre OAuth 2.0 (3LO) dans votre application (voir la section suivante), l’URI redirect_uri doit correspondre à cette URL.
  7. Cliquez sur Enregistrer les modifications.

Votre écran se présente comme suit : Jira OAuth2

Créer un jeton API

Un script ou un autre processus peut utiliser un jeton API pour effectuer une authentification de base avec les applications Jira Cloud ou Confluence Cloud. Vous devez utiliser un jeton API si la vérification en deux étapes du compte Atlassian avec lequel vous vous authentifiez est activée. Accédez directement à la page des jetons API et à l’étape 3 si vous êtes connecté à l’aide de jetons API.

  1. Cliquez sur votre profil utilisateur en bas à gauche.
  2. Sélectionnez Profil > Gérer votre compte > Sécurité > Créer et gérer des jetons API.
  3. Sélectionnez Créer un jeton API et donnez un nom au jeton dans le champ Intitulé.
  4. Sélectionnez Copier dans le Presse-papiers et enregistrez le jeton pour une utilisation ultérieure.

Vous devez entrer le Jeton API comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.

Ajouter l’API REST de la plate-forme Jira

Si vous n’avez pas encore ajouté l’API REST de la plate-forme Jira, faites-le maintenant.

  1. Dans la section API et fonctionnalités dans la navigation latérale, cliquez sur +Ajouter.
  2. Dans la section API de la page API et fonctionnalités, recherchez OAuth 2.0 (3LO), sélectionnez Ajouter, puis Configurer.
  3. Ajoutez les champs d’application souhaités pour votre application.

Définir la durée de récupération des problèmes

Définissez la durée pendant laquelle vous souhaitez récupérer des problèmes dans Jira. Lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace, la quantité de données récupérées à partir de Jira peut être limitée en appliquant un filtre de charge.

  1. Connectez-vous à Jira avec votre compte utilisateur et votre mot de passe dédiés.

    Remarque :

    Si vous utilisez un compte existant, le nom d’utilisateur n’est pas l’e-mail du compte. Pour trouver le nom d’utilisateur d’un compte, connectez-vous à votre instance Jira, sélectionnez la miniature de profil, puis Profil.

  2. Entrez le nombre de jours pendant lesquels vous souhaitez récupérer des problèmes.

    Valeur par défaut : 90 jours

Ajouter une URL de rappel

Ajoutez une adresse URL personnalisée à votre configuration d’instance pour accorder l’accès aux données privées et activer les actions utilisateur authentifiées par OAuth. Pour rechercher l’URL de votre serveur de micro-apps, connectez-vous à Citrix Cloud et sélectionnez la vignette Micro-apps. Dans la barre d’URL, copiez la première section de l’URL. Il s’agit de l’URL de votre serveur de micro-apps. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Connectez-vous à Jira en tant qu’administrateur et ajoutez l’URL de redirection autorisée suivante pour cette intégration :

https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration Jira aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Dans la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette Jira à ajouter.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Jira : URL, Nom d'utilisateur, Mot de passe, Authentification de l'utilisateur

  5. Renseignez la section Paramètres du connecteur avec les éléments requis que vous avez obtenus.
    • Entrez l’URL.
    • Entrez votre Nom d’utilisateur et votre Mot de passe d’authentification de service.

      Remarque :

      Entrez le Jeton API que vous avez obtenu lors de l’étape précédente comme Mot de passe lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace.

  6. Sélectionnez une Méthode d’authentification. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué.
    • Informations d’identification : les informations d’identification du client sont utilisées.
    • OAuth 2.0 : entrez l’ID du client OAuth et la Clé secrète client OAuth que vous avez obtenus dans la procédure Vérifier les conditions préalables.
  7. Sélectionnez une valeur pour le champ Tickets modifiés – Nombre de semaines à charger.
  8. Sélectionnez Ajouter.

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une nouvelle micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation.

Pour plus d’informations, consultez les sections Vérifier les entités requises et Définir la synchronisation des données dans l’article Configurer l’intégration.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Jira.

Utiliser les micro-apps Jira

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Micro-apps Jira

L’intégration Jira est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Créer un ticket : permet de créer un ticket Jira, ainsi que ses détails correspondants.

Notification ou Page Workflows de cas d’utilisation
Page Créer un ticket Fournit un formulaire permettant de créer un ticket Jira, y compris la sélection d’un type de problème, d’un projet et éventuellement d’un responsable, ainsi qu’un champ pour ajouter une description.

Tickets : permet d’afficher les tickets, d’ajouter des commentaires, de créer des sous-tâches, de modifier l’état et le responsable.

Notification ou Page Workflows de cas d’utilisation
Notification Commentaire modifié (ticket attribué) Lorsqu’un commentaire est modifié sur un ticket existant attribué à un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Commentaire modifié (envoyé) Lorsqu’un commentaire est modifié sur un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification du commentaire modifié dans Workspace.
Notification Nouveau commentaire (ticket attribué) Lorsqu’un nouveau commentaire est ajouté à un ticket existant attribué à un utilisateur, celui-ci reçoit une notification.
Notification Nouveau commentaire (ticket envoyé) Lorsqu’un nouveau commentaire est ajouté à un ticket existant envoyé par un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (changement) Lorsqu’un ticket existant est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (nouveau) Lorsqu’un nouveau ticket est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Changement de responsable du ticket (envoyé) Lorsqu’un ticket est réaffecté, l’utilisateur ayant envoyé le ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket attribué) Lorsque l’état d’un ticket est modifié, le responsable du ticket reçoit une notification.
Notification Changement de l’état du ticket (ticket envoyé) Lorsque l’état d’un ticket est modifié, l’utilisateur ayant envoyé le ticket reçoit une notification.
Page Ajouter un commentaire Fournit un formulaire permettant d’ajouter un commentaire à un ticket Jira.
Page Changer de responsable Fournit un formulaire permettant de changer le responsable d’un ticket Jira.
Page Modifier l’état Fournit un formulaire permettant de modifier l’état d’un ticket Jira.
Page Détails du commentaire Fournit une vue en lecture seule d’un commentaire et de ses détails correspondants.
Page Créer une sous-tâche Fournit un formulaire permettant de créer une sous-tâche pour un ticket Jira.
Page Détails du ticket Fournit une vue en lecture seule d’un ticket Jira et de ses détails correspondants.
Page Tickets Permet aux utilisateurs de rechercher des tickets Jira qui leur sont attribués, qu’ils ont envoyés ou sur lesquels ils ont commenté.