Configuration

Introduction

Pour vous connecter à Jira à l'aide de ce package d'activités, vous devez d'abord créer les informations d'identification requises par l' étendue Jira afin d'authentifier tous les appels ultérieurs. L'étendue prend actuellement en charge deux types d'authentification :

• Jeton d'API (API Token) : un jeton d'authentification est généré par Jira pour votre utilisateur. Cette méthode prend en charge les automatisations entièrement Unattended.
• OAuth 2.0: un ID de client et une clé secrète sont générés par Jira et peuvent être utilisés pour tous les utilisateurs au sein d'une organisation. Cette méthode affiche, lors du Runtime, un écran de connexion dans lequel un utilisateur peut saisir ses identifiants de connexion pour Jira ou l'un de ses fournisseurs d'authentification unique. Un jeton est produit et enregistré localement. Ce jeton est de courte durée et devra peut-être être actualisé ultérieurement. Pour cette raison, cette méthode prend en charge les automatisations Attended et certaines automatisations Unattended .

Please follow the steps below to prepare a set of credentials for your activities.

Identifiants

Option 1: API Token

1. Suivez les instructions d'Atlassian ici pour générer un jeton d'API.
2. Ajoutez une activité Jira Scope à votre workflow et modifiez le paramètre Type d'authentification ( Authentication Type ) sur Api Token.
3. Renseignez la propriété URL du serveur ( Server URL ) avec l'URL de l'instance Jira de votre organisation. Pour les instances Cloud, elle se présente généralement sous la forme https://<your org>.atlassian.net.
4. Enfin, remplissez la propriété Jeton API ( Api Token ) avec le jeton généré à l'étape 1 et la propriété Nom d'utilisateur (Username) avec l'e-mail que vous utilisez pour vous connecter à l'instance Jira désignée. L'étendue Jira Scope est maintenant prête à l'emploi.

Option 2: OAuth 2.0

1. Suivez les instructions d'Atlassian ici pour activer OAuth 2.0 (3LO) et créer une nouvelle "application".

   
   

   

   
   
2. Sous API ET FONCTIONNALITÉS, sélectionnez OAuth 2.0 (3LO). Entrez http://127.0.0.1:10001/authorize/ dans le champ URL de rappel ( Callback URL ). Cela indique à l'application Jira de revenir à la machine exécutant les activités une fois qu'elle a fini d'authentifier un utilisateur.
   
   

   

   
   

3. Sous API ET FONCTIONNALITÉS ( APIS AND FEATURES) , sélectionnez Ajouter (Add) pour permettre à l'application d'accéder aux API Atlassian. Sélectionnez le bouton Ajouter (Add) sous API REST de la plate-forme Jira (Jira platform REST API).

   
   

   

   
   
4. Le bouton Ajouter (Add) sera remplacé par un autre indiquant Configurer ( Configure). Cliquez dessus pour choisir les autorisations accordées à l'application. Ajoutez read:jira-work, manage:jira-project, manage:jira-configuration, read:jira-useret write:jira-work.
   
   

   

   
   
   
   

   

   
   

5. Revenez aux Détails de l'application ( App Details ) et copiez votre ID client (Client ID) et votre Clé secrète. Ceux-ci peuvent maintenant être utilisés dans un workflow.

   
   

   

   
   
6. Ajoutez une activité Jira Scope à votre workflow et modifiez le paramètre Type d'authentification ( Authentication Type ) sur OAuth 2.0.
7. Renseignez la propriété URL du serveur ( Server URL ) avec l'URL de l'instance Jira de votre organisation. Pour les instances Cloud, elle se présente généralement sous la forme https://<your org>.atlassian.net.

8. Enfin, remplissez les propriétés ID de client ( Client ID ) et Clé secrète du client (Client Secret ) avec les valeurs copiées à l'étape 5. L'étendue Jira Scope est maintenant prête à l'emploi.

   Pour transformer le type de variable de String en SecureString, dans le paramètre par défaut pour le clientSecret, vous pouvez utiliser cette commande :

   (new System.Net.NetworkCredential("","*YOUR_SECRET*")).SecurePassword

   
   

   

   
   
9. Si vous suivez les étapes ci-dessus dans Studio et que vous recevez le message d'erreur RemoteException wrapping System.Net.HttpListenerException: The network location cannot be reached. For information about network troubleshooting, see Windows Help lorsque vous essayez d'exécuter l'activité Jira Scope, la solution consiste à ouvrir cmd.exe en tant Administrator et à exécuter cette commande :

   netsh http add iplisten ipaddress=127.0.0.1

   
   

   

   
   

10. Après la première exécution de l'activité Jira Scope, vous recevez une fenêtre de demande d'autorisation dans votre navigateur par défaut, dans laquelle vous devez spécifier le site Jira, puis cliquer sur Accepter.