Microsoft 365 管理センターに Confluence Cloud Copilot コネクタをデプロイする

Confluence Cloud Microsoft 365 Copilot コネクタは、Confluence コンテンツを Microsoft 365 に統合し、Copilot、Copilot Search、Microsoft Search を使用して、Teams、Outlook、SharePoint などのアプリ内で関連する Wiki ページとブログを直接表示できるようにします。

この記事では、Confluence Cloud Copilot コネクタをデプロイ、カスタマイズ、トラブルシューティングする手順について説明します。 Copilot コネクタのデプロイに関する一般的な情報については、Microsoft 365 管理センターでの Copilot コネクタのセットアップに関するページを参照してください。

Confluence Cloud の詳細な構成情報については、「 コネクタ インジェスト用に Confluence Cloud サービスを設定する」を参照してください。

前提条件

Confluence Cloud コネクタをデプロイする前に、Confluence 環境がorganizationで構成されていることを確認します。 次の表は、Confluence 環境を構成し、コネクタをデプロイする手順をまとめたものです。

コネクタをデプロイするには、次の前提条件を満たす必要があります。

• organizationの Microsoft 365 テナントとorganizationの Confluence サイトの管理者である必要があります。
• 適切なアクセス権を持つ認証資格情報が必要です。

コネクタをデプロイする

organizationの Confluence Cloud コネクタを追加するには:

1. Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
2. [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
3. 使用可能なコネクタの一覧から[ Confluence Cloud]\(Confluence Cloud\) を選択します。

表示名を設定する

表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。

既定の Confluence Cloud の表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。

コネクタの表示名と説明の詳細については、「Microsoft 365 Copilot コネクタ コンテンツを使用した Copilot 検出の強化」を参照してください。

インスタンス URL の設定

Confluence サイトに接続するには、サイト URL を使用します。通常は次のようになります: https://<organization_name>.atlassian.net。

<organization_name>値は、Confluence Cloud サイトの一意の識別子です。

認証の種類を選択する

Confluence からコンテンツを認証して同期するには、次のいずれかの認証の種類を選択します。

• 基本認証 - 基本 認証を使用して認証するには、ユーザー名 (通常はメール アドレス) と API トークンを入力します。 API トークンを生成するには、「 Atlassian アカウントの API トークンを管理する」を参照してください。

• OAuth 2.0 (推奨) - Microsoft Search とMicrosoft 365 Copilotがインスタンスにアクセスできるように、Confluence Cloud にアプリを登録します。 詳細については、「 OAuth 2.0 (3LO) の有効化」を参照してください。

  アプリを登録するには:

  1. Atlassian Confluence 管理者アカウントを使用して Atlassian Developer コンソールにサインインします。

  2. [ 作成 ] を選択し、[ OAuth 2.0 integration]\(OAuth 2.0 統合\) を選択します。

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

  4. 左側のウィンドウで [ アクセス許可] を選択し、[ Confluence API] の横にある [追加] を選択 します。

  5. [構成>スコープの編集] を選択し、次の表に示すスコープを選択します。

     スコープ名	コード	説明
     コンテンツの詳細を表示する	read:content-details:confluence	条件を満たすクロール コンテンツ。
     グループの表示	read:group:confluence	コンテンツのグループアクセス許可にアクセスします。
     ユーザーの詳細を表示する	read:user:confluence	個々のユーザーの詳細にアクセスして、アクセス許可をサポートします。
     監査レコードを表示する	read:audit-log:confluence	Confluence イベントの監査レコードにアクセスして、アクセス許可をサポートします。
     ページを表示する	read:page:confluence	アクセス許可をサポートするために、ページ コンテンツの詳細にアクセスします。
     スペースの表示	read:space:confluence	アクセス許可をサポートするために、領域の詳細にアクセスします。
     コンテンツの制限とスペースのアクセス許可を表示する	read:permission:confluence	コンテンツの制限と領域のアクセス許可を表示します。
     コンテンツの概要を表示する	read:content.metadata:confluence	アクセス許可をサポートするコンテンツに関する情報にアクセスします。
     コメントを表示する	read:comment:confluence	ページまたはブログ投稿のコメントを表示します。
     コンテンツ添付ファイルの表示とダウンロード	read:attachment:confluence	アクセスできるページまたはブログ投稿の添付ファイルを表示およびダウンロードします。

  6. 保存] を選択します。

  7. 左側のウィンドウで、[承認] に移動 します。 次のように、Microsoft 365 のコールバック URL を追加します。

     • Microsoft 365 Enterprise -https://gcs.office.com/v1.0/admin/oauth/callback
     • Microsoft 365 Government - https://gcsgcc.office.com/v1.0/admin/oauth/callback 

  8. 保存] を選択します。

  9. 左側のウィンドウで、[ 設定] に移動します。 [クライアント ID] と [シークレット] をコピーします。 [クライアント ID] と [シークレット] を使用して、接続設定の手順を完了します。

ロールアウト

限定されたユーザーセットに接続をデプロイして、Copilot やその他の検索サーフェスで検証してから、より広範な対象ユーザーに展開します。 詳細については、「Microsoft 365 Copilot コネクタの段階的ロールアウト」を参照してください。

制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。

コネクタをデプロイするには、Microsoft 365 管理センターで [作成] を選択します。 Confluence Cloud Copilot コネクタは、Confluence アカウントからページのインデックス作成をすぐに開始します。

次の表に、設定される既定値を示します。 これらの値は Confluence データに最適です。

これらの値をカスタマイズするには、「 設定のカスタマイズ」を参照してください。

接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。

設定のカスタマイズ (省略可能)

Confluence Cloud コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。

ユーザー設定をカスタマイズする

Confluence Cloud コネクタでは、次のユーザー検索アクセス許可がサポートされています。

• すべてのユーザー
• このデータ ソースへのアクセス権を持つユーザーのみ (既定)

[ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 Confluence Cloud では、ユーザーとグループのセキュリティ アクセス許可は、スペースのアクセス許可とページ制限を使用して定義されます。 ページ レベルの制限がある場合は、領域のアクセス許可よりも優先されます。

ページ制限が指定されていない場合、コネクタはスペース レベルのアクセス許可をチェックし、次のことが適用されます。

• スペースで 匿名ユーザー アクセスが有効になっている場合、コンテンツはテナント内のすべてのユーザーに表示されます。
• スペースで 匿名アクセス が有効になっていない場合は、スペース レベルのアクセス許可が適用されます。
• スペース レベルのアクセス許可が定義されていない場合、コンテンツはテナント内のどのユーザーにも表示されません。

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

• confluence ユーザーのメール ID が、Microsoft Entra IDのユーザー プリンシパル名 (UPN) と同じである場合は、Microsoft Entra ID オプションを選択します。
• Confluence ユーザーの電子メール ID が Microsoft Entra ID の UPN と異なる場合は、Entra 以外の ID オプションを選択します。

コンテンツ設定をカスタマイズする

含まれるデータと除外されるデータをカスタマイズし、既定のコネクタ プロパティをカスタマイズできます。

データを含める、または除外する

既定では、Confluence Cloud コネクタはすべてのブログとページにインデックスを付けます。 インデックスを作成するデータを含めたり除外したりできます。 Confluence クエリ言語 (CQL) 文字列を使用して、ページの同期条件を指定できます。 たとえば、過去 2 年間に変更されたページにのみインデックスを付けることができます。 詳細については、「 CQL を使用した高度な検索」を参照してください。

[ プレビュー結果 ] を選択して、選択したプロパティと CQL 文字列のサンプル値を確認します。

プロパティの管理

Confluence Cloud コネクタから使用可能なプロパティを追加または削除するには、プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。 既定では、次のプロパティにインデックスが付けられます。

[ 結果のプレビュー ] ボタンを選択して、選択したプロパティとフィルターを確認します。

同期間隔をカスタマイズする

更新間隔は、データ ソースと Confluence Cloud コネクタ インデックスの間でデータを同期する頻度を決定します。 Copilot コネクタでは、次の 2 種類の更新間隔が使用されます。

• フル クロール - すべてのコンテンツの完全な同期を実行します。 フル クロールでは、削除されたアイテムと同期アクセス制御リスト (ACL) の変更が検出されます。 既定では、フル クロールは 24 時間ごとに実行されます。
• 増分クロール - 新しいコンテンツと変更されたコンテンツを同期します。 増分クロールでは、ACL の変更や削除されたアイテムは取得されません。 既定では、増分クロールは 15 分ごとに実行されます。

更新間隔の既定値を変更できます。 詳細については、「 同期設定のガイドライン」を参照してください。

関連コンテンツ

• Confluence Cloud コネクタの概要
• コネクタ インジェスト用に Confluence クラウド サービスを設定する
• Confluence Cloud コネクタに関する問題のトラブルシューティング
• Microsoft 365 管理センターで Copilot コネクタを設定する
• 接続を監視する