Authentification Jira

Connectez UiPath à Jira Cloud dans Automation Suite à l'aide d'un compte Atlassian. Les instances Jira Server et Data Center ne sont pas prises en charge.

Avant d’utiliser les activités ou les déclencheurs Jira, vous devez créer une connexion à votre instance Jira Cloud dans UiPath Integration Service.

Important :

Le connecteur Jira ne prend en charge que les instances Jira Cloud. Les instances Jira Server et Data Center ne sont pas prises en charge.

Méthodes d’authentification prises en charge

Type d’authentification	Description	Idéal pour
Basique	Utilise l’e-mail et le jeton d’API Atlassian Cloud	Comptes de service, automatisations Unattended.
Apportez votre propre application OAuth 2.0	Utilise votre propre application OAuth avec l’URL de rappel d’UiPath.	Les clients qui gèrent leurs propres applications et clés.

Basique

Authentifiez-vous auprès de Jira Cloud à l’aide d’une adresse e-mail de compte Atlassian et d’un jeton API, en passant par l’authentification de base HTTPS. En savoir plus ' .

La connexion s'exécute avec les mêmes autorisations de projet et de problème que l'utilisateur Jira configuré.

Champs obligatoires

Champ	Description
Site Url	L’URL du site Jira, par exemple https://your-domain.atlassian.net. Remarque : assurez-vous d’inclure « https:// » et aucun «/» à la fin de l’URL.
Nom d'utilisateur (Username)	Adresse e-mail du compte Atlassian utilisée pour se connecter à Jira Cloud
Jeton API	Jeton d'API Jira Cloud associé au compte

Comment générer un jeton API

1. Créez un jeton d’API ( sans étendue) dans la sécurité du compte Atlassian.​ En savoir plus.
2. Copiez le jeton généré et gardez-le en sécurité pour une utilisation ultérieure.
3. Dans UiPath Integration Service, ajoutez une connexion Jira et renseignez les champs suivants :
   • Site Url
   • Nom d'utilisateur (Username)
   • Jeton API​​

Cycle de vie du jeton

Pour des raisons de sécurité, les jetons ne peuvent pas durer plus d’un an et peuvent être révoqués et supprimés de la page de sécurité des comptes Atlassian. Une fois supprimés, tous les appels Integration Service utilisant ce jeton échoueront avec l’état 401 Non autorisé jusqu’à ce qu’un nouveau jeton soit configuré.​

Résolution des problèmes

• 401 Non autorisé : vérifiez l’e-mail et le jeton, confirmez que le jeton existe et qu’il a été copié correctement.​
• 403 Interdit sur certaines opérations : confirmez que l’utilisateur Jira dispose des autorisations de projet requises pour le projet cible et le type de problème.​

Questions fréquemment posées

Puis-je limiter un jeton API à des projets spécifiques ?
Non. Les jetons héritent de toutes les autorisations de l'utilisateur ; limitez l’accès en configurant les autorisations utilisateur/projet dans Jira.​

Le CAPTCha ou l’authentification unique affectent-ils les appels basés sur des jetons ?
Les règles CAPTcha et interactives s’appliquent au nom d’utilisateur/mot de passe, pas aux jetons API ; L'authentification unique régit toujours le compte, mais ne bloque pas l'utilisation de jetons. En savoir plus​.

Comment dois-je effectuer la rotation des jetons utilisés par UiPath ?
Créez un nouveau jeton, mettez à jour la connexion Jira dans UiPath avec le nouveau jeton, validez les automatisations, puis révoquez l’ancien jeton.​

Apportez votre propre application OAuth 2.0

Ce type d'authentification nécessite que vous apportez vos propres informations d'identification d'ID client et de clé secrète de client.

Suivez les instructions de Jira pour créer votre propre application : Applications OAuth 2.0 (3LO). Vous pouvez créer votre application à partir de la console développeur Jira . Lors de la configuration de votre propre OAuth2.0 L'application doit fournir l'URL de redirection/rappel comme suit : https://{yourDomain}/provisioning_/callback
Cette démarche est recommandée lorsque les automatisations doivent s’exécuter dans le contexte d’un utilisateur final et respecter à la fois les étendues OAuth et les autorisations de projet de cet utilisateur.​

Champs obligatoires

Champ	Description
Site Url	URL du site Jira, par exemple : https://your-domain.atlassian.net. Lorsque vous êtes invité à accorder à l'application UiPath les autorisations d'accès à Jira, assurez-vous de sélectionner la même URL de site Jira.
ID de client	Identifiant client de l'application Atlassian OAuth 2.0 (3LO)
Clé secrète du client	Secret de l'application Atlassian OAuth 2.0 (3LO). Ces informations seront stockées dans la base de données UiPath Integration Service.
Rediriger l’URL	URL de rappel UiPath, configurée exactement dans l’application Atlassian
Nom d'utilisateur (Username)	Utilisé dans la page de connexion Jira
Mot de passe (Password)	Utilisé dans la page de connexion Jira

Comprendre les étendues Jira

Les étendues définissent le niveau d'accès qu'une application peut demander pour interagir avec un produit Atlassian. Lorsqu'une connexion est établie et que l'utilisateur autorise l'application via l'activité Jira (par l'API), l'application OAuth reçoit l'autorisation d'effectuer les opérations spécifiées au nom de l'utilisateur, sous réserve des paramètres d'autorisation de l'utilisateur. Pour obtenir la liste complète des étendues disponibles, consultez la documentation relative aux étendues Jira .

Le tableau suivant répertorie les étendues requises pour la création de connexions :

Portée	Saisie de texte	Description
Read:Jira-User	Requis	Affichez les informations de l'utilisateur dans Jira auxquelles l'utilisateur a accès, y compris les noms d'utilisateur, les adresses e-mail et les avatars.
lecture:jira-work	Requis	Lire les données de projet et de problème Jira, rechercher les problèmes et les objets associés à des problèmes comme les pièces jointes et les journaux de travail.
écriture:Jira-work	Requis	Créer et modifier des problèmes dans Jira, publier des commentaires en tant qu'utilisateur, créer des journaux de travail et supprimer des problèmes.
gérer:jira-projet	Requis	Créez et modifiez les paramètres du projet et créez de nouveaux objets au niveau du projet (par exemple, des versions et des composants).
accès_hors ligne	Requis	Actualiser automatiquement le jeton OAuth
gérer:configuration du jira	Facultatif	Effectuez des actions d’administration Jira (par exemple, créez des projets et des champs personnalisés, affichez des workflows et gérez les types de liens de problèmes).
Manage:Jira-data-Provider	Facultatif	Gérer les informations de développement et de publication pour les tiers dans Jira

Important :

L’application doit disposer de toutes les étendues demandées par votre connexion.

Comment générer des informations d’identification

1. Suivez le guide de l'application 3LO d'Atlassian .
2. Configurez l'URL de rappel UiPath Jira à partir de la page d'authentification Integration Service Jira comme URI de redirection.
3. Sélectionnez write:jira-work étendues read:jira-work read:jira-user dont vous avez besoin.
4. Copiez l' ID client et le secret client de l'application Atlassian dans les paramètres de connexion UiPath Jira.

Cycle de vie du jeton

Les jetons d'accès sont de durée courte ; UiPath utilise des jetons de réactualisation pour obtenir de nouveaux jetons d’accès jusqu’à ce que le jeton de réactualisation expire ou qu’il soit révoqué.​

La révocation du consentement ou la suppression de l’application Atlassian OAuth invalide les jetons et nécessite une nouvelle autorisation de UiPath.​

Résolution des problèmes (OAuth)

• Incohérence de l’URI de redirection : assurez-vous que l’URL de redirection configurée dans Atlassian correspond exactement à l’URL de rappel d’UiPath.​

• insufficient_scope ou 403 : ajoutez toutes les étendues Jira manquantes à l'application et assurez-vous que l'utilisateur dispose des autorisations Jira nécessaires.​

Questions fréquemment posées

Quelles sont les étendues minimales pour émettre le CRUD ?
Cela varie d’un objet à un autre, mais généralement read:jira-work et write:jira-work pour les problèmes/commentaires ; ajoutez read:jira-user si la recherche/affectation de l'utilisateur est utilisée.

Les étendues peuvent-elles restreindre l'accès à des projets spécifiques ?
Non. Les étendues sont fonctionnelles ; l’accès au niveau du projet est toujours régi par les autorisations de l’utilisateur autorisé dans Jira.​

Pourquoi est-ce que je reçois toujours le message 403 après une connexion réussie à OAuth ?
Assurez-vous que read:jira-user est déduit dans votre application privée.

Ajouter la connexion Jira

Pour créer une connexion à votre instance Jira, vous devez effectuer les étapes suivantes :

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Jira. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Cliquez sur le bouton Se connecter à Jira .
4. Sélectionner un type d'authentification.
5. Saisissez les informations d’identification requises pour votre méthode d’authentification favorite et sélectionnez Connecter.

Autorisations

Avec l'accès à votre compte, UiPath pour Jira Cloud est capable de :

• Gérer les paramètres:
  • Effectuer les actions d'administration Jira (par ex. créer des projets et des champs personnalisés, afficher les workflows, gérer les types de liens de problèmes).
  • Gérez les informations de développement et de publication pour les tiers dans Jira.
  • Créer et modifier les paramètres du projet et créer de nouveaux objets au niveau du projet (par ex. les versions et les composants).
• Afficher les données:
  • Affichez les informations de l'utilisateur dans Jira auxquelles l'utilisateur a accès, y compris les noms d'utilisateur, les adresses e-mail et les avatars.
  • Lisez les données de projet et de problème Jira, recherchez des problèmes et des objets associés à des problèmes, tels que des pièces jointes et des journaux de travail.
• Mettre à jour les problèmes :
  • Créer et modifier des problèmes dans Jira, publier des commentaires en tant qu'utilisateur, créer des journaux de travail et supprimer des problèmes.