Atlassian Jira Cloud Microsoft Graph コネクタ

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

この記事は、Microsoft 365 管理者、または Jira クラウド Graph コネクタを構成、実行、監視するユーザーを対象とします。

重要

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

機能

  • Jira クラウドからのインデックスの問題 (またはチケット)
  • エンド ユーザーが Copilot でのプロジェクトの追跡、サポート クエリ、タスク実行に関連する質問を行えるようにします。
    • モバイル アプリが読み込まれていない問題を見つけます。
    • John によって報告された Jira タスクを探して、API の移行に関するドキュメントを更新します。
    • CP-1234 を要約します。
  • Copilot のセマンティック検索を使用して、ユーザーがキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを検索できるようにします。

制限事項

  • コネクタでは、ユーザーに問題のアクセスを許可する "ログインしたすべてのユーザー" アプリケーション ロールはサポートされていません。
  • コネクタは添付ファイルのインデックスを作成しません。

前提条件

  • organizationの Microsoft 365 テナントの検索管理者である必要があります。

  • Jira クラウド インスタンス URL: Jira データに接続するには、organizationの Jira インスタンス URL が必要です。 通常、organizationの Jira インスタンス URL はhttps://<your-organization-domain>.atlassian.netのようになります。 インスタンスがまだない場合は、 ページ を参照してテスト インスタンスを作成します。

  • サービス アカウント: Jira に接続し、Microsoft Graph Connector で問題を定期的に更新できるようにするには、次のアクセス許可が付与されたサービス アカウントが必要です。

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

はじめに

Microsoft Graph Connector for Jira cloud の接続作成画面を示すスクリーンショット。

1. 表示名

表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。

2. Jira クラウド URL

Jira クラウド データに接続するには、organizationの Jira インスタンス URL が必要です。 通常、organizationの Jira インスタンス URL はhttps://<your-organization-domain>.atlassian.netのようになります。

3. 認証の種類

Jira から問題を認証して同期するには、サポートされている 2 つの方法のいずれかを 選択します。

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

b. Atlassian Jira OAuth 2.0 (推奨)
認証に Jira OAuth を使用するには、次の手順に従います。

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

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

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

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

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

  4. 左側のナビゲーション ウィンドウから Permissions に移動します。 Jira APIAddを選択し、[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/callbackM365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback のコールバック URL を追加し、変更を保存します。

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

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

注意

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

4. 限定対象ユーザーにロールアウトする

ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 制限付きロールアウトの詳細については、「 段階的なロールアウト」を参照してください。

この時点で、Jira クラウドの接続を作成する準備ができました。 [ 作成 ] をクリックして、接続とインデックスの問題を Jira アカウントから発行できます。

アクセス許可データ包含ルールスキーマクロール頻度などの他の設定については、Jira データで最適に動作するものに基づいて既定値が設定されています。 既定値は次のとおりです。

ユーザー 説明
アクセス許可 データ ソース内のコンテンツにアクセスできるユーザーのみ。
ID のマップ Microsoft Entra ID を使用してマップされたデータ ソース ID。
コンテンツ 説明
サイト プロジェクト すべてのプロジェクトにインデックスが作成されます。
データをフィルター処理する すべての問題にインデックスが作成されます。 時間フィルターまたは JQL 条件は適用されません。
プロパティの管理 既定のプロパティとそのスキーマをチェックするには、コンテンツに関するページを参照してください
同期 説明
増分クロール 頻度: 15 分ごと
フル クロール 頻度: 毎日

これらの値のいずれかを編集する場合は、"カスタム セットアップ" オプションを選択する必要があります。

カスタム セットアップ

カスタム セットアップは、上記の表に示した設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。

ユーザー

アクセス許可とユーザー マッピング ルールを構成できる [ユーザー] タブを示すスクリーンショット。

アクセス許可

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

重要

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

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

マッピング ID

データ ソース ID を Microsoft Entra ID とマッピングするための既定の方法は、Jira ユーザーのEmail ID が、Microsoft Entraのユーザーの UserPrincipalName (UPN) または Mail と同じかどうかを確認することです。 既定のマッピングがorganizationに対して機能しないと思われる場合は、カスタム マッピング式を指定できます。 非Microsoft Entra ID ID のマッピングの詳細については、「Azure AD 以外の ID をマップする」を参照してください。

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

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

注意

アクセス許可を管理するグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、アクセス許可に対する更新の処理はサポートされていません。

コンテンツ

プロジェクトの選択とデータのフィルター処理

  1. サイト プロジェクト

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

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

    • 個々のプロジェクトを選択すると、選択したプロジェクトの Jira Issue のみがインデックス付けされます。

    注意

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

  2. データをフィルター処理する

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

    • 問題が 変更された期間を指定します。 このオプションでは、現在のクロールに基づいて ローリングベース で選択された期間内に作成または変更された Jira の問題のみがインデックス化されます。

    ヒント

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

プロパティの管理

ここでは、使用可能なプロパティを Jira データ ソースに追加または削除し、プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加できます。 既定で選択されているプロパティを次に示します。

Source プロパティ Label 説明 Schema
ブロック ブロック データ ソース内のアイテムに参加/共同作業を行ったすべてのユーザーに名前を付けます 取り戻す
作成済み 作成日時 データ ソースでアイテムが作成されたデータと時刻 クエリ、取得
IssueDescription コンテンツ 問題の説明 検索
IssueIconURL IconUrl 問題の種類を表すアイコン URL。 取り戻す
IssueId
IssueKey
IssueLink url データソース内のアイテムのターゲット URL クエリ、取得
IssueStatus クエリ
IssueSummary
ProjectName クエリ
ReporterEmailId 作成者 取り戻す
ReporterName クエリ、取得
タイトル タイトル Copilot やその他の検索エクスペリエンスに表示するアイテムのタイトル 検索、クエリ、取得
更新あり 最終更新日時 データ ソースでアイテムが最後に変更された日時。 クエリ、取得

注意

  • Atlassian Jira コネクタでは、既定の問題フィールドとカスタムで作成された問題フィールドの両方にインデックスを付けることができます。
  • 選択したユーザー設定の作成フィールドが一部の Jira の問題の種類に存在しない場合、フィールドは NULL (空白) として取り込まれます。

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

データのプレビュー

プレビュー結果ボタンを使用して、選択したプロパティとクエリ フィルターのサンプル値を確認します。

同期

クロール頻度を構成できる [同期] タブを示すスクリーンショット。

更新間隔によって、データ ソースと Graph コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。

必要に応じて、ここから更新間隔の既定値を変更できます。

検索結果ページを設定する

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

トラブルシューティング

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

その他の問題がある場合、またはフィードバックを提供したい場合は、 Microsoft Graph サポートにお問い合わせください。