Atlassian Jira Cloud Microsoft Graph コネクタ

  • [アーティクル]

Atlassian Jira Cloud Microsoft Graph コネクタを使用すると、組織は Jira の問題のインデックスを作成できます。 Jira サイトからコネクタとインデックス コンテンツを構成した後、エンド ユーザーは Microsoft Search でそれらのアイテムを検索できます。

注:

一般的な コネクタのセットアップ手順については、Microsoft 365 管理センターの Microsoft Graph コネクタのセットアップに関する記事を参照してください。

この記事は、Atlassian Jira Cloud コネクタを構成、実行、監視するユーザーを対象とします。 一般的なセットアップ プロセスを補完し、Atlassian Jira Cloud コネクタにのみ適用される手順を示します。

重要

Atlassian Jira Cloud コネクタは、Jira クラウドでホストされるインスタンスのみをサポートします。 このコネクタでは、Jira Server と Jira Data Center のバージョンはサポートされていません。

使用を開始する前に

組織の Microsoft 365 テナントの管理者であり、組織の Jira サイトの管理者である必要があります。

コネクタの構成中に資格情報が使用されるユーザー アカウントに付与される次のアクセス許可が必要です。

アクセス許可名 アクセス許可の種類 に必要です
プロジェクトを参照する プロジェクトのアクセス許可 クロールの Jira の問題。 このアクセス許可は、インデックスを作成する必要があるプロジェクトに 必須 です。
問題レベルのセキュリティアクセス許可 問題レベルのセキュリティ さまざまな問題の種類をクロールする。 このアクセス許可は 省略可能です。
ユーザーとグループを参照する グローバル アクセス許可 検索結果の ACL トリミング。 このアクセス許可は 省略可能 であり、以下の手順 4 でオプション Only people with access to this data source 選択する必要があります。
Jira を管理する グローバル アクセス許可 検索結果の ACL トリミング。 このアクセス許可は 省略可能 であり、以下の手順 4 でオプション Only people with access to this data source 選択する必要があります。

手順 1: Microsoft 365 管理センターにコネクタを追加する

Jira コネクタを追加する

一般的な セットアップ手順に従います。

手順 2: 接続に名前を指定する

一般的な セットアップ手順に従います。

手順 3. 接続設定を構成する

Jira サイトに接続するには、Jira サイトの URL を使用します。 通常、Jira クラウド サイトの URL は https://<organization_name>.atlassian.net/ のようになります。 基本認証または OAuth 2.0 (推奨) のいずれかを選択して、Jira サイトに対する認証を行うことができます。

Basic Auth

アカウントのユーザー名 (通常はメール ID) と API トークンを入力して、基本認証を使用して認証します。API トークンの生成の詳細については、Atlassian アカウントの API トークンを管理する方法に関 する Atlassian のドキュメントを参照してください。

OAuth 2.0

Microsoft Search アプリがインスタンスにアクセスできるように、Atlassian Jira にアプリを登録します。 詳細については、 OAuth 2.0 を有効にする方法に関する Atlassian サポート ドキュメントを参照してください。

次の手順では、アプリを登録する方法に関するガイダンスを提供します。

  1. Atlassian Jira 管理者アカウントで Atlassian Developer コンソール にサインインします。

  2. [ Create ] を選択し、[ OAuth 2.0 integration] を選択します。

  3. アプリケーションに適切な名前を指定し、新しいアプリを作成します。

  4. 左側のナビゲーション ウィンドウから Permissions に移動します。 [詳細なアクセス許可] ヘッダーで、Jira APIの [Add] を選択します。 追加したら、 Configure を選択し、次のスコープを追加します。

    # スコープ名 コード
    1 フィールドの表示 read:field:jira
    2 アバターを表示する read:avatar:jira
    3 プロジェクト カテゴリを表示する read:project-category:jira
    4 プロジェクトを表示する read:project:jira
    5 フィールド構成の読み取り read:field-configuration:jira
    6 問題の種類を表示する read:issue-type:jira
    7 プロジェクトのプロパティを表示する read:project.property:jira
    8 ユーザーの表示 read:user:jira
    9 アプリケーション ロールを表示する read:application-role:jira
    10 グループの表示 read:group:jira
    11 問題の種類の階層を読み取る read:issue-type-hierarchy:jira
    12 プロジェクトのバージョンを表示する read:project-version:jira
    13 プロジェクト コンポーネントを表示する read:project.component:jira
    14 問題の詳細を表示する read:issue-details:jira
    15 監査ログを表示する read:audit-log:jira
    16 問題のメタを表示する read:issue-meta:jira
    17 プロジェクト ロールを表示する read:project-role:jira
    18 問題のセキュリティ レベルを表示する read:issue-security-level:jira
    19 問題のセキュリティ スキームを表示する read:issue-security-scheme:jira
    20 アクセス許可スキームを表示する read:permission-scheme:jira
    21 アクセス許可の表示 read:permission:jira

  5. 左側のナビゲーション ウィンドウから Authorization に移動します。 M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback、M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback のコールバック URL を追加し、変更を保存します。

  6. 左側のナビゲーション ウィンドウから Settings に移動します。 このページから Client ID と Secret を取得します。

[クライアント ID] と [シークレット] を使用して、接続設定の手順を完了します。

注:

  • Jira のアクセス許可の詳細については、OAuth 2.0 アプリの スコープの一覧 を参照してください。
  • 元の (クラシック) OAuth アクセス許可は、Jira クラウドでは非推奨になっています。 詳細については、 変更ログのお知らせ を参照してください。

手順 3a: データを構成する: プロジェクトを選択する

接続のインデックスを作成するには、Jira サイト全体または特定のプロジェクトのみを選択できます。

  • Jira サイト全体のインデックスを作成する場合、サイト内のすべてのプロジェクトの Jira の問題にインデックスが作成されます。 新しいプロジェクトと問題は、作成後の次のクロール中にインデックスが作成されます。
  • 個々のプロジェクトを選択すると、それらのプロジェクトの Jira の問題のみがインデックス付けされます。

注:

[ プロジェクトの参照 ] アクセス許可を Jira プロジェクトに付与すると、そのプロジェクトが一覧表示され、クロールできます。 プロジェクトが見つからない場合は、アカウントのアクセス許可を確認します。

さらに、インデックスが作成される Jira の問題を 2 つの方法でフィルター処理することもできます。

  • 問題が 変更された期間を指定します。 これにより、現在のクロールに基づいて ローリングベース で選択された期間内に作成または変更された Jira の問題のみがインデックス化されます。
  • JQL を指定します。 これにより、指定された Jira クエリ言語 (JQL) に基づいてフィルター処理した後に返される Jira の問題のみがインデックス化されます。 JQL の使用の詳細については、Jira クエリ言語での高度な検索の使用に関する Atlassian サポート ドキュメントを参照してください。

ヒント

JQL フィルターを使用して、"issueType in (バグ,改善)" を使用して、特定の Jira イシューの種類にのみインデックスを作成できます

手順 3b: データを構成する: プロパティを選択する

先に進む前に、これらのフィールドのデータにインデックスを付けてプレビューするフィールドを選択します。 一部のフィールドは既定で既に選択されており、削除できません。

Atlassian Jira コネクタでは、既定の問題フィールドとカスタムで作成された問題フィールドの両方にインデックスを付けることができます。

ここで選択するプロパティの一覧は、Copilot for Microsoft 365 で結果をフィルター処理、検索、表示する方法に影響する可能性があります。

Source プロパティ Label 説明
ブロック authors データ ソース内のアイテムに参加または共同作業を行ったユーザーの名前。
作成済み createdDateTime データ ソースでアイテムが作成された日付と時刻。
IssueIconUrl iconUrl 特定の問題の優先度を持つ関連付けられたアイコン URL。
IssueLink url データソース内のアイテムのターゲット URL。
ReporterEmailId createdBy データソースでアイテムを最後に編集したユーザーの名前。
タイトル title 検索と他のエクスペリエンスに表示したいアイテムのタイトル。
更新あり lastModifiedDateTime データ ソースでアイテムが最後に変更された日時。

注:

選択したユーザー設定の作成フィールドが一部の Jira の問題の種類に存在しない場合、フィールドは NULL (空白) として取り込まれます。

手順 4: 検索アクセス許可を管理する

Atlassian Jira コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 Atlassian Jira では、サイト レベルのグループとプロジェクト ロールを含むプロジェクト権限スキームを使用してセキュリティアクセス許可が定義されます。 問題レベルのセキュリティは、問題レベルのアクセス許可スキームを使用して定義することもできます。

重要

Jira cloud Graph コネクタは、Microsoft Search でセキュリティアクセス許可を適切に割り当てるために、Jira でユーザーの電子メール ID を読み取ることができる必要があります。 これには、次のいずれかを確認する必要があります。

  • すべてのユーザーは、プロファイルの可視性設定に [すべてのユーザー] オプションを選択している必要があります。 プロファイルの可視性設定の詳細については、 Atlassian のドキュメントを参照してください。
  • "マネージド アカウント" を使用している組織の場合 (確認済みドメインのメール アドレスを持つ Atlassian アカウントはすべて、マネージド アカウントになります。詳細については 、こちらのドキュメント を参照してください) -
  • マネージド アカウントの一部であるすべてのユーザーは、プロファイルの可視性設定でマネージド アカウント設定を選択する必要があります。
  • マネージド アカウント (クロール アカウントと同じ) に属していないユーザーは、プロファイルの可視性設定で [すべてのユーザー] を選択する必要があります。
  • 接続構成中に使用されるクロール アカウントには、マネージド アカウント ドメインが必要です。

[このデータ ソースへのアクセス権を持つユーザーのみ] を選択した場合は、Jira サイトに Microsoft Entra ID プロビジョニング済みユーザーと Azure 以外の AD ユーザーのどちらを持っているかをさらに選択する必要があります。

組織に適したオプションを特定するには:

  1. Jira ユーザーのメール ID が Microsoft Entra ID のユーザーの UserPrincipalName (UPN) と 同じである 場合は、Microsoft Entra ID オプションを選択します。
  2. Jira ユーザーのメール ID が Microsoft Entra ID のユーザーの UserPrincipalName (UPN) と異なる場合は、[Azure 以外の AD] オプションを選択します。

注:

  • ID ソースの種類として Microsoft Entra ID を選択した場合、コネクタは Jira から直接取得したユーザーの電子メール ID を Microsoft Entra ID から UPN プロパティにマップします。
  • ID の種類に "非 Azure AD" を選択した場合は、ID のマッピング手順については、「Azure 以外の AD ID をマップする](map-non-Azure AD.md)」を参照してください。 このオプションを使用して、メール ID から UPN へのマッピング正規表現を指定できます。
  • アクセス許可を管理するユーザーまたはグループの更新は、フル クロールでのみ同期されます。 増分クロールでは、現在、アクセス許可に対する更新の処理はサポートされていません。

手順 5: プロパティ ラベルを割り当てる

一般的な セットアップ手順に従います。

手順 6: スキーマを管理する

一般的な セットアップ手順に従います。

手順 7: 更新設定を選択する

Atlassian Jira コネクタは、完全クロールと増分クロールの両方の更新スケジュールをサポートします。 推奨されるスケジュールは、増分クロールの場合は 1 時間、フル クロールの場合は 1 日です。

手順 8: 接続を確認する

一般的な セットアップ手順に従います。

接続を発行したら、検索結果ページをカスタマイズする必要があります。 検索結果のカスタマイズについては、「検索結果 のカスタマイズ」ページを参照してください。

手順 9: 検索結果ページを設定する

接続を発行した後、バーティカルや結果の種類を使用して検索結果ページをカスタマイズする必要があります。 検索結果のカスタマイズについては、垂直方向と結果の種類を管理する方法に関するページを参照してください。 Jira コネクタの サンプル結果レイアウト を使用することもできます。 開始するには、結果レイアウト JSON をコピーして貼り付けるだけです。

制限事項

Atlassian Jira コネクタの既知の制限事項を次に示します。

  • コネクタでは、問題へのアクセスを許可する "ログインしたすべてのユーザー" アプリケーション ロールはサポートされていません。
  • Jira Server と Data Center のバージョンはサポートされていません。

トラブルシューティング

接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。 よく見られる問題のトラブルシューティング手順 については、こちらを参照してください。

その他の問題がある場合、またはフィードバックを提供したい場合は、 aka.ms/TalkToGraphConnectors にお問い合わせください。