Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Connexion à Jira Cloud Jira Cloud est une plateforme développée par Atlassian. La plateforme inclut des produits de suivi des problèmes qui aident les équipes à planifier et à suivre leurs projets Agile. En tant qu’utilisateur de Jira Cloud, votre compte contient des données relatives à vos projets, telles que des problèmes, des flux de travail et des événements. Vous pouvez l'utiliser AWS Glue pour transférer vos données Jira Cloud vers certains AWS services ou d'autres applications compatibles. **Topics** + [AWS Glue prise en charge de Jira Cloud](jira-cloud-support.md) + [Politiques contenant les opérations API pour la création et l’utilisation des connexions](jira-cloud-configuring-iam-permissions.md) + [Configuration de Jira Cloud](jira-cloud-configuring.md) + [Configuration des connexions Jira Cloud](jira-cloud-configuring-connections.md) + [Lecture depuis les entités Jira Cloud](jira-cloud-reading-from-entities.md) + [Options de connexion Jira Cloud](jira-cloud-connection-options.md) + [Restrictions et remarques relatives au connecteur Jira Cloud](jira-cloud-connector-limitations.md) # AWS Glue prise en charge de Jira Cloud AWS Glue prend en charge Jira Cloud comme suit : **Prise en charge en tant que source ?** Oui. Vous pouvez utiliser des tâches AWS Glue ETL pour interroger des données depuis Jira Cloud. **Prise en charge en tant que cible ?** Non. **Versions d’API Jira Cloud prises en charge** Les versions d’API Jira Cloud suivantes sont prises en charge : + v3 Pour la prise en charge des entités par version spécifique, consultez [Lecture depuis les entités Jira Cloud](jira-cloud-reading-from-entities.md). # Politiques contenant les opérations API pour la création et l’utilisation des connexions L'exemple de politique suivant décrit les autorisations AWS IAM requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes : + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console. # Configuration de Jira Cloud Avant de pouvoir AWS Glue transférer des données depuis Jira Cloud vers des destinations prises en charge, vous devez satisfaire aux exigences suivantes : ## Configuration requise Les exigences minimales sont les suivantes : + Vous disposez d’un compte Atlassian dans lequel vous pouvez utiliser le produit logiciel Jira dans Jira Cloud. Pour de plus amples informations, veuillez consulter [Création d’un compte Jira Cloud](#jira-cloud-configuring-creating-jira-cloud-account). + Vous devez avoir créé un AWS compte avec l'accès au service à AWS Glue. + Cette application fournit les informations d'identification du client qui AWS Glue permettent d'accéder à vos données en toute sécurité lorsqu'elle passe des appels authentifiés vers votre compte. Pour plus d'informations, consultez [Enabling OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-) dans la documentation Atlassian Developer. Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Jira Cloud. ## Création d’un compte Jira Cloud Pour créer un compte Jira Cloud : 1. Accédez à [URL d’inscription Atlassian](https://id.atlassian.com/signup). 1. Saisissez votre adresse e-mail professionnelle et votre nom, puis choisissez **Accepter**. Vous recevez un e-mail de vérification. 1. Après avoir vérifié votre adresse e-mail, vous pouvez créer un mot de passe et choisir **S’inscrire**. 1. Saisissez votre nom d’utilisateur et votre mot de passe, puis choisissez **Se connecter**. 1. Vous êtes redirigé vers une page sur laquelle vous devez accéder à votre site. Saisissez le nom du site et choisissez **Accepter**. Une fois votre site Atlassian Cloud démarré, vous pouvez configurer votre Jira en répondant à quelques questions selon vos préférences en matière de type de projet. Pour vous connecter à un compte existant : 1. Accédez à l’[URL de connexion Atlassian](https://id.atlassian.com/login) et saisissez vos informations d’identification. 1. Saisissez votre e-mail et votre mot de passe, puis cliquez sur **Se connecter**. Vous êtes redirigé vers le tableau de bord Jira. ## Création d’une application dans Jira Cloud Pour créer une application dans Jira Cloud et obtenir l’ID client et le secret client auprès de l’application client gérée : 1. Accédez à l’[URL Jira Cloud](https://id.atlassian.com/login) et saisissez vos informations d’identification. 1. Choisissez **Create** et sélectionnez l'option **d'intégration OAuth 2.0**. 1. Saisissez le nom de l’application, consultez les **conditions générales** et choisissez **Créer**. 1. Accédez à la section **Distribution** dans le menu de gauche et choisissez **Modifier**. 1. Dans la section **Modifier les contrôles de distribution** : 1. Pour **ÉTAT DE DISTRIBUTION**, sélectionnez **Partage**. 1. Saisissez le nom du fournisseur. 1. Saisissez l’URL de votre **politique de confidentialité**. Par exemple, https://docs.aws.amazon.com/glue/ latest/dg/security -iam-awsmanpol.html 1. Saisissez l’URL de vos **conditions d’utilisation** (facultatif). 1. Saisissez l’URL de votre **contact du service client** (facultatif). 1. Sélectionnez dans la **DÉCLARATION Yes/No DE DONNÉES PERSONNELLES** et choisissez **Enregistrer les modifications**. 1. Accédez à **Autorisations** dans le menu de gauche de l’application correspondante. 1. Pour **API Jira**, choisissez **Ajouter**. Une fois ajoutée, choisissez l’option **Configuration**. 1. Dans la section **Portées classique** > **API REST de la plateforme Jira**, choisissez **Modifier les portées** et cochez toutes les portées. Cliquez sur **Sauvegarder** 1. Sous **Portées granulaires**, choisissez **Modifier les portées** et sélectionnez les portées suivantes : 1. Faites défiler la page vers le bas et trouvez des portées. Il existe deux types de portées que vous devez sélectionner sous les rubriques « CRM » et « Standard ». 1. Ajoutez les portées suivantes : ``` read:application-role:jira read:audit-log:jira read:avatar:jira read:field:jira read:group:jira read:instance-configuration:jira read:issue-details:jira read:issue-event:jira read:issue-link-type:jira read:issue-meta:jira read:issue-security-level:jira read:issue-security-scheme:jira read:issue-type-scheme:jira read:issue-type-screen-scheme:jira read:issue-type:jira read:issue.time-tracking:jira read:label:jira read:notification-scheme:jira read:permission:jira read:priority:jira read:project:jira read:project-category:jira read:project-role:jira read:project-type:jira read:project-version:jira read:project.component:jir read:project.property:jira read:resolution:jira read:screen:jira read:status:jira read:user:jira read:workflow-scheme:jira read:workflow:jira read:field-configuration:jira read:issue-type-hierarchy:jira read:webhook:jira ``` 1. Accédez à **Authentification** dans le menu de gauche, puis choisissez **Ajouter**. 1. Entrez une **URL de rappel** telle que oauth https://us-east-1.console.aws.amazon.com/gluestudio/ 1. Accédez à **Paramètres** dans le menu de gauche et faites défiler la page vers le bas pour les détails de **l’authentification**. Notez l’ID client et le secret client. # Configuration des connexions Jira Cloud Jira Cloud prend en charge le type de subvention AUTHORIZATION\$1CODE pour. OAuth2 + Ce type de subvention est considéré comme « à trois étapes » OAuth car il repose sur la redirection des utilisateurs vers un serveur d'autorisation tiers pour authentifier l'utilisateur. Il est utilisé lors de la création de connexions via la AWS Glue console. La AWS Glue console redirige l'utilisateur vers Jira Cloud où il doit se connecter et autoriser AWS Glue les autorisations demandées pour accéder à son instance Jira Cloud. + Les utilisateurs peuvent toujours choisir de créer leur propre application connectée dans Jira Cloud et de fournir leur propre identifiant client et leur secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés vers Jira Cloud pour se connecter et autoriser l'accès AWS Glue à leurs ressources. + Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès est de courte durée et peut être actualisé automatiquement sans interaction de l’utilisateur à l’aide du jeton d’actualisation. + Pour consulter la documentation publique de Jira Cloud sur la création d'une application connectée pour le OAuth flux de code d'autorisation, consultez [Enabling OAuth 2.0 (3LO](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-)). Pour configurer une connexion Jira Cloud : 1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes : 1. Pour l’application connectée gérée par le client, le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé. 1. Remarque : Vous devez créer un secret pour la connexion dans AWS Glue. 1. Dans AWS Glue Glue Studio, créez une connexion sous **Data Connections** en suivant les étapes ci-dessous : 1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez Jira Cloud. 1. Indiquez l’environnement Jira Cloud. 1. Sélectionnez le rôle AWS IAM qui AWS Glue peut assumer et dispose des autorisations nécessaires pour les actions suivantes : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons. 1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau. 1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`. # Lecture depuis les entités Jira Cloud **Prérequis** Un objet Jira Cloud à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet, comme Audit Record ou Issue. Le tableau suivant présente les entités prises en charge. **Entités prises en charge pour la source** : | Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge | | --- | --- | --- | --- | --- | --- | | Audit Record | Oui | Oui | Non | Oui | Oui | | Problème | Oui | Oui | Non | Oui | Oui | | Issue Field | Non | Non | Non | Oui | Non | | Issue Field Configuration | Oui | Oui | Non | Oui | Oui | | Issue Link Type | Non | Non | Non | Oui | Non | | Issue Notification Scheme | Oui | Oui | Non | Oui | Oui | | Issue Security Scheme | Non | Non | Non | Oui | Non | | Issue Type Scheme | Oui | Oui | Oui | Oui | Oui | | Issue Type Screen Scheme | Oui | Oui | Oui | Oui | Oui | | Issue Type | Non | Non | Non | Oui | Non | | Jira Setting | Oui | Non | Non | Oui | Non | | Jira Setting Advanced | Non | Non | Non | Oui | Non | | Jira Setting Global | Non | Non | Non | Oui | Non | | Étiquette | Non | Non | Non | Oui | Oui | | Myself | Oui | Non | Non | Oui | Non | | Autorisations | Non | Non | Non | Oui | Non. | | Project | Oui | Oui | Oui | Oui | Oui | | Project Category | Non | Non | Non | Oui | Non | | Type de projet | Non | Non | Non | Oui | Non | | Server Info | Non | Non | Non | Oui | Non | | Utilisateurs | Non | Non | Non. | Oui | Non | | Flux de travail | Oui | Oui | Oui | Oui | Oui | | Workflow Scheme | Non | Oui | Non | Oui | Oui | | Workflow Scheme Project Association | Oui | Non | Non | Oui | Non | | Workflow Status | Non | Non | Non | Oui | Non | | Workflow Status Category | Non | Non | Non | Oui | Non | **Exemple :** ``` jiracloud_read = glueContext.create_dynamic_frame.from_options( connection_type="JiraCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "audit-record", "API_VERSION": "v3" } ``` **Détails des entités et des champs Jira Cloud** : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/jira-cloud-reading-from-entities.html) ## Requêtes de partitionnement Vous pouvez indiquer l’option Spark supplémentaire `NUM_PARTITIONS` si vous souhaitez utiliser la simultanéité dans Spark. Avec ce paramètre, la requête d’origine serait divisée en `NUM_PARTITIONS` nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark. + `NUM_PARTITIONS` : le nombre de partitions. Exemple : ``` jiraCloud_read = glueContext.create_dynamic_frame.from_options( connection_type="JiraCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "issue", "API_VERSION": "v3", "NUM_PARTITIONS": "10" } ``` # Options de connexion Jira Cloud Les options de connexion pour Jira Cloud sont les suivantes : + `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Le nom de votre objet dans Jira Cloud. + `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Version d’API Rest Jira Cloud que vous souhaitez utiliser. Par exemple : v3. + `DOMAIN_URL`(Chaîne) - (Obligatoire) L’ID Jira Cloud que vous souhaitez utiliser. + `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet. + `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark. + `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète. + `NUM_PARTITIONS`(Entier) - Par défaut : 1. Utilisé pour la lecture. Nombre de partitions pour la lecture. # Restrictions et remarques relatives au connecteur Jira Cloud Voici les restrictions ou les remarques relatives au connecteur Jira Cloud : + L'`Contains`opérateur ne travaille pas avec le `resourceName` champ, qui est de type `String` donnée. + Par défaut, si aucun filtre explicite n'est appliqué, seuls les problèmes des 30 derniers jours seront analysés. Les utilisateurs ont la possibilité de remplacer ce filtre par défaut en spécifiant un filtre personnalisé.