Confluence オンプレミス コネクタを使用すると、Microsoft 365 はセルフホステッド Confluence Data Center または Server インスタンスからコンテンツのインデックスを作成して取得できます。 エンタープライズ Wiki コンテンツを Microsoft Search と Copilot に取り込み、Microsoft 365 エコシステム内の可視性と使いやすさを強化します。
この記事では、Confluence オンプレミス コネクタをデプロイ、カスタマイズ、トラブルシューティングする手順について説明します。 Copilot コネクタのデプロイに関する一般的な情報については、Microsoft 365 管理センターでの Copilot コネクタのセットアップに関するページを参照してください。
Confluence オンプレミスの詳細な構成情報については、「 コネクタ インジェスト用に Confluence オンプレミス サービスを設定する」を参照してください。
前提条件
Confluence オンプレミス コネクタをデプロイする前に、Confluence 環境がorganizationで構成されていることを確認します。 次の表は、Confluence 環境を構成し、コネクタをデプロイする手順をまとめたものです。
| 役割 | タスク |
|---|---|
| Confluence 管理者 | 環境を構成する |
| Confluence admin/Network admin | 前提条件を設定する |
| Microsoft 365 管理者 | Microsoft 365 管理センターにコネクタをデプロイする |
| Microsoft 365 管理者 | コネクタの設定をカスタマイズ する (省略可能) |
コネクタをデプロイする前に、次の前提条件が満たされていることを確認します。
- Microsoft 365 管理者である必要があります。
- Confluence サーバーと同じネットワーク上の Windows コンピューターに Graph コネクタ エージェント (GCA) をインストールします。
- Atlassian Marketplace から Confluence On-prem プラグインをインストールします。
- Confluence Mobile Web プラグインがインストールされ、有効になっていることを確認します。
- Confluence 管理者のアクセス許可で認証資格情報を使用できることを確認します。
- Confluence バージョンが 8.0 以上であることを確認します。
コネクタをデプロイする
organizationの Confluence オンプレミス コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
- 使用可能なコネクタの一覧から、[ Confluence On-premises]\(オンプレミス\) を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。
既定の Confluence オンプレミスの表示名をそのまま使用することも、organizationのユーザーが認識する名前を使用するように値をカスタマイズすることもできます。
詳細については、「Microsoft 365 Copilot コネクタ コンテンツを使用した Copilot 検出の強化」を参照してください。
インスタンス URL の設定
Confluence サイトに接続するには、organizationのサイト インスタンス URL を使用します。 一般的な形式は次のとおりです。
https://<your-company-domain>/confluence
インスタンス URL を見つけるには:
- Confluence 管理 コンソールで、全般構成>Server Base URL に移動します。
認証の種類を選択する
コネクタでは、次の認証方法がサポートされています。
- 基本認証: Confluence ユーザー名とパスワードを使用します。
- OAuth 1.0a: 公開キーと秘密キーのペアを生成し、アプリケーション リンクを作成します。 詳細については、「 OAuth」を参照してください。
- OAuth 2.0 (推奨): 受信アプリケーション リンクを管理者スコープに登録します。
OAuth 2.0 セットアップの場合:
- [管理>全般構成>アプリケーション リンク] に移動します。
- [ Create link>External application>Incoming] を選択します。
- スコープを 管理 に設定します。
- 次のリダイレクト URL:
https://gcs.office.com/v1.0/admin/oauth/callbackを使用します。
ロールアウト
制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。
[ 作成] を 選択して接続をデプロイします。 Confluence オンプレミス Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | Setting | 既定値 |
|---|---|---|
| ユーザー | アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ユーザー | ID のマッピング | データ ソース ID は、Microsoft Entra ID を使用してマップされます。 |
| コンテンツ | スペースを含める/除外する | すべてのスペースが含まれています。 |
| コンテンツ | プロパティの管理 | 既定のプロパティとスキーマについては、「 プロパティの管理」を参照してください。 |
| 同期 | 増分クロール | 15 分ごと。 |
| 同期 | フル クロール | 毎日です。 |
これらの値をカスタマイズするには、「 設定のカスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ
Confluence オンプレミス コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
Confluence Cloud コネクタでは、次のユーザー検索アクセス許可がサポートされています。
- すべてのユーザー: インデックス付きデータは、すべてのユーザーに表示されます。
- アクセス権を持つユーザーのみ: インデックス付きデータは、Confluence でアクセス権を持つユーザーにのみ表示されます。
Confluence オンプレミスでは、ユーザーとグループのセキュリティアクセス許可は、領域のアクセス許可とページ制限によって定義されます。 アクセス許可の評価は次のように行われます。
- ページ レベルの制限からアクセス許可の構成を取得します。
- 親ページの制限からアクセス許可の構成を取得します。
- 領域のアクセス許可からアクセス許可の構成を取得します。
- 前の 3 つの構成の積集合を計算して、ページの有効なアクセス許可を決定します。 この最終的なアクセス許可セットは、Microsoft 365 Copilotに同期されます。
重要
スペース レベルで定義された匿名アクセス設定は考慮されません。
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択する場合は、Confluence サイトにプロビジョニングされたユーザーとMicrosoft Entra ID以外のユーザー Microsoft Entra IDするかどうかを選択します。
- Microsoft Entra ID: Confluence 電子メール ID が、Microsoft Entra IDのユーザー プリンシパル名 (UPN) と一致する場合は、このオプションを選択します。
- Microsoft Entra ID以外: Confluence メール ID が UPN と一致しない場合は、このオプションを選択します。 正規表現を使用して、電子メール ID を UPN にマップします。
アクセス許可へのUpdatesは、フル クロール中にのみ同期されます。
コンテンツ設定をカスタマイズする
コンテンツ設定は、次の方法でカスタマイズできます。
- スペース フィルター オプションを使用して、特定のスペースを含めるか除外します。 各スペースには、そのスペースの URL の一部を形成するスペース キー識別子があります。 詳細については、「 スペース キー」を参照してください。
- ドキュメントのインデックス作成の日付範囲を指定します。 [最終作成日] または [最終変更日] でページをフィルター処理できます。
- データ ソースのプロパティを追加または削除し、スキーマをプロパティ (検索可能、クエリ可能、取得可能、リファイン可能) に割り当て、プロパティに関連付けられているセマンティック ラベルを変更します。 次の表に、既定のプロパティを示します。
| Source プロパティ | Label | Schema |
|---|---|---|
| 設定元 | authors | クエリ、取得 |
| コンテンツ | 検索 | |
| CreatedByName | 作成者 | 検索、クエリ、取得 |
| CreatedOn | 作成日時 | クエリ、取得 |
| ID | クエリ、取得 | |
| PageTree | 取得 | |
| SpaceName | 検索、クエリ、取得 | |
| タイトル | title | 検索、取得 |
| UpdatedByName | lastModifiedBy | 取得 |
| UpdatedOn | lastModifiedDateTime | クエリ、取得、絞り込み |
| URL | url | 取得 |
同期間隔をカスタマイズする
同期の頻度を調整できます。
- 増分クロール: 新しいコンテンツと変更されたコンテンツを同期します。 増分クロールでは、ACL の変更や削除されたアイテムは取得されません。 既定値は 15 分ごとです。
- フル クロール: すべてのコンテンツの完全な同期を実行します。 フル クロールでは、削除されたアイテムと同期アクセス制御リスト (ACL) の変更が検出されます。 既定値は毎日です。
詳細については、「 同期設定のガイドライン」を参照してください。