Confluence オンプレミス Microsoft Graph コネクタ
Confluence オンプレミスの Microsoft Graph コネクタを使用すると、organizationで Confluence サーバーまたはデータ センターのコンテンツのインデックスを作成できます。 Confluence サイトからコネクタとインデックス データを構成した後、エンド ユーザーは Microsoft Search と Microsoft 365 Copilotでそれらのコンテンツを検索できます。
この記事は、Microsoft 365 管理者を対象としており、Confluence オンプレミスの Microsoft Graph コネクタの構成、実行、監視を担当するユーザーを対象としています。 これは、Microsoft 365 管理センターでの Microsoft Graph コネクタのセットアップに関するページに記載されている一般的な手順を補完します。
利点
-
検索機能の強化: ユーザーは Copilot の Wiki コンテンツに関して、次のような自然言語の質問を行うことができます。
- アーキテクチャ ドキュメントを要約する
- ポータルにアクセスする方法
- アーキテクチャ ドキュメントを要約する
-
セマンティック検索のサポート: ユーザーは、正確な応答のために自然言語クエリを実行できます。
- 互換性: 8.0 を超える Confluence バージョンをサポートします。
前提条件
- GCA [Graph コネクタ エージェント] をインストールする: GCA がデータ ソースと同じネットワーク内の Windows マシンにインストールされていることを確認し、Confluence URL からアクセスできるようにします。 詳細については、Microsoft Graph コネクタ エージェントを参照してください。
- プラグインのインストール: confluence on-prem プラグインを Atlassian Marketplace からダウンロードして、confluence のセットアップにインストールします。 Microsoft Graph Connectors Confluence On-prem プラグインからプラグインを取得する |Atlassian Marketplace
- 認証: 適切なアクセス権を持つ認証資格情報があることを確認します。
はじめに
1. 表示名
表示名は、Copilot の各参照を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。
2. Confluence オンプレミス URL
Confluence オンプレミス データに接続するには、organizationの Confluence インスタンス URL が必要です。 organizationの Confluence インスタンス URL は、通常は 'https://contoso.atlassian.net' のようになります。
3. Graph コネクタ エージェント (GCA)
Confluence サーバーまたはデータ センターのコンテンツのインデックスを作成するには、コネクタ エージェントをインストールして登録する必要があります。 詳細については、「 Microsoft Graph コネクタ エージェントのインストール 」を参照してください。 organizationの Microsoft 365 テナントの管理者と、organizationの Confluence サイトの管理者である必要があります。
注:
GCA は別の Windows マシンにインストールでき、オンプレミス サーバーと同じマシン上にインストールする必要はありません。 マシンは、セットアップに使用できるアプリ ID とシークレットの生成に役立ちます。 クロール中に GCA マシンがオンになっていることを確認する必要があります。 一般的な GCA の実際の質問に対する回答については、「 FAQ」セクションを参照してください 。
4. Confluence オンプレミス プラグインをインストールする
Microsoft Graph コネクタ Confluence On-prem プラグインがインストールされていることを確認します。 各 confluence コネクタのプラグインをインストールする必要はありません。Confluence インスタンスに既にインストールされている場合は、以降の Confluence on-prem 接続に対してこの手順をスキップできます。
- Microsoft Graph Connectors Confluence On-prem プラグインからアプリをダウンロードする |Atlassian Marketplace。
- confluence システムにログインする
- [設定] アイコン -> [アプリの管理] をクリックします。 [設定]
- アップロード アプリをクリックする アップロード アプリ
- ダウンロードしたファイルを選択し、
を続行します)
注:
プラグインは、8.0 より上の confluence バージョンでサポートされています。
5. 認証の種類
Confluence On-prem からコンテンツを認証して同期するには、サポートされている 3 つの方法のいずれかを 選択します。
a. 基本認証
インスタンスに対して認証するには、Confluence アカウントのユーザー名とパスワードを入力します。
b. OAuth1.0a
公開キーと秘密キーのペアを生成し、コネクタ エージェントがインスタンスにアクセスできるように、Confluence オンプレミス サイトにアプリケーション リンクを作成します。 詳細については、OAuth 1.0a を構成する方法に関する Atlassian 開発者向けドキュメントの手順 1 を参照してください。
c. OAuth 2.0 (推奨)
次の手順では、アプリを登録する方法に関するガイダンス を提供します 受信リンクを構成します。
- [管理] > [全般構成] > [アプリケーション] リンクに移動します。
- [作成] リンクを選択します
- [外部アプリケーション] を選択し、方向として [受信] を選択します。
- を入力します。
- リダイレクト URL:
https://gcs.office.com/v1.0/admin/oauth/callback - スコープ: 管理または読み取り
- クライアント ID とシークレットを使用して接続設定手順を完了します。
6. 限定対象ユーザーへのロールアウト
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 制限付きロールアウトの詳細については、 こちらをクリックしてください。
この時点で、ServiceNow Knowledge の接続を作成する準備ができました。 [作成] ボタンをクリックすると、Microsoft Graph コネクタが Confluence アカウントからインデックス作成ページを開始します。
アクセス許可、データ包含ルール、スキーマ、クロール頻度などの他の設定については、Confluence データに最適な内容に基づいて既定値を設定します。 既定値は次のとおりです。
| Users | |
|---|---|
| アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ID のマップ | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| Content | |
|---|---|
| スペースを含める/除外する | All |
| プロパティの管理 | 既定のプロパティとそのスキーマをチェックするには、ここをクリックします |
| 同期 | |
|---|---|
| 増分クロール | 頻度: 15 分ごと |
| フル クロール | 頻度: 毎日 |
これらの値のいずれかを編集する場合は、 Custom Setup オプションを選択する必要があります。
カスタム セットアップ
カスタムセットアップは、既定の表に一覧表示されている設定の既定値を編集する管理者向けです。 [ Custom Setup ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。
ユーザー
アクセス許可
Confluence オンプレミスの Microsoft Graph コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたはユーザーにのみ表示される検索アクセス許可がサポートされています。 [すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースにアクセスできるユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示されます。 Confluence オンプレミスでは、ユーザーとグループのセキュリティアクセス許可は、スペースのアクセス許可とページ制限を使用して定義されます。 Confluence オンプレミスの Microsoft Graph コネクタは、コンテンツ制限 API によって提供される有効なアクセス許可を適用します
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択した場合は、Confluence サイトにプロビジョニングされたユーザーと AAD 以外のユーザー Microsoft Entra IDするかどうかをさらに選択する必要があります。
organizationに適したオプションを特定するには:
- Confluence ユーザーの電子メール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と同じである場合は、Microsoft Entra ID オプションを選択します。
- Confluence ユーザーのメール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と異なる場合は、AAD 以外のオプションを選択します。
重要
- id ソースの種類としてMicrosoft Entra IDを選択した場合、コネクタは Confluence から直接取得したユーザーの電子メール ID を、Microsoft Entra IDから UPN プロパティにマップします。
- ID の種類に "非 AAD" を選択した場合は、ID のマッピング手順については、「 Azure 以外の AD ID を マップする」を参照してください。 このオプションを使用して、メール ID から UPN へのマッピング正規表現を指定できます。
- アクセス許可を管理するユーザーまたはグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、現在、アクセス許可に対する更新プログラムの処理はサポートされていません。
コンテンツ
インデックスを作成するデータを含めるか除外する
この手順では、Confluence データ ソースから使用可能なプロパティを追加または削除できます。 Microsoft 365 では、いくつかのプロパティが選択されます。 既定では、コネクタはすべてのスペースにインデックスを付けます。 ただし、スペース フィルター オプションを使用して、特定のスペースを含めるか除外するかを選択できます。
含めるか除外するスペース キーの一覧を入力すると、結果のプレビューが表示されます。 「スペース キー」と入力します。各 Confluence スペースにはスペース キーがあります。これは、そのスペースの URL の一部を形成する短い一意の識別子です。 スペース キーを取得するには、confluence 管理者に問い合わせてください。詳細については、スペース キーに関するページを参照してください。
ページ フィルター
この手順では、ドキュメントのインデックス作成の日付範囲を指定できます。 パラメーターは次のとおりです。
- 最終作成日: ドキュメントが作成された日付。 この日付以降に変更されたドキュメントのみがインデックス付けされます。
- 最終更新日: ドキュメントが変更された日付。 この日付以降に変更されたドキュメントのみがインデックス付けされます。
重要
- 日付が時系列で表示されていることを確認します。 "最終作成日" は、"最終変更日" より後に指定しないでください。
- 日付が指定されていない場合、すべてのドキュメントがインデックス作成と見なされます。
プロパティの管理
ここでは、Confluence On-prem データ ソースから使用可能なプロパティを追加または削除できます。 プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義します)。 さらに、セマンティック ラベルを変更し、プロパティにエイリアスを追加することもできます。 既定のプロパティは次のとおりです。
| Source プロパティ | Label | Schema |
|---|---|---|
| 設定元 | authors | クエリ、取得 |
| コンテンツ | 検索 | |
| CreatedByName | 作成者 | 検索、クエリ、取得 |
| CreatedOn | 作成日時 | クエリ、取得 |
| Id | クエリ、取得 | |
| PageTree | 取り戻す | |
| SpaceName | 検索、クエリ、取得 | |
| タイトル | title | 検索、取得 |
| UpdatedByName | lastModifiedBy | 取り戻す |
| UpdatedOn | lastModifiedDateTime | クエリ、取得、絞り込み |
| URL | url | 取り戻す |
データのプレビュー
プレビュー結果ボタンを使用して、選択したプロパティとフィルターを確認します。
注:
プレビューでは、スペース レベルのフィルター処理のみが適用されることに注意してください。
同期
更新間隔は、データ ソースと Graph コネクタ インデックスの間でデータを同期する頻度を決定します。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、こちらをクリック してください。 必要に応じて、ここから更新間隔の既定値を変更できます。
接続を確認してテストする
- テストでは、 限定された対象ユーザーに発行を選択できます。
- インデックス付きコンテンツとアクセス許可を検索し、 インデックス ブラウザーを使用して検証します。
- よくある質問に対する回答については、「 FAQ」セクションを参照してください。
MS Search の場合、検索結果ページをカスタマイズする必要がある場合。 検索結果のカスタマイズについては、「検索結果 のカスタマイズ」ページを参照してください。
制限事項
- ブログ、添付ファイル、コメントのインデックスを作成しません。
- 現在のページにのみインデックスを作成します。アーカイブされたページは除外されます。
- CQL[Confluence クエリ言語] はオンプレミスの Confluence ではサポートされていませんが、スペースとページ レベルのフィルターをサポートしています
トラブルシューティング
接続を公開したら、管理センターの [データ ソース] タブの状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。 よく見られる問題のトラブルシューティング手順 については、こちらを参照してください。
問題がある場合、またはフィードバックを提供する場合は、Microsoft Graph にお問い合わせください |サポート。