Jira の取り込み設定
ベータ版
この機能はベータ版です。
このページでは、Databricks への取り込み用に Jira を構成する方法について説明します。
前提条件
Jira から取り込むには、次のものが必要です。
- バージョン 8.22.x 以降の Jira クラウド環境または Jira オンプレミス環境。
- ワークスペース管理者権限、またはUnity Catalogメタストアに対する
CREATE CONNECTION権限。 - Jira 環境の OAuth 2.0 認証情報。
Jira を OAuth 用に設定する
Jiraインスタンスで取り込みの準備をします。既存のOAuthアプリに必要なスコープを追加するか、新しいアプリを作成することができます。Jira クラウドでOAuthマシン間(M2M)認証を使用するには、代わりにサービスアカウントをセットアップしてください。Jira クラウドサービスアカウント(M2M)を参照してください。
ジラクラウド
-
https://developer.atlassian.com/console/myapps/にアクセスしてください。
-
必要に応じて、 [作成] > [OAuth 2.0 統合] をクリックして、新しい OAuth アプリを作成します。既存のOAuthアプリを使用する場合は、ステップ 5 と 6 で定義されている必要なスコープを追加します。
-
統合の名前を入力し、 「作成」 をクリックします。
-
[権限] > [Jira API] ( [API スコープ] の下) > [追加] にアクセスします。
-
[クラシック スコープ] > [スコープの編集] をクリックし、次のスコープを OAuth アプリに追加します。
read:jira-work, read:jira-user -
「詳細なスコープ」 > 「スコープの編集」 をクリックし、次のスコープを OAuth アプリに追加します。
すべての Jira テーブルにすべての OAuth スコープが必要なわけではありません。組織が特定のスコープ (管理者レベルのスコープなど) を付与できない場合でも、それらのスコープに依存しないテーブルを取り込むことはできます。各テーブルに必要なスコープを確認するには、 「取り込みにサポートされている Jira ソース テーブル」を参照してください。
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 -
[承認] > [追加] に移動し、次のようにリダイレクト URI を入力します。
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html例えば:
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
[設定] に移動して、 クライアント ID と クライアント シークレット を書き留めます。これらを使用して接続を作成します。
Jira クラウドサービスアカウント (M2M)
OAuthマシン間(M2M)認証には、このセットアップを使用します。DatabricksはOAuthクライアント認証情報フローを使用してAtlassianサービスアカウントとして認証されるため、対話形式でサインインする必要はありません。M2MはJira クラウドのみをサポートします。
- Atlassian Administrationで組織を選択し、 Directory > サービスアカウント に移動します。
- サービスアカウントを作成するか、既存のアカウントを選択します。
- 認証情報の作成 > OAuth 2.0 をクリックし、 次へ をクリックします。
- Jira クラウドのステップ5と6でリストされているものと同じクラシックかつ詳細なスコープを選択します。Databricksはクライアント資格情報フローでスコープをリクエストしないため、アクセストークンは資格情報に割り当てたスコープのみを取得します。
- 資格情報を作成し、 クライアント ID と クライアント シークレット をメモします。これらを使用して接続を作成します。Atlassianはクライアント シークレットを再表示しないため、安全に保管してください。
- サービスアカウントにJiraへのアクセス権と、取り込みたいデータを読み取るために必要なプロジェクト権限( プロジェクトの参照 など)を付与します。スコープはJiraの権限に取って代わるものではありません。
詳細については、AtlassianドキュメントのサービスアカウントのOAuth 2.0認証情報を作成するを参照してください。
ジラ・オンプレミス
OAuthを構成する
-
Jira 管理を 開きます。
-
右上の設定アイコンから アプリケーションに アクセスします。
-
作成されたアプリケーション リンクの一覧を表示するには、 [アプリケーション] > [アプリケーション リンク] を開きます。
-
必要に応じて、 「リンクの作成」 をクリックして新しいアプリケーション リンクを作成します。既存の OAuth アプリを使用する場合は、必要なスコープを追加します。
-
アプリケーションの種類として 「外部アプリケーション」 を選択し、方向として 「受信」を 選択します。次に 「続行」 をクリックします。
-
外部アプリケーションの名前を指定し、次のようにリダイレクト URL を入力します。
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html例えば:
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
アプリケーションの権限を 管理者 として設定します。次に、 「保存」 をクリックします。
-
クライアント ID と クライアント シークレット を書き留めます。これらを使用して接続を作成します。
オンプレミスの監査ログで問題の削除を有効にする
これらのステップは、issuesテーブルの削除を追跡するために、パイプラインのjira_optionsでuse_audit_logsをtrueに設定した場合にのみ適用されます。詳細については、issuesテーブルの削除を追跡するを参照してください。
場合によっては、オンプレミス インスタンスの監査ログに問題の削除が記録されないことがあります。このようなシナリオで監査ログの範囲を拡大するには、次の手順を実行します。
- Jira 管理 > システム に移動します。
- 左側の 「トラブルシューティング」 の下にある 「監査ログ」 を開き、次の 3 つの領域を 「詳細」 に設定します。
- グローバル構成と管理
- ローカル構成と管理
- エンドユーザーのアクティビティ