Configurer Jira pour l'ingestion

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

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 CONNECTION sur 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 portées requises à une application OAuth existante, soit créer une nouvelle application.

Jira Cloud

1. Rendez-vous sur https://developer.atlassian.com/console/myapps/.

2. 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.

3. Fournissez un nom pour l'intégration, puis cliquez sur **Créer**.

4. Visitez Permissions > API Jira (sous Portées d'API ) > Ajouter .

5. Cliquez sur Classic Scopes > Edit Scopes , puis ajoutez les champs d'application suivants à l'application OAuth :

   read:jira-work, read:jira-user

6. 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: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

7. Accédez à Autorisation > Ajouter et saisissez l'URI de redirection comme suit :

   https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html

   Par exemple :

   https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html

8. Accédez à **Paramètres** et notez l'**ID client** et le **Secret du client**. Vous les utiliserez pour créer une connexion.

Jira on-premise

Configurer OAuth

1. Ouvrir Jira Administration .

2. Accédez à Applications depuis l'icône des paramètres en haut à droite.

3. Ouvrez Applications > Link d'application pour afficher la liste des link d'application créés.

4. 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.

5. Sélectionnez **Application externe** comme type d'application et **Entrant** comme direction. Cliquez ensuite sur **Continuer**.

6. Fournissez un nom pour votre application externe et saisissez l'URL de redirection comme suit :

   https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html

   Par exemple :

   https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html

7. Définissez les autorisations d'application en tant qu' administrateur . Ensuite, cliquez sur Enregistrer .

8. 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

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 :

1. Accédez à Jira Administration > Système .
2. 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

Étapes suivantes

• Créer une connexion