Jira Data Center Microsoft 365 Copilot コネクタを使用すると、organizationで Jira Data Center の問題と関連するプロジェクト データにインデックスを付け、Microsoft 365 および Microsoft Search エクスペリエンスで検出およびアクション可能になります。 この記事では、Jira Data Center コネクタをデプロイしてカスタマイズする手順について説明します。
前提条件
コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
Microsoft 365 管理者である必要があります。
Jira Data Center インスタンスと同じネットワーク内の Windows コンピューターに Microsoft Graph コネクタ エージェント をインストールします。 エージェントが既にインストールされている場合は、バージョン 3.1.15.0 以降を実行していることを確認します。
Atlassian Marketplace のMicrosoft 365 Copilot コネクタの一覧から Jira Data Center プラグインをインストールします。
注:
このプラグインは、Jira Data Center バージョン 8.10.0 から 10.5.1 をサポートしています。
次の表に示すアクセス許可を使用してサービス アカウントを構成します。
アクセス許可名 アクセス許可の種類 以下に必須 プロジェクトを参照する プロジェクトのアクセス許可 クロール Jira の問題 (必須)。 問題レベルのセキュリティ 問題レベルのセキュリティ セキュリティ レベルを使用した問題の種類のクロール (省略可能)。 ユーザーとグループを参照する グローバル アクセス許可 このデータ ソースへのアクセス権を持つユーザーのみが選択されている場合のセキュリティ トリミング (省略可能)。 Jira を管理する グローバル アクセス許可 厳密なアクセス制御マッピングを適用する場合に必要です (省略可能)。 制限のない要求を許可して調整を防ぎます。 [ System>Rate limiting>Exemptions>Add exemptions, add the service account to the exemptions list.
コネクタをデプロイする
organizationの Jira Data Center コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
- 使用可能なコネクタの一覧から、[ Jira Data Center] を選択します。
表示名を設定する
表示名は、Copilot 応答のコンテンツ ソースを識別します。 既定の Jira データ センター 名をそのまま使用することも、ユーザーがデータ ソースを認識できるようにカスタマイズすることもできます。
インスタンス URL の設定
Jira Data Center インスタンスの URL を入力します。 一般的な形式は、 https://jira.<your-domain>.comです。
認証の種類を選択する
Jira アプリケーション リンクを使用して OAuth 2.0 認証を構成します。
Jira で OAuth を構成するには:
Jira Data Center にサインインします。
[設定>Applications>Application のリンクに移動します。
[ 作成] リンクを選択します。
[ 外部アプリケーション] を選択し、方向として [ 受信 ] を選択します。
[ 受信リンクの構成] フォームに 入力します。
-
リダイレクト URL:
- エンタープライズ:
https://gcs.office.com/v1.0/admin/oauth/callback - Government Community Cloud High (GCC High):
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- エンタープライズ:
- スコープ: 管理
-
リダイレクト URL:
[クライアント ID] と [シークレット] をコピーし、[Microsoft 365 管理センター接続セットアップ] ページに貼り付けます。
ロールアウト
完全なロールアウトの前に接続を検証するには、[ 制限付き対象ユーザーへのロールアウト] を選択し、段階的な展開のユーザーまたはグループを指定します。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。
[ 作成] を 選択してコネクタをデプロイします。 Jira Data Center コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、コネクタが適用する既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| Users | アクセス許可: このデータ ソースへのアクセス権を持つユーザーのみ。ID は、Microsoft Entra IDを使用してマップされます。 |
| Content | 既定でインデックスが作成されたすべてのプロジェクト。既定のプロパティ スキーマが適用されます。 |
| Sync | 増分クロールは 15 分ごとに行われます。フル クロールを毎日行います。 |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Jira Data Center コネクタの設定をカスタマイズできます。
ユーザー設定をカスタマイズする
アクセス許可
コネクタでは、次の 2 つのアクセス オプションがサポートされています。
- すべてのユーザー
- このデータ ソースにアクセスできるユーザーのみ (推奨)
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、コネクタによって、問題レベルのセキュリティやプロジェクトのアクセス許可など、Jira アクセス許可モデルが適用されます。 Jira 電子メール ID がユーザー プリンシパル名 (UPN) の値Microsoft Entra ID異なる場合は、ID マッピングが必要です。
コネクタでは、次の階層が使用されます。
- 問題のセキュリティ レベル (優先度が最も高い): 設定した場合、アクセスはそのレベルのユーザーに制限されます。
- プロジェクト レベルのアクセス許可へのフォールバック: セキュリティ レベルが設定されていない場合、アクセスは [プロジェクトの参照 ] アクセス許可によって決まります。
ID のマッピング
制限付きアクセス許可を使用する場合は、次のいずれかの方法で Jira ID を Microsoft 365 ID にマップします。
- Microsoft Entra ID: Jira ユーザーの電子メール ID がMicrosoft Entra IDの UPN と同じ場合は、このオプションを選択します。
- 非 Entra ID: ID が異なる場合は、このオプションを選択します (正規表現規則が必要です)。
コンテンツ設定をカスタマイズする
データをフィルター処理する
タイムスタンプの作成または更新、または JQL を使用して、問題をフィルター処理できます。 例: project = "PROJ" AND updated >= -30d。
プロパティの管理
インデックスを作成する Jira フィールド (スキーマ プロパティ) を選択します。 組み込みの Jira フィールドを含めたり、カスタム フィールドを追加したりできます。 詳細については、「 検索スキーマの管理」を参照してください。 既定では、次のプロパティにインデックスが付けられます。
| Source プロパティ | セマンティック ラベル | Schema |
|---|---|---|
| AssigneeEmailId | クエリ、取得、検索 | |
| AssigneeName | クエリ、取得、検索 | |
| ブロック | ブロック | クエリ、取得 |
| 作成済み | 作成日時 | 取得 |
| DueDate | 取得 | |
| IssueDescription | 検索 | |
| IssueIconUrl | IconUrl | 取得 |
| IssueId | 取得 | |
| IssueKey | クエリ、取得、検索 | |
| IssueLink | Url | クエリ、取得、検索 |
| IssuePriority | クエリ、取得、検索 | |
| IssueStatus | クエリ、取得 | |
| IssueSummary | 検索 | |
| IssueType | クエリ、取得 | |
| ラベル | クエリ、取得 | |
| ProjectName | クエリ、取得 | |
| ReporterEmailId | 作成者 | クエリ、取得、検索 |
| ReporterName | クエリ、取得、検索 | |
| タイトル | タイトル | クエリ、取得、検索 |
| 更新あり | 最終更新日時 | クエリ、取得 |
同期間隔をカスタマイズする
データ更新のニーズに合わせてクロールの頻度を調整できます。 既定値は次のとおりです。
- フル クロール: 毎日
- 増分クロール: 15 分ごとに
詳細については、「 同期設定のガイドライン」を参照してください。