翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Confluence コネクタ V1.0
Confluence は、プロジェクト計画、ソフトウェア開発、製品管理の共有、保存、作業を目的とした共同作業管理ツールです。 Amazon Kendra を使用して、Confluence スペース、ページ (ネストされたページを含む）、ブログ、およびコメントと添付ファイルをインデックス付きページとブログにインデックス付けできます。
**注記**
Confluence Connector V1.0 / ConfluenceConfiguration API は 2023 年に終了しました。Confluence コネクタ V2.0/TemplateConfiguration API に移行するか、こちらを使用することをお勧めします。
Amazon Kendra Confluence データソースコネクタのトラブルシューティングについては、「」を参照してください[データソースのトラブルシューティング](troubleshooting-data-sources.md)。
**Topics**
+ [サポートされている機能](#supported-features-v1-confluence)
+ [前提条件](#prerequisites-v1-confluence)
+ [接続手順](#data-source-procedure-v1-confluence)
+ [詳細情報](#confluence-v1-learn-more)
## サポートされている機能
Amazon Kendra Confluence データソースコネクタは、次の機能をサポートしています。
+ フィールドマッピング
+ ユーザーアクセスコントロール
+ 包含/除外フィルター
+ (Confluence サーバーのみ) 仮想プライベートクラウド (VPC)
## 前提条件
Amazon Kendra を使用して Confluence データソースのインデックスを作成する前に、Confluence と AWS アカウントでこれらの変更を行います。
**Confluence で以下を確認してください。**
+ Confluence インスタンス内のすべてのコンテンツを表示するアクセス Amazon Kendra 許可を付与
+ `confluence-administrators` グループのメンバー Amazon Kendra を作成する。
+ 既存のすべてのスペース、ブログ、ページにサイト管理者アクセス許可を付与する。
+ Confluence インスタンスの URL をコピーしました。
+ **SSO (シングルサインオン) ユーザー向け:** Confluence データセンターで Confluence **認証方法**を設定するときに、ユーザー名とパスワードの **[ログインページに表示]** をアクティブ化しました。
+ **Confluence サーバー用**
+ Amazon Kendraに接続するための Confluence 管理アカウントのユーザー名とパスワードを含む基本認証情報を記録しました。
**注記**
認証情報とシークレットは、定期的に更新またはローテーションすることをお勧めします。セキュリティに必要なアクセスレベルのみを提供してください。認証情報とシークレットを、データソース、コネクタバージョン 1.0 と 2.0 (該当する場合) で再利用することは推奨**しません**。
+ **オプション:** Amazon Kendraに接続するための個人アクセストークンが Confluence アカウントで生成されました。詳細については、「[個人用アクセストークンの生成に関する Confluence ドキュメント](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)」を参照してください。
+ **Confluence クラウド用**
+ Amazon Kendraに接続するための Confluence 管理アカウントのユーザー名とパスワードを含む基本認証情報を記録しました。
+ 各ドキュメントが Confluence および同じインデックスに使用する予定の他のデータソース間で一意であることを確認しました。インデックスに使用する各データソースには、データソース全体に同じドキュメントが含まれていてはなりません。ドキュメント ID はインデックス全体に適用され、インデックスごとに一意である必要があります。
**で AWS アカウント、以下があることを確認します。**
+ [Amazon Kendra インデックスを作成し](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html)、API を使用している場合はインデックス ID を記録しました。
+ データソースの [IAM ロールを作成し](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)、 API を使用している場合はロールの ARN を記録しました IAM 。
**注記**
認証タイプと認証情報を変更する場合は、 IAM ロールを更新して正しい AWS Secrets Manager シークレット ID にアクセスする必要があります。
+ Confluence の認証情報を AWS Secrets Manager シークレットに保存し、API を使用している場合は、シークレットの ARN を記録済み。
**注記**
認証情報とシークレットは、定期的に更新またはローテーションすることをお勧めします。セキュリティに必要なアクセスレベルのみを提供してください。認証情報とシークレットを、データソース、コネクタバージョン 1.0 と 2.0 (該当する場合) で再利用することは推奨**しません**。
既存の IAM ロールまたはシークレットがない場合は、コンソールを使用して Confluence データソースを接続するときに新しい IAM ロールと Secrets Manager シークレットを作成できます Amazon Kendra。API を使用している場合は、既存の IAM ロールと Secrets Manager シークレットの ARN とインデックス ID を指定する必要があります。
## 接続手順
Confluence データソース Amazon Kendra に接続するには、 がデータ Amazon Kendra にアクセスできるように Confluence 認証情報の詳細を指定する必要があります。Confluence をまだ設定していない場合は、 Amazon Kendra 「」を参照してください[前提条件](#prerequisites-v1-confluence)。
------
#### [ Console ]
**Confluence Amazon Kendra に接続するには**
1. AWS マネジメントコンソールにサインインし、[Amazon Kendra コンソール](https://console.aws.amazon.com/kendra/)を開きます。
1. 左側のナビゲーションペインで、**[インデックス]** を選択し、インデックスのリストから使用するインデックスを選択します。
**注記**
**[インデックスの設定]** で、**[ユーザーアクセスコントロール]** 設定を設定または編集できます。
1. **[使用開始]** ページで、**[データソースを追加]** を選択します。
1. **[データソースを追加]** ページで、**[Confluence コネクタ V1.0]** を選択し、**[データソースを追加]** を選択します。
1. **[データソースの詳細を指定]** ページで、次の情報を入力します。
1. **[名前と説明]** の **[データソース名]** に、データソースの名前を入力します。ハイフン (-) は使用できますが、スペースは使用できません。
1. (オプション) **[説明]** - オプションで、データソースの説明を入力します。
1. **[デフォルト言語]** - インデックス用にドキュメントをフィルターするための言語。特に指定しない限り、言語はデフォルトで英語に設定されます。ドキュメントのメタデータで指定された言語は、選択した言語よりも優先されます。
1. **タグ**で、**新しいタグを追加する** - リソースを検索してフィルタリングしたり、 AWS コストを追跡したりするためのオプションのタグを含めます。
1. [**次へ**] を選択します。
1. **[アクセスとセキュリティの定義]** ページで、次の情報を入力します。
1. **[Confluence Cloud]** と **[Confluence Server]** のどちらかを選択します。
1. **[Confluence Cloud]** を選択した場合は、次の情報を入力します。
1. **[Confluence URL]** - ユーザーの Confluence URL。
1. **AWS Secrets Manager secret** — 既存のシークレットを選択するか、Confluence 認証情報を保存する新しい Secrets Manager シークレットを作成します。新しいシークレットの作成を選択すると、[ AWS Secrets Manager シークレット] ウィンドウが開きます。
1. **[ AWS Secrets Manager シークレットウィンドウを作成]** に次の情報を入力します。
1. **[シークレット名]** - シークレットの名前。シークレット名に、プレフィックス「AmazonKendra-Confluence-」が自動的に追加されます。
1. **[ユーザー名]** と **[パスワード]** - Confluence のユーザー名とパスワードを入力します。
1. **[認証を保存]** を選択します。
1. **[Confluence Server]** を選択した場合は、次の情報を入力します。
1. **[Confluence URL]** - お客様の Confluence ユーザー名とパスワード。
1. (オプション) **[ウェブプロキシ]** には次の情報を入力します。
1. **[ホスト名]** - Confluence アカウントのホスト名。
1. **[ポート番号]** - ホスト URL トランスポートプロトコルが使用するポート。
1. **[認証]** には、**[基本認証]** または **[個人用アクセストークン]** (Confluence Server のみ) を選択します。
1. **AWS Secrets Manager secret** — 既存のシークレットを選択するか、Confluence 認証情報を保存する新しい Secrets Manager シークレットを作成します。新しいシークレットの作成を選択すると、[ AWS Secrets Manager シークレット] ウィンドウが開きます。
1. **[ AWS Secrets Manager シークレットウィンドウを作成]** に次の情報を入力します。
1. **[シークレット名]** - シークレットの名前。シークレット名に、プレフィックス「AmazonKendra-Confluence-」が自動的に追加されます。
1. **[ユーザー名]** と **[パスワード]** - Confluence で設定した認証情報値を入力します。基本認証を使用の場合は、Confluence のユーザー名 (E メール ID) とパスワード (API トークン) を使用します。個人用アクセストークンを使用の場合は、Confluence アカウントで設定した **[個人用アクセストークン]** の詳細を入力します。
1. シークレットを保存して追加します。
1. **IAM role** — 既存の IAM ロールを選択するか、リポジトリの認証情報とインデックスコンテンツにアクセスするための新しい IAM ロールを作成します。
**注記**
IAM インデックスに使用される ロールは、データソースには使用できません。インデックスやよくある質問に既存のロールが使用されているかどうかが不明な場合は、エラーを避けるため、**[新しいロールを作成]** を選択してください。
1. [**次へ**] を選択します。
1. **[同期設定の構成]** ページで、次の情報を入力します。
1. **[個人用スペースを含める]** と **[アーカイブされたスペースを含む]** の場合 - このデータソースに含めるオプションのスペースタイプを選択します。
1. **[追加設定]** の場合: 特定のコンテンツを含めるか除外する正規表現パターンを指定します。最大 100 のパターンを追加できます。
1. **選択したスペース内の添付ファイルをクロールする**こともできます。
1. **同期実行スケジュール**で**、頻度** - Amazon Kendra がデータソースと同期する頻度を選択します。
1. [**次へ**] を選択します。
1. **[フィールドマッピングを設定]** ページで、次の情報を入力します。
1. **スペース**、**ページ**、**ブログ** - Amazon Kendra 生成されたデフォルトのデータソースフィールドまたは**追加の推奨フィールドマッピング**から選択して、インデックスフィールドを追加します。
1. **[フィールドを追加]** - カスタムデータソースフィールドを追加して、マッピング先のインデックスフィールド名とフィールドデータタイプを作成します。
1. [**次へ**] を選択します。
1. **[確認と作成]** ページで、入力した情報が正しいことを確認し、**[データソースを追加]** を選択します。このページで情報の編集を選択することもできます。データソースが正常に追加されると、データソースが **[データソース]** ページに表示されます。
------
#### [ API ]
**Confluence Amazon Kendra に接続するには**
[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html) API を使用して以下を指定する必要があります。
+ **Confluence バージョン** - `CLOUD` または `SERVER` として使用している Confluence インスタンスのバージョンを指定します。
+ **Secret Amazon Resource Name (ARN)** — Confluence 認証情報を含む Secrets Manager シークレットの Amazon リソースネーム (ARN) を指定します。
Confluence Server を使用している場合は、Confluence のユーザー名とパスワード、または個人アクセストークンのいずれかを認証情報として使用できます。
Confluence のユーザー名とパスワードを認証情報として使用する場合、以下の認証情報を JSON 構造として Secrets Manager のシークレットに保存します。
```
{
"username": "{{user name}}",
"password": "{{password}}"
}
```
個人用アクセストークンを使用して Confluence Server を に接続する場合 Amazon Kendra、次の認証情報を JSON 構造としてシークレットに Secrets Manager 保存します。
```
{
"patToken": "{{personal access token}}"
}
```
Confluence Cloud を使用する場合は、Confluence で設定された Confluence のユーザー名、および API トークンをパスワードとして使用します。次の認証情報を JSON 構造として Secrets Manager シークレットに保存します。
```
{
"username": "{{user name}}",
"password": "{{API token}}"
}
```
+ **IAM role** — を呼び出し`CreateDataSource`て IAM ロールに Secrets Manager シークレットへのアクセス許可を付与し、Confluence コネクタと に必要なパブリック APIs を呼び出す`RoleArn`タイミングを指定します Amazon Kendra。詳細については、「[IAM roles for Confluence data sources](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)」を参照してください。
オプションで、次の機能を追加することもできます。
+ **ウェブプロキシ** - ウェブプロキシ経由で Confluence URL インスタンスに接続するかどうか。このオプションは Confluence サーバーに使用できます。
+ (Confluence サーバーのみ) **[仮想プライベートクラウド (VPC)]** - データソース設定の一部として `VpcConfiguration` を指定します。[「VPC を使用する Amazon Kendra ように を設定する](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html)」を参照してください。
+ **包含フィルターと除外フィルター** - 特定のスペース、ブログ投稿、ページ、スペース、および添付ファイルを含めるか除外する正規表現パターンを指定します。添付ファイルのインデックスを作成する場合は、インデックスで指定されたページおよびブログへの添付ファイルのみがインデックス作成されます。
**注記**
ほとんどのデータソースは、フィルターと呼ばれる包含または除外パターンである正規表現パターンを使用しています。包含フィルターを指定すると、包含フィルターに一致するコンテンツのみのインデックスが作成されます。包含フィルターに一致しないドキュメントのインデックスは作成されません。包含フィルターと除外フィルターを指定した場合、除外フィルターに一致するドキュメントは、包含フィルターと一致してもインデックスは作成されません。
+ **フィールドマッピング** - 選択すると、Confluence データソースフィールドを Amazon Kendra インデックスフィールドにマッピングします。詳細については、「[データソースフィールドのマッピング](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)」を参照してください。
**注記**
がドキュメント Amazon Kendra を検索するには、ドキュメント本文フィールドまたはドキュメントと同等のドキュメント本文が必要です。データソースのドキュメント本文フィールド名をインデックスフィールド名 `_document_body` にマッピングする必要があります。その他のすべてのフィールドはオプションです。
+ **[ユーザーコンテキストのフィルタリングとアクセスコントロール]** — ドキュメントの ACL がある場合は、Amazon Kendra がドキュメントのアクセスコントロールリスト (ACL) をクロールします。ACL 情報は、ユーザーまたはそのグループのドキュメントへのアクセスに基づいて、検索結果をフィルタリングするために使用されます。詳細については、「[User context filtering](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter)」を参照してください。
------
## 詳細情報
Confluence データソース Amazon Kendra との統合の詳細については、以下を参照してください。
+ [Amazon Kendra Confluence Server コネクタの設定 ](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)