Configurer Jira pour l'ingestion
Bêta
Cette fonctionnalité est en version bêta.
Cette page décrit comment configurer Jira pour l'ingestion dans Databricks.
Prérequis
Pour ingérer depuis Jira, vous devez disposer des éléments suivants :
- Un environnement Jira cloud ou un environnement Jira on-premise avec la version 8.22.x ou ultérieure.
- Privilèges d'administrateur de Workspace ou privilège
CREATE CONNECTIONsur le metastore Unity Catalog. - Identifiants OAuth 2.0 pour votre environnement Jira.
Configurez Jira pour OAuth
Préparez votre instance Jira pour l'ingestion. Vous pouvez soit ajouter les scopes requis à une application OAuth existante, soit créer une nouvelle application. Pour l'authentification OAuth machine-to-machine (M2M) sur Jira Cloud, configurez plutôt un compte de service. Voir Compte de service Jira Cloud (M2M).
Jira Cloud
-
Rendez-vous sur https://developer.atlassian.com/console/myapps/.
-
Vous pouvez éventuellement cliquer sur Créer > Intégration OAuth 2.0 pour créer une nouvelle application OAuth. Si vous préférez utiliser une application OAuth existante, ajoutez les champs d'application requis définis aux étapes 5 et 6.
-
Fournissez un nom pour l'intégration, puis cliquez sur **Créer**.
-
Visitez Permissions > API Jira (sous Portées d'API ) > Ajouter .
-
Cliquez sur Classic Scopes > Edit Scopes , puis ajoutez les champs d'application suivants à l'application OAuth :
read:jira-work, read:jira-user -
Cliquez sur Granular Scopes > Modifier les champs d'application , puis ajoutez les champs d'application suivants à l'application OAuth.
Tous les champs d'application OAuth ne sont pas requis pour toutes les tables Jira. Si votre organisation ne peut pas accorder certains périmètres (tels que les périmètres de niveau administrateur), vous pouvez toujours ingérer les tables qui n'en dépendent pas. Consultez les tables sources Jira prises en charge pour l'ingestion afin de vérifier les étendues requises pour chaque table.
read:project-role:jira, read:project-category:jira, read:user:jira, read:avatar:jira, read:sprint:jira-software, read:workflow:jira, read:board-scope:jira-software, read:issue-details:jira, read:project:jira, read:audit-log:jira, read:issue-security-level:jira, read:issue-security-scheme:jira, read:board-scope.admin:jira-software, read:group:jira, read:application-role:jira -
Accédez à Autorisation > Ajouter et saisissez l'URI de redirection comme suit :
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.htmlPar exemple :
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
Accédez à **Paramètres** et notez l'**ID client** et le **Secret du client**. Vous les utiliserez pour créer une connexion.
Compte de service Jira Cloud (M2M)
Utilisez cette configuration pour l’authentification machine-to-machine (M2M) OAuth. Databricks s’authentifie en tant que compte de service Atlassian à l’aide du flux d’identifiants client OAuth, de sorte que personne ne se connecte de manière interactive. M2M prend uniquement en charge Jira Cloud.
- Dans l'administration Atlassian, sélectionnez votre organisation, puis allez dans Répertoire > Comptes de service .
- Créez un compte de service ou sélectionnez-en un existant.
- Cliquez sur Créer des identifiants > OAuth 2.0 , puis sur Suivant .
- Sélectionnez les mêmes scopes classiques et granulaires que ceux listés aux étapes 5 et 6 dans Jira Cloud. Databricks ne demande pas de scopes dans le flux d’informations d’identification du client ; le jeton d’accès ne bénéficie donc que des scopes que vous attribuez à l’identification.
- Créez les identifiants et notez l' ID client et le secret client . Vous les utilisez pour créer une connexion. Atlassian ne montre plus le secret du client, alors stockez-le en toute sécurité.
- Donnez au compte de service l'accès à Jira et les permissions de projet dont il a besoin pour lire les données que vous souhaitez ingérer, telles que Parcourir les projets . Les portées ne remplacent pas les permissions Jira.
Pour plus de détails, voir Créer une identification OAuth 2.0 pour les comptes de service dans la documentation Atlassian.
Jira on-premise
Configurer OAuth
-
Ouvrir Jira Administration .
-
Accédez à Applications depuis l'icône des paramètres en haut à droite.
-
Ouvrez Applications > Link d'application pour afficher la liste des link d'application créés.
-
Cliquez éventuellement sur Create Link pour créer un nouveau application Link. Si vous préférez utiliser une application OAuth existante, ajoutez les étendues requises.
-
Sélectionnez **Application externe** comme type d'application et **Entrant** comme direction. Cliquez ensuite sur **Continuer**.
-
Fournissez un nom pour votre application externe et saisissez l'URL de redirection comme suit :
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.htmlPar exemple :
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
Définissez les autorisations d'application en tant qu' administrateur . Ensuite, cliquez sur Enregistrer .
-
Notez l' ID client et le Secret client . Vous utiliserez ces éléments pour créer une connexion.
Activer la suppression des problèmes dans les logs d'audit on-premise
Ces étapes ne s’appliquent que lorsque vous définissez use_audit_logs sur true dans le jira_options du pipeline pour suivre les suppressions pour la table issues. Pour plus d’informations, consultez Suivre les suppressions pour la table des problèmes.
Parfois, les suppressions d'éléments ne sont pas présentes dans les Logs d'audit sur une instance on-premise. Pour augmenter la couverture des logs d'audit dans ces scénarios :
- Accédez à Jira Administration > Système .
- Ouvrez Audit Logs sous Résolution des problèmes à gauche, et réglez ces trois zones sur Avancé :
- Configuration et administration mondiales
- Configuration et administration locales
- Activité de l'utilisateur final